實作指南 / 22 分鐘
依模型、effort 與 scope 規劃 Codex 工作
先保留 session continuity,再選 Sol、Terra 或 Luna,而且不改變 permission boundary。
Model-aware planning 不只是選最大模型。先保留已掌握 repository 與對話內容的 CLI,依任務角色選模型,只使用該模型公告支援的 native effort,並把 subagent orchestration 與單一任務深度分開。Codex 設定仍依 scope 解析,而模型存取權會隨 release、account、登入方式、quota 與 rollout 漂移。
已驗證 Terminal Sequence
- ›
/model - ›
/status - $
codex -p deep-review - $
codex -m gpt-5.6-terra -c 'model_reasoning_effort="medium"' -s workspace-write "<GOAL>" - $
codex exec -m gpt-5.6-sol -c 'model_reasoning_effort="high"' -s read-only --ephemeral "<GOAL>" - $
codex exec -m gpt-5.6-luna -c 'model_reasoning_effort="low"' -s read-only --ephemeral "<GOAL>"
工作原則
Continuity first
一般 repository 工作保留目前 Codex session。只有另一套 CLI 的原生 workflow 或獨立 review 有具體收益,而且大於重建 context 的成本時才切換。
先分角色,不做排名
在 Codex CLI 0.147.0 snapshot 中,GPT-5.6 Sol 是深度 frontier 角色、GPT-5.6 Terra 是平衡日常角色、GPT-5.6 Luna 是快速可重複角色。這是 routing role,不是永久 benchmark 排名。
推理不等於權限
切換 model、native effort、max 或 ultra,都不會升級 sandbox、approval policy、writable roots、network 或外部 action 權限;應保留或縮小現有 permission boundary。
Catalog 是 account-scoped snapshot
啟動前使用 /model 與 /status。Availability、alias、default、quota 與 supported effort 會因 release/account 漂移;有日期的 catalog 是 evidence,不是 entitlement。
實地程序
- 01
選模型前先查 live state
在 active account 執行 /model 與 /status。2026-08-10 的 Codex CLI 0.147.0 snapshot 有 gpt-5.6-sol、gpt-5.6-terra、gpt-5.6-luna,但你的 live catalog 才是最終依據。
- 02
把任務配到模型角色
Ambiguous architecture、困難 debugging、security reasoning 或 final synthesis 用 Sol;一般 edit-test-review 用 Terra;明確 extraction、formatting、inventory 等快速重複工作用 Luna。預期收益小於 context-switch cost 時保留目前模型。
- 03
只選支援的 native effort
目前擷取的 Sol/Terra 支援 low、medium、high、xhigh、max、ultra;Luna 支援 low 到 max,不支援 ultra。max = single-task depth;ultra = provider-native subagent orchestration,不是更強的 max 同義詞。使用前驗證 exact model。
- 04
用明確安全邊界啟動
一般修改用 gpt-5.6-terra、model_reasoning_effort="medium" 與 workspace-write;唯讀深度分析用 Sol/high;唯讀機械工作用 Luna/low。TOML value 要加引號。Codex 的 -p/--profile 是 profile selector,絕不是 print、prompt 或 non-interactive;headless 請用 codex exec。
- 05
向 Knowledge MCP 查 dated catalog
在 MCP client 呼叫 worlds_list_cli_models,input 為 {"products":["codex"]}。閱讀 availability、supported_efforts、constraints、capture date 與 source,再和 /model 比對後才執行 selector。
- 06
產生 advisory work plan
只有已授權修改時,才呼叫 worlds_plan_cli_work 並傳入 {"task":"<GOAL>","current_cli":"codex","available_clis":["codex"],"workstreams":[{"id":"implementation","goal":"<GOAL>","execution_intent":"may-edit"}],"strategy":"continuity-first","risk_tolerance":"low","execution_environment":"local-workspace","orchestration_mode":"none","require_independent_review":false}。唯讀工作省略該 intent,系統預設 read-only。Assignments 與 commands 都是待審建議;工具不會啟動 CLI,也不會授予 permissions。
- 07
不虛構存取權的 fallback
指定模型或 effort 不可用時,重新開啟 /model,選 live 支援項目或移除 explicit model override,並保留原有 sandbox/approval。記錄 fallback 並重跑 task-specific verification。
- 08
只持久化耐久設定
Personal defaults 放 user config、shared trusted-repo behavior 放 project config、specialized behavior 放獨立 profile file;一次模型實驗留在 command line。
PASS / FAIL
驗收清單
- 除非記錄了具體收益,否則保留 active session。
- 選定模型存在於此 account 的 /model。
- Native effort 由 exact model 支援。
- max 與 ultra 沒有混為一談。
- Model 選擇沒有擴張 permissions。
- MCP output 已與 live catalog 核對。
- Command 使用 quoted TOML 與預期 sandbox。
- Fallback 與 verification 明確。
WATCH / REJECT
失敗模式
- 把 Sol、Terra、Luna 當成永久 account entitlement。
- 在 Luna 使用 ultra,或在不可獨立拆分的任務使用 orchestration。
- 假設更高 effort 會授予 tools/network/write。
- 把 codex -p 當成 print 或 prompt flag。
- 未檢查 local CLI/effective policy 就複製 MCP command。
- 使用已移除 legacy profiles table。