Codex CLI
CLI 讓你在終端機裡完成「讀、改、跑、審查」這條迴圈,不必切到瀏覽器。它也是腳本與 CI 的入口:互動用 codex,非互動用 codex exec。
互動模式
在 Git 專案目錄執行:
描述任務即可。進行中可以看它執行的指令與 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 跑 /review 或 codex review。它可以針對未提交變更、某個 commit 或相對 base branch 給意見,而且不修改工作樹,方便你先看風險再決定怎麼改。
什麼時候用 CLI
- 你本來就在 terminal 工作。
- 要把代理接進現有指令與測試。
- 需要
codex exec做可重複自動化。
若你更想對著檔案與 diff 點選,改用 IDE;若任務要跑很久或同時試幾個方案,改用 Cloud。
推薦影音
官方 Codex CLI 介紹
簡述:OpenAI 示範 CLI 解釋陌生 repo、全自動改功能、用截圖當設計稿。對應本頁互動模式。
指令與恢復工作階段
簡述:Net Ninja 示範斜線指令、權限切換,以及 codex resume 找回舊 session。適合看完官方介紹後跟著做。