CLI 選項與命令

CLI 是 Codex 最適合練基本功的入口。本頁按官方教程的邏輯，把互動模式、非互動模式、會話恢復、Slash Commands 和常用啟動引數整理成中文實操版。

最後核對

官方資料最後核對日期：2026-05-27。本文參考 Codex CLI features、Codex CLI 官方倉庫、CLI getting started、exec 文件 與 slash commands 文件。

三種使用姿勢

模式	適合任務	典型命令
互動模式	學習倉庫、逐步改程式碼、需要隨時打斷	codex
一次性任務	CI、指令碼、批次分析、生成摘要	codex exec "任務說明"
恢復會話	延續之前上下文、繼續未完成任務	codex resume

互動模式

進入專案根目錄後執行：

codex

建議第一句話先限定邊界：

請先閱讀當前倉庫，不要修改檔案。請告訴我：
1. 專案用途
2. 入口檔案
3. 安裝、構建和測試命令
4. 你建議優先補齊的 5 個文件或測試任務

互動模式最適合學習 Codex 的思考過程。你可以在它準備執行命令前停下來，確認命令意圖，也可以把任務拆成多輪推進。

非互動模式：codex exec

codex exec 適合把 Codex 放進指令碼、CI 或重複任務裡。例如：

codex exec "請閱讀 README 和 package.json，輸出本專案的本地啟動命令和測試命令。不要修改檔案。"

適合的場景：

• 批次生成倉庫摘要。
• 在 CI 失敗後自動收集失敗原因。
• 為 release notes 生成初稿。
• 從日誌中提取排障建議。
• 為多個模組生成統一格式的文件草稿。

寫 exec 任務時要更明確，因為它沒有互動追問的空間：

請只讀分析當前倉庫，不要修改檔案。

輸出格式：
1. 專案概覽：不超過 120 字
2. 技術棧：表格
3. 本地啟動：列出命令和前置條件
4. 測試命令：按單元測試、整合測試、型別檢查分類
5. 風險提示：最多 5 條

恢復與繼續

長任務經常需要分段推進。建議在每個階段結束時讓 Codex 輸出：

• 已讀檔案。
• 已改檔案。
• 已執行命令。
• 尚未完成的下一步。
• 當前風險。

下次恢復時，把上一段總結作為第一條訊息，能顯著減少上下文斷裂。

示例：

繼續上一次任務。上一階段已經完成：
- 已定位失敗測試：...
- 已修改檔案：...
- 已執行命令：...

請現在只處理下一步：補充邊界測試，並執行相關測試。

Slash Commands

Slash Commands 用於在 CLI 會話中快速檢視狀態、調整行為或執行常用動作。不同版本命令列表可能會變化，最穩妥的方式是在 CLI 內輸入 / 檢視當前可用命令。

常見使用方式：

命令型別	作用	使用建議
狀態類	檢視模型、審核、工作區狀態	每次重要修改前看一次
上下文類	檢視或壓縮上下文	長任務進入下一階段時使用
Git 類	檢視 diff 或變更摘要	提交前配合人工 review
權限類	檢視審核策略	涉及安裝、網路、刪除前檢查
會話類	退出、恢復、重開	任務結束時留下清晰總結

啟動引數的理解方式

官方 CLI 版本更新較快，引數名和預設值請以 codex --help 與官方文件為準。學習時可以按用途理解：

引數類別	解決的問題	例子
模型選擇	當前任務需要更強推理或更快響應	複雜重構用高推理，文件整理用常規設定
沙盒設定	控制檔案系統、網路、命令權限	只讀分析、工作區寫入、受限網路
審核策略	控制哪些命令需要人工確認	刪除、安裝依賴、外部網路訪問
設定覆蓋	臨時覆蓋 config.toml	對單次任務使用特殊 profile
輸出格式	適配指令碼或自動化	exec 輸出 Markdown、JSON 或固定結構

建議在教程截圖中保留兩張圖：

任務設計模板

只讀分析

請只讀分析當前倉庫，不要修改檔案，不要執行會寫入檔案的命令。

請輸出：
1. 專案結構
2. 關鍵命令
3. 風險點
4. 適合 Codex 處理的低風險任務清單

小修復

請修復 [具體問題]。

範圍：
- 允許修改：[目錄/檔案]
- 避免修改：[目錄/檔案]

要求：
1. 先復現問題。
2. 修改最小必要程式碼。
3. 執行 [驗證命令]。
4. 總結原因、改動、驗證和風險。

自動化摘要

codex exec "請閱讀最近一次測試失敗日誌，提取失敗測試名、關鍵報錯、可能原因和下一步排查建議。不要修改檔案。"

學習重點

• 互動模式適合探索和校準。
• exec 適合標準化輸出和自動化。
• Slash Commands 是觀察 Codex 狀態的視窗。
• 會話恢復前先寫階段總結。
• 引數變化以當前 CLI 幫助和官方文件為準。