18 · config.toml 配置详解

config.toml 的文件位置、优先级、模型、推理、沙箱、审批、MCP 和界面等常用字段，以及可复制的配置思路。

config.toml 是 Codex 的「总开关面板」。你之前散落在各处的选择——用哪个模型、开多大权限、接什么外部工具——都可以集中写在这里。

「文件位置」先搞清楚：这个配置文件放在哪、叫什么名，Codex 才能找到它。不同的安装方式，默认位置可能不同，先确认你的配置文件在哪。

「优先级」意味着当多个配置来源冲突时，听谁的。通常「更贴近项目」的配置会覆盖「全局」的配置，所以你可以全局设一个默认，再在某个项目里单独覆盖。

「模型」字段控制默认用哪个模型、推理强度调多高。这是影响效果和成本最直接的一处。

「沙箱」和「审批」字段，把你之前理解的权限策略，落成可写的配置项。你可以在这里定义默认的沙箱级别、哪些操作要审批。

「MCP」字段很重要：这里可以声明你要连接哪些外部工具服务器。后面有一篇专门讲 MCP，这里先知道它是通过 config 来挂载的。

「界面」字段管一些显示和交互的偏好，属于锦上添花。

给你的「配置思路」是：先写一个全局的、偏保守的默认配置，再针对个别项目做局部覆盖。不要一上来就写一大坨，先最小可用，再逐步加。

写配置时最怕的是「复制别人的配置却不懂每行的意思」。所以建议你每加一行，都搞清楚它在干什么，否则出了问题都不知道从哪查起。

动手试一下：比起看十遍，不如立刻打开 Codex 跑一个小任务验证你理解的概念。比如这一篇讲的概念，你可以找一个一分钟能完成的小需求，让它跑一遍，看实际行为是不是和你理解的一致。

动手试一下：你可以花 5 分钟做一个最小验证——找一个真实的代码任务，让 Codex 跑一遍，看它的行为是不是和这一篇描述的一致。理论与实践对照，才知道「懂」和「会用」是两件事。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

判断决策树：用三个问题判断该不该用——① 这件事值不值得用 Codex 做？② 用的话该用哪个入口？③ 风险高不高需不需要审批？三个问题的答案一出来，怎么做就清楚了。