實戰指南 / CODEX CLI 0.147.0
從 prompt 操作到可驗證證據。
八個實作模組把完整指令 inventory 連到真正的 terminal workflow。命令來自共用 release manifest，安全邊界保持明確。
開啟完整指令參考→codex exec = headless
JSONL → schema → evidenceFIELD PROCEDURE / 01
Interactive session 與 root command
先進入正確 repository，選擇 model 或 profile，再確認狀態。Codex 的 -p 是 profile，不是 print 或 non-interactive。
- $
cd your-repository - $
codex --profile deep-review - ›
/status - ›
/permissions
FIELD PROCEDURE / 02
Headless、JSONL 與 schema
Script 與 CI 使用 codex exec。--json 在 stdout 輸出 JSONL events，--output-schema 約束最終結果，--output-last-message 另存最後文字。
- $
codex exec "Run the affected tests" - $
codex exec --json --output-schema schema.json --output-last-message final.txt "Audit the change"
FIELD PROCEDURE / 03
Config layers、profiles 與 overrides
持久設定放 config.toml，--profile 選擇 $CODEX_HOME/NAME.config.toml，-c key=value 只用於單次執行；requirements 會限制可覆寫範圍。
- $
codex --profile deep-review - $
codex -c model_reasoning_effort=high - $
codex --strict-config
FIELD PROCEDURE / 04
Approvals、sandbox 與 permissions
給予自主權前先選 filesystem 與 approval 邊界。workspace-write 搭配 on-request 是實用起點；bypass 只適用於外部已隔離環境。
- $
codex --sandbox workspace-write --ask-for-approval on-request - $
codex sandbox --permission-profile NAME -- command - ›
/permissions
FIELD PROCEDURE / 05
Resume、fork、archive 與 delete
Resume 延續 transcript、fork 建立分支、archive 可還原、delete 永久刪除。Automation 優先使用精確 session ID。
- $
codex resume --last - $
codex fork --last - $
codex archive SESSION_ID - $
codex unarchive SESSION_ID - $
codex delete SESSION_ID
FIELD PROCEDURE / 06
MCP servers 與 authentication
stdio server 放在 -- 後，HTTP server 用 --url。Bearer token value 留在環境變數；只有支援 OAuth 的 server 才使用 mcp login。
- $
codex mcp add docs --url https://developers.openai.com/mcp - $
codex mcp add local -- node server.mjs - $
codex mcp get docs --json - $
codex mcp login docs --scopes tools.read
FIELD PROCEDURE / 07
Plugins、skills 與 hooks
Marketplace 提供 plugin catalog；plugin 可加入 tools、MCP servers、skills 與 hooks。啟用前先檢查來源與 trust state。
- $
codex plugin marketplace list - $
codex plugin list --available --json - $
codex plugin add PLUGIN@MARKETPLACE - ›
/plugins - ›
/skills - ›
/hooks
FIELD PROCEDURE / 08
Review、diagnostics 與 evidence
最後執行受影響 tests、閱讀 diff、做 focused review；安裝、auth、config、Git 或 runtime 不明時使用 doctor。
- ›
/diff - ›
/review - $
codex review --uncommitted - $
codex doctor --summary - $
git status --short
SHARED MANIFEST / SUPPORTED WORKFLOWS
The guide resolves back to the inventory.
範例以已安裝 Codex CLI 0.147.0 為準。Hidden execpolicy 只列入 inventory，不屬於這些受支援 workflow。
codexruntime-confirmedcodex execruntime-confirmedcodex sandboxruntime-confirmedcodex resumeruntime-confirmedcodex archiveruntime-confirmedcodex deleteruntime-confirmedcodex forkruntime-confirmedcodex mcp getruntime-confirmedcodex mcp addruntime-confirmedcodex mcp loginruntime-confirmedcodex plugin listruntime-confirmedcodex plugin marketplaceruntime-confirmed
NEXT / SEARCH EVERY SURFACE