Codex CLI
在終端中檢查、編 輯和執行程式碼
無需離開終端，即可檢查程式碼、進行更改、執行命令並自動執行可重複的工作。
$ codex
╭──────────────────────────────────────────────────╮ │ >_ OpenAI Codex │ │ │ │ model: gpt-5.6-sol medium /model to change │ │ directory: ~/code │ ╰──────────────────────────────────────────────────╯ To get started, describe a task or try one of these commands: /init - create an AGENTS.md file with instructions for Codex /status - show current session configuration /permissions - choose what Codex is allowed to do /model - choose the model and reasoning effort /review - review changes and find issues
› Refactor the Dashboard component to React Hooks
100% context left · ? for shortcuts
處理本機儲存庫
讓 Codex 檢查檔案、進行編輯，並執行計算機上已安裝的工具。
掌控整個過程
選擇適合任務的模型、推理力度、權限和命令。
與指令碼和 CI 組合使用
以互動方式使用 Codex，或在可重複的工作流程和流水線中呼叫 codex exec。
快速開始
開始使用
安裝 Codex、登入，然後從專案目錄執行你的第一個任務。
-
安裝 Codex
選擇以下任一安裝方式：
使用適用於 macOS 和 Linux 的獨立安裝程式安裝 Codex CLI。
安裝：
curl -fsSL https://chatgpt.com/codex/install.sh | sh更新：
curl -fsSL https://chatgpt.com/codex/install.sh | sh使用適用於 Windows 的獨立安裝程式安裝 Codex CLI。
安裝：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"更新：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"你也可以使用 npm 安裝 Codex CLI。
安裝：
npm install -g @openai/codex更新：
npm install -g @openai/codex你也可以使用 Homebrew 安裝 Codex CLI。
安裝：
brew install --cask codex更新：
brew upgrade --cask codex -
執行 Codex 並登入
開啟一個專案目錄並執行
codex。首次執行 Codex 時，選擇使用 ChatGPT 登入 或其他可用的登入方式。 -
開始第一個任務
描述你想完成的工作。例如，讓 Codex 解釋專案、進行一項針對性更改，或協助除錯問題。
Tell me about this project在任務前後建立 Git 檢查點，以便還原更改。請參閱最佳實踐。
瞭解 Codex CLI 的功能
通過一個專注的終端迴圈完成互動式工作、自動化、審查和委派。
在終端中完成編碼迴圈
在儲存庫中啟動 Codex，以探索陌生程式碼、規劃更改、編輯檔案並執行本機開發工具。在當前輪次中引導 Codex，檢查隨時顯示的命令和差異，並在同一會話中繼續後續工作。
在終端中完成編碼迴圈圍繞 Codex 建置終端工作流程
瞭解可用於恢復會話、新增視覺和 Web 上下文、拆分複雜工作，以及將 Codex 連線到開發工具的 CLI 功能。
傳回已儲存的聊天
重新開啟當前儲存庫中的近期聊天；需要傳回較早的工作時，也可以搜尋所有本機聊天。
將視覺上下文加入提示詞
在第一條提示詞中附上錯誤截圖、架構圖或設計參考，也可以將圖片貼上到互動式編輯器中。
拆分較大型的調查工作
讓 Codex 將針對性工作委派給專門的智能體，然後把它們的發現彙總回主終端會話。
搜尋最新上下文
當任務依賴最新版本、文件或外部行為時，將執行切換為即時 Web 搜尋。搜尋活動會保留在對話記錄中。
將工作移至 Codex 雲端
瀏覽進行中和已完成的聊天，將工作提交到已設定的環境，並從終端把結果應用到本機儲存庫。
使用 MCP 連線外部工具
新增本機或遠端 MCP 伺服器，在需要時進行身份驗證，並在 Codex 使用工具前檢查當前會話可用的工具。
設定每次執行的邊界
選擇 Codex 何時無需詢問即可編輯檔案或執行命令，並在繼續前檢查當前沙箱和可寫根目錄。
讓 Codex 適配你的終端
為 shell 生成自動補全、選擇語法主題，並在 VISUAL 或 EDITOR 設定的編輯器中開啟較長的提示詞。
在以下情況使用 Codex CLI……
- 你通過終端工作
- 在一個專注的迴圈中探索、編輯和執行儲存庫。
- 你需要編寫指令碼或使用 CI
- 在可重複的工作流程中執行非互動式命令。
- 你希望進行本機程式碼審查
- 在提交或建立拉取請求前檢查更改。
- 你希望將工作交給雲端
- 啟動雲端聊天，稍後再傳回終端。