Codex
設定檔
- (無設定檔) — 唯讀分析（不進行編譯或測試）
--profile edit— 本機編輯、建置或測試（workspace-write，全自動）--profile full— 網路或廣泛檔案系統存取（danger-full-access，全自動）
當任務涉及 go test、go build 或任何會寫入建置產品的指令時，請使用 --profile edit。預設的唯讀沙箱會封鎖所有寫入操作，包括編譯器的暫存目錄。
對於複雜任務，請加入 --config model_reasoning_effort="xhigh"。
模型選擇
預設使用 .codex/config.toml 中的專案模型（gpt-5.4）。
對於速度優先的互動工作，請使用 --model gpt-5.3-codex-spark：
- 緊湊的反覆迭代
- 快速修正錯誤與有針對性的編輯
- 中小型重構或 UI 調整
- 預期需要頻繁重新導向或中斷的快速原型開發
對於深度優先的工作，請保留預設的 gpt-5.4：
- 長時間自動執行
- 涉及大量推理的廣泛多檔案變更
- 測試密集或驗證密集的任務
- 較高正確性或風險的場景，需要更深入的推理來彌補額外的延遲
如果使用者明確要求特定模型，則遵循使用者要求。
指令
專案預設值位於 .codex/config.toml。務必包含 --skip-git-repo-check 與 2>/dev/null。僅在使用者明確要求，或任務明顯符合上述 Spark 速度優先條件時，才覆寫模型。
| 使用案例 | 指令 |
|---|---|
| 唯讀分析 | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| 速度優先的互動迴圈 (Spark) | 加上 --model gpt-5.3-codex-spark |
| 套用本機編輯 | 加上 --profile edit |
| 網路 / 廣泛存取 | 加上 --profile full |
| 恢復工作階段 | `echo "prompt" |
執行前先建立輸出用的暫存檔：CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX)。完成後從 $CODEX_OUT 讀取結果。
使用 Bash 執行，設定 run_in_background: true。透過 TaskOutput 監控，設定 block: true, timeout: 600000 — 請勿使用 sleep 指令輪詢。讀取 -o 檔案以取得最終答案。
恢復工作階段
恢復時不要傳遞 model/effort/sandbox 旗標 — 原始工作階段的設定會保留。可以安全地包含 -o。
慣例
這是一個 Go 專案。在提示中使用 go test、go build、go vet。Codex 工作程序不會讀取 CLAUDE.md 或 hooks，因此專案慣例必須明確說明。
執行後驗證
務必使用 git diff --stat 驗證 Codex 的輸出 — 切勿相信工作程序自行回報的檔案清單。Codex 工作程序可能做出超出範圍的變更（刪除檔案、還原不相關的程式碼、移除測試函式）。完成時的承諾可能只列出預期的檔案，但省略破壞性的副作用。
當同一個程式碼庫中存在其他工作時，請在提示中明確包含「請勿修改或刪除」的檔案清單。僅正面指示（「只碰觸這些檔案」）是不夠的 — Codex 會廣義地解讀「清理」一詞。
參照 [[principles/prove-it-works]]：相信產出物，而非自我報告。
工作目錄用法
使用 -C <worktree-dir> 時，工作目錄擁有自己的 git index。.claude/ 可能連結到 .agents/ — 請對 git 操作使用 .agents/ 路徑。