codex

Codex 技能指南

執行任務

1. 預設使用 gpt-5.2 模型。透過 AskUserQuestion 詢問使用者要使用的推理強度（xhigh、high、medium 或 low）。使用者可依需求覆寫模型（請見下方模型選項）。
2. 根據任務需求選擇沙箱模式；除非需要編輯或網路存取，否則預設使用 --sandbox read-only。
3. 使用適當的選項組合指令：
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<high|medium|low>"
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
4. 一律使用 --skip-git-repo-check。
5. 若要繼續先前的 session，請透過 stdin 使用 codex exec --skip-git-repo-check resume --last。繼續時不要使用任何設定旗標，除非使用者明確要求（例如指定模型或推理強度）。繼續語法：echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null。所有旗標必須插入在 exec 與 resume 之間。
6. 重要：預設情況下，在所有 codex exec 指令後加上 2>/dev/null 以隱藏思考 token（stderr）。僅在使用者明確要求檢視思考 token 或需要除錯時才顯示 stderr。
7. 執行指令，擷取 stdout/stderr（視情況過濾），並向使用者摘要結果。
8. Codex 完成後，告知使用者：「您可以隨時說『codex resume』或要求我繼續進行額外分析或變更，來恢復此 Codex session。」

快速參考

使用情境	沙箱模式	關鍵旗標
唯讀審查或分析	read-only	--sandbox read-only 2>/dev/null
套用本地編輯	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
允許網路或廣泛存取	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
繼續最近的 session	繼承自原始 session	echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null（不允許任何旗標）
從其他目錄執行	符合任務需求	-C <DIR> 加上其他旗標 2>/dev/null

模型選項

模型	最佳用途	上下文視窗	主要特色
gpt-5.2-max	最大模型：超複雜推理、深度問題分析	400K 輸入 / 128K 輸出	76.3% SWE-bench、適應性推理、$1.25/$10.00
gpt-5.2 ⭐	旗艦模型：軟體工程、代理式編碼工作流程	400K 輸入 / 128K 輸出	76.3% SWE-bench、適應性推理、$1.25/$10.00
gpt-5.2-mini	成本效益編碼（使用配額多 4 倍）	400K 輸入 / 128K 輸出	接近 SOTA 效能、$0.25/$2.00
gpt-5.1-thinking	超複雜推理、深度問題分析	400K 輸入 / 128K 輸出	適應性思考深度，最難任務執行速度慢 2 倍

GPT-5.2 優勢：SWE-bench 76.3%（GPT-5 為 72.8%），一般任務快 30%，更好的工具處理能力，減少幻覺，提升程式碼品質。知識截止日期：2024 年 9 月 30 日。

推理強度等級：

• xhigh - 超複雜任務（深度問題分析、複雜推理、深入理解問題）
• high - 複雜任務（重構、架構、安全性分析、效能最佳化）
• medium - 標準任務（重構、程式碼組織、功能新增、錯誤修正）
• low - 簡單任務（快速修正、簡單變更、程式碼格式化、文件）

快取輸入折扣：重複上下文享 90% 折扣（$0.125/M tokens），快取最長保留 24 小時。

後續追蹤

• 每次執行 codex 指令後，立即使用 AskUserQuestion 確認下一步、收集釐清事項，或決定是否使用 codex exec resume --last 繼續。
• 繼續時，透過 stdin 傳入新提示：echo "new prompt" | codex exec resume --last 2>/dev/null。繼續的 session 會自動使用與原始 session 相同的模型、推理強度和沙箱模式。
• 在提議後續動作時，重新說明所選的模型、推理強度和沙箱模式。

錯誤處理

• 當 codex --version 或 codex exec 指令回傳非零結束碼時，停止並回報失敗；在要求指示後再重試。
• 在使用高影響力旗標（--full-auto、--sandbox danger-full-access、--skip-git-repo-check）之前，使用 AskUserQuestion 詢問使用者許可，除非已獲得許可。
• 當輸出包含警告或部分結果時，摘要說明並使用 AskUserQuestion 詢問如何調整。

CLI 版本

需要 Codex CLI v0.57.0 或更新版本以支援 GPT-5.2 模型。CLI 在 macOS/Linux 上預設使用 gpt-5.2，在 Windows 上預設使用 gpt-5.2。檢查版本：codex --version

在 Codex session 中使用 /model 斜線指令切換模型，或在 ~/.codex/config.toml 中設定預設值。