Skip to content

建立 2026-09-15 更新 2026-09-15

Codex CLI

CLI 讓你在終端機裡完成「讀、改、跑、審查」這條迴圈,不必切到瀏覽器。它也是腳本與 CI 的入口:互動用 codex,非互動用 codex exec

安裝見 安裝與登入。官方說明:Codex CLI

互動模式

在 Git 專案目錄執行:

codex

描述任務即可。進行中可以看它執行的指令與 diff,必要時打斷、改提示再繼續。同一個工作階段適合做同一件功能;換題目時寧可開新 session,之後用 codex resume 找回舊的。

常用能力:

  • codex resume:回到這個 repo 最近的對話。
  • codex --image 或在輸入框貼圖:把錯誤截圖、線框、設計稿當上下文。
  • codex --search:需要最新文件或外部行為時改走即時搜尋。
  • codex cloud:從終端機瀏覽、送出雲端任務,再把結果套回本機。
  • codex mcp:查看與管理 MCP 伺服器。

權限用 /permissions 調。日常互動常見組合是 --sandbox workspace-write --ask-for-approval on-request:可在工作區寫檔與跑指令,越界時再問你。

非互動:codex exec

把 Codex 接進腳本或 CI 時用 codex exec,給它一句明確任務,跑完就結束。適合重複工作(產生變更、跑審查),不要在不受信任的公開環境暴露執行權。

CI 通常用 API key 登入,不要把 ChatGPT session 檔提交進 repo。細節見 Authentication

本機審查

提交或開 PR 之前,在 CLI 跑 /reviewcodex review。它可以針對未提交變更、某個 commit 或相對 base branch 給意見,而且不修改工作樹,方便你先看風險再決定怎麼改。

什麼時候用 CLI

  • 你本來就在 terminal 工作。
  • 要把代理接進現有指令與測試。
  • 需要 codex exec 做可重複自動化。

若你更想對著檔案與 diff 點選,改用 IDE;若任務要跑很久或同時試幾個方案,改用 Cloud

推薦影音

官方 Codex CLI 介紹

簡述:OpenAI 示範 CLI 解釋陌生 repo、全自動改功能、用截圖當設計稿。對應本頁互動模式。

指令與恢復工作階段

簡述:Net Ninja 示範斜線指令、權限切換,以及 codex resume 找回舊 session。適合看完官方介紹後跟著做。