For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

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 what model and reasoning effort to use
  /review - review any 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 CLI

安裝 Codex、登入,並從專案目錄執行第一項任務。

  1. 安裝 Codex

    使用適用於 macOS 和 Linux 的獨立安裝程式來安裝 Codex CLI。

    安裝 Codex

    curl -fsSL https://chatgpt.com/codex/install.sh | sh

    更新 Codex

    curl -fsSL https://chatgpt.com/codex/install.sh | sh
  2. 執行 Codex 並登入

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

    查看身分驗證選項
  3. 開始第一項任務

    說明你想完成什麼。例如,請 Codex 解說專案、進行一項範圍明確的變更,或協助偵錯問題。

    請向我介紹這個專案

    在任務前後建立 Git 檢查點,以便還原變更。請參閱 最佳實務.

瞭解 Codex CLI 能做什麼

在同一套專注的終端工作循環中,完成互動式工作、自動化、審查與委派。

01

讓整個程式碼編寫循環都在終端中完成

在程式碼庫中啟動 Codex,探索不熟悉的程式碼、規劃變更、編輯檔案,並執行本機開發工具。引導目前的回合,在指令與差異出現時逐一檢查,並將後續工作留在同一工作階段中。

深入瞭解
02

使用技能與外掛程式

將可重複使用的指示封裝為技能,再加入外掛程式;如此一來,無須離開 CLI,即可讓 Codex 連接團隊的工具與資料。

深入瞭解
03

在變更發布前進行審查

針對未提交的變更、某次提交或基底分支執行專門審查。Codex 會按優先順序回報發現的問題,且不會修改工作樹,讓你能在提交或開啟 Pull Request 前處理風險。

深入瞭解

瞭解如何運用 CLI 功能,繼續先前的工作階段、加入視覺或網頁上下文、拆分複雜工作,以及將 Codex 連接至開發工具。

Use Codex CLI when…

你在終端中工作

在一套專注的工作循環中,探索及編輯程式碼庫並執行其中的程式碼。

你需要使用指令碼或 CI

在可重複執行的工作流程中執行非互動式指令。

你想進行本機程式碼審查

在提交或開啟 Pull Request 前檢查變更。

你想將工作交給雲端處理

啟動雲端對話,稍後再返回終端。