結論先講：OpenAI Codex CLI 是 OpenAI 官方的終端機 AI 編程代理，一行 npm install -g @openai/codex 就能裝好，登入可用 ChatGPT 帳號（需 Plus 以上）或 API key 兩種。在三大 AI Coding CLI 之中，它預設的沙箱與核准機制最保守，適合想讓 AI 動手改檔、又不想它亂跑指令的人。這篇是本站「三大 AI Coding CLI」系列第三篇，補上 Claude Code、Google Antigravity CLI 之後的最後一角。
Codex CLI 是什麼？和聊天型 AI 差在哪
Codex CLI 是跑在你電腦本機的 coding agent（編程代理）。它不只是回答問題，而是能直接讀取你的專案、修改檔案、執行測試、看錯誤再修，形成「規劃、動手、驗證」的循環。它和 ChatGPT 網頁版、Codex 雲端版（chatgpt.com/codex）是不同的東西：CLI 版在你本機執行，雲端版把任務丟到遠端沙箱跑。
它開源（Apache-2.0，程式碼在 github.com/openai/codex），npm 上的週下載量已達數百萬等級，是目前最主流的終端機編程工具之一。
安裝：三種官方做法，挑一種就好
官方支援多種安裝方式，挑你環境順手的那個：
| 方式 | 指令 | 適合誰 |
|---|---|---|
| npm（跨平台） | npm install -g @openai/codex |
已有 Node.js 環境，最通用 |
| Homebrew（macOS／Linux） | brew install --cask codex |
macOS 使用者 |
| 官方安裝腳本 | curl -fsSL https://chatgpt.com/codex/install.sh | sh |
不想另外裝 Node.js 的人 |
| GitHub Releases | 下載對應平台二進位檔 | 離線環境、想鎖定版本 |
Windows 使用者用 PowerShell 一行即可：
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"裝完後在終端機輸入 codex，看到介面就代表成功；確認版本用 codex --version。之後要更新，官方安裝腳本或 codex update 都可以。
提醒：npm 套件名稱是 @openai/codex（有 scope 前綴），別跟名稱相近的其他套件搞混。
登入：ChatGPT 帳號 vs API key，兩種計費邏輯
第一次執行 codex 會跳出登入選單。官方建議直接登入 ChatGPT 帳號，用你現有的訂閱額度；沒有訂閱或想細控成本的人再用 API key。
| ChatGPT 帳號登入 | API key 登入 | |
|---|---|---|
| 指令 | codex login（選 Sign in with ChatGPT） |
printenv OPENAI_API_KEY | codex login --with-api-key |
| 需要訂閱 | Plus／Pro／Business／Edu／Enterprise | 不需要 ChatGPT 訂閱 |
| 計費方式 | 算在訂閱額度內 | 依 token 用多少付多少（API 價） |
| 雲端功能 | 有 | 沒有（雲端 code review 等需 ChatGPT 登入） |
查看目前用哪種身分，執行 codex login status。沒有瀏覽器的伺服器（例如純 SSH 主機）改用裝置碼登入：codex login --device-auth。
憑證預設存在 ~/.codex/auth.json，也可設定存進系統金鑰庫。要切換帳號或改用 API key，執行對應的 login 指令覆蓋即可。安全提醒：API key 請當密碼保管，不要寫進會被 commit 的檔案，也不要貼進任何對話。
第一次跑：從提問到讓它動手
- 在專案根目錄開啟終端機，輸入
codex進入互動模式。 - 先用唯讀問句試水溫：
codex "解釋這個專案的架構"。 - 確認它看得懂之後，再下要動手的指令：
codex "把 Dashboard 元件改寫成 React Hooks"。 - 它會先給你計畫與 diff，你核准後才實際寫入檔案。
想一次跑完、不進互動模式，用 codex exec：
codex exec --sandbox read-only "幫我 review 這個分支的 diff"自主程度與安全：預設最保守
Codex CLI 把「能不能寫檔」和「要不要先問你」拆成兩個獨立選項，預設是作業系統沙箱、關閉網路、每個動作都先問你。想放寬自主程度有三段：
| 模式 | 行為 | 風險 |
|---|---|---|
| 預設（唯讀／on-request） | 唯讀，要動手前先問 | 最低 |
--full-auto |
可在工作區寫檔，少問 | 中 |
--yolo |
不沙箱、不核准，全自動 | 高，僅限可信任務 |
在專案根目錄放一個 AGENTS.md，就能告訴 Codex 這個專案的規則（用什麼語言、測試怎麼跑、哪些目錄別碰），等於給它一份專案說明書。更細的設定寫在 ~/.codex/config.toml。
用量、額度與成本（2026）
Codex 沒有獨立訂閱，它是綁在 ChatGPT 方案裡的。額度以「每 5 小時的滾動窗口」計算，再疊加每週上限；用完後可等待重置、購買 credits，或改用 API key 接著跑。
| 方案 | 月費（USD） | Codex 額度概況 |
|---|---|---|
| Free | $0 | 只能做簡單任務 |
| Go | 約 $8 | 輕量編程任務 |
| Plus | $20 | 完整功能，個人日常主力 |
| Pro | $100（5x）／$200（20x） | 重度使用者、多平行 session |
| Business | 約 $20 至 $25／人 | 團隊共用工作區與額度 |
| Enterprise／Edu | 洽業務 | 無固定速率限制，走 credits |
在 CLI 內查目前用量，用 /status。價格與額度會隨時間調整，請以 OpenAI 官網即時價為準。
常見問題 FAQ
Codex CLI 免費嗎？
CLI 軟體本身免費且開源，但要用它得靠 ChatGPT 方案或 API key 提供模型算力。Free 方案能跑，但只夠簡單任務；日常使用建議 Plus（$20）。
不訂閱 ChatGPT 可以用嗎？
可以。改用 API key 登入（codex login --with-api-key），依 token 用量付費，不需要 ChatGPT 訂閱。缺點是沒有雲端功能，成本要自己盯。
它和 Claude Code、Antigravity CLI 哪個好？
三者能力接近，差別在訂閱、模型與使用風格。想一次看完三者的價格、額度與適用場景，請看本站的三大 AI Coding CLI 比較（連結見下方）。
Windows 能用嗎？
可以。官方提供 PowerShell 安裝腳本，也支援在 WSL 內用 npm 或 Homebrew 安裝。
系列延伸閱讀
本篇是「三大 AI Coding CLI」系列第三篇，建議三篇連著看：