AGENTS.md 管的是「这个项目的规矩」，config.toml 管的是「工具本身怎么运转」。两份文件，两件事，别混。
文件在哪
主配置：~/.codex/config.toml
（准确说是 CODEX_HOME 指向的目录，默认就是 ~/.codex。）
项目级的覆盖：仓库里的 .codex/config.toml，在这个项目被标记为可信之后才生效。
几个最常用的键
# 用哪个模型
model = "gpt-5.6-terra"
# 想多深。可选 low / medium / high / xhigh
model_reasoning_effort = "medium"
# 什么时候停下来问你
approval_policy = "on-request"
# 能碰到什么
sandbox_mode = "workspace-write"
这四个覆盖了绝大部分需求。两组权限键的含义见沙箱和审批，模型怎么挑见 OpenAI 的模型都叫什么。
model_reasoning_effort 值得单独说
它控制的是它在回答前愿意想多久。
- low —— 快、便宜。适合重复的、结果一眼能验的活
- medium —— 默认
- high / xhigh —— 慢、贵。适合难题和「错了代价大」的事
这个键和挑模型是两个旋钮，可以叠加。 用日常档的模型配 xhigh，和用深度档的模型配 low，是两种不同的取舍——前者是「便宜的脑子想久一点」，后者是「贵的脑子扫一眼」。
多套配置：按活儿分档
同一台电脑上，不同的活儿该用不同的设置。Codex 用具名配置解决这个。
注意格式变过： 从 0.134.0 起，配置不再写在 config.toml 里的 [profiles.xxx] 段落中，而是每套一个独立文件：
~/.codex/deep-review.config.toml
里面直接写顶层的键，不套表：
model_reasoning_effort = "xhigh"
approval_policy = "on-request"
用的时候：
codex --profile deep-review
⚠️ 照旧教程写
[profiles.xxx]会静默不生效。 网上大量 2025 年的文章还是老格式，别照抄。
三套值得先备好的
① 只看不动（explorer）
sandbox_mode = "read-only"
进一个不熟的项目先用这套，让它读懂了再说。这是最该常备的一套。
② 认真干活（默认）
不用单独建，默认配置就是。
③ 深挖（deep-review）
model_reasoning_effort = "xhigh"
approval_policy = "on-request"
留给那种「想清楚比快重要」的事。
一条建议
别一上来就配一堆。
先用默认跑两周，等你具体地感到某个默认值妨碍了你，再去改那一个。凭想象配出来的一套设置，通常解决的是不存在的问题，而它带来的意外你要花很久才能定位。
本节事实查证日期：2026-09-10。 依据：OpenAI 官方文档 Advanced configuration。 ⚠️ 配置格式随版本变化（具名配置的写法就改过一次），以官网当前文档为准。