實作指南 / 16 分鐘
依 scope 配置 Codex，不靠偶然
混合 user defaults、project policy、profiles 與 one-off override 前先懂 precedence。
Codex 依序解析 CLI override、trusted project layers、selected profile、user config、system config、built-in defaults。Profile 是獨立檔案；current model availability 應即時檢查，不凍結成 evergreen advice。
CLI
已驗證 Terminal Sequence
- $
codex --profile deep-review - $
codex -c 'model_reasoning_effort="high"' - ›
/model - ›
/fast - ›
/status
A
工作原則
最小 durable scope
Personal default 放 user；shared repo behavior 放 project；一次實驗放 command line。
Trust gate project config
Untrusted repo 不會啟動 project-local config/hooks/rules。
Catalog 會動
用 /model、/status 看當前選項；model-specific example 要標日期。
B
實地程序
- 01
檢查 active layers
改檔前先用 /status/config diagnostics。
- 02
設定 restrained user default
只放 approval/sandbox 等耐久 default。
- 03
加入 trusted project settings
使用 .codex/config.toml，避免 project 不能控制的 provider/credential keys。
- 04
建立 profile file
專門 review 行為放 ~/.codex/deep-review.config.toml，以 --profile 選取。
- 05
測試 one-off change
用 dedicated flag 或 TOML -c，再驗證 effective value。
PASS / FAIL
驗收清單
- 理解 effective precedence。
- Project config 無 ignored provider keys。
- Profile 使用獨立 file。
- Model guidance 指向 live catalog。
WATCH / REJECT
失敗模式
- 使用已移除 legacy profiles table。
- 複製完整 sample config。
- 把 volatile model 當永久 default。