繁體中文

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

01

直接處理本機儲存庫

讓 Codex 檢查檔案、進行編輯,並執行電腦上已有的工具。

02

保持控制

選擇適合任務的模型、推理強度、權限和命令。

03

組合指令碼與 CI

互動式使用 Codex,或在可重複的工作流程和流水線中呼叫 codex exec 。

入門

安裝 Codex、登入,然後從專案目錄執行第一個任務。

  1. 安裝 Codex

    選擇以下安裝方法之一: 使用適用於 macOS 和 Linux 的獨立安裝程式安裝 Codex CLI。 安裝: 更新: 使用適用於 Windows 的獨立安裝程式安裝 Codex CLI。 安裝: 更新: 也可以使用 npm 安裝 Codex CLI。 安裝: 更新: 也可以使用 Homebrew 安裝 Codex CLI。 安裝: 更新:

    安裝 Codex
  2. 執行 Codex 並登入

    開啟專案目錄並執行 codex 。首次執行 Codex 時,選擇 Sign in with ChatGPT(使用 ChatGPT 登入)或其他可用登入方式。

    檢視身份驗證選項
  3. 開始第一個任務

    說明想要完成的目標。例如,讓 Codex 解釋專案、進行一項聚焦修改,或協助除錯問題。 在任務前後建立 Git 檢查點,以便回退變更。請參閱 最佳實踐 。

    最佳實踐

看看 Codex CLI 能做什麼

在一個緊湊的終端迴圈中完成互動式工作、自動化、審查和委派。

01

讓編碼迴圈留在終端中

從儲存庫中啟動 Codex,探索陌生程式碼、規劃變更、編輯檔案並執行本機開發工具。引導當前 turn ,檢查出現的命令和 diff,再在同一會話中繼續跟進。

讓編碼迴圈留在終端中
02

使用技能和外掛

把可複用指令封裝為技能,再通過外掛連線團隊工具和資料,全程無需離開 CLI。

使用技能和外掛
03

釋出前審查變更

針對未提交變更、commit 或基準分支執行獨立審查。Codex 不會修改工作樹,只會報告按優先順序排序的發現,方便你在提交或開啟 pull request 前處理風險。

釋出前審查變更

圍繞 Codex 建置終端工作流程

使用 CLI 功能恢復聊天、新增視覺和 Web 上下文、拆分複雜工作,並把 Codex 連線到開發工具。

01 codex resume

返回已儲存的聊天

重新開啟當前儲存庫最近的聊天;需要返回更早的工作時,也可以搜尋本機聊天。

03 subagents

拆分較大的調查任務

讓 Codex 把聚焦工作委派給專門的子智能體,再把調查結果彙總回主終端會話。

04 codex --search

搜尋最新上下文

當任務依賴當前版本、文件或外部行為時,把本次執行切換到即時 Web 搜尋。搜尋活動會保留在記錄中。

05 codex cloud

把工作移到 Codex 雲端

瀏覽進行中和已完成的聊天,把工作提交到已設定環境,再從終端把結果應用到本機儲存庫。

07 /permissions

設定每次執行的邊界

選擇 Codex 何時可以直接編輯檔案或執行命令,並在繼續前檢查當前沙箱和可寫根目錄。

08 codex completion

讓 Codex 適配你的終端

為 shell 生成補全、選擇語法主題,並在 VISUAL 或 EDITOR 指定的編輯器中開啟較長提示詞。

適合使用 Codex CLI 的場景

習慣在終端工作
在一個集中迴圈中探索、編輯和執行儲存庫。
需要指令碼或 CI
在可重複工作流程中執行非互動式命令。
需要本機程式碼審查
在提交或開啟 pull request 前檢查變更。
希望把工作交給雲端
啟動雲端聊天,稍後再回到終端。

其他 ChatGPT 與 Codex 使用介面