Codex 配置：作用域与优先级

中文实战指南 · 核验于 2026-11-14

修改配置前，先确认当前使用的是哪个客户端、哪个项目目录，以及是否存在组织管理的约束。同一份文件不是所有运行端共同读取的配置中心。

配置放在哪里

用户配置通常位于 ~/.codex/config.toml；可信项目可以使用项目内的 .codex/config.toml。项目配置是否被加载与项目是否受信任有关。

常见优先级从高到低是：命令行覆盖、项目配置、选定 profile、用户配置，再到云端及系统默认与内置值。组织 requirements 是允许范围的约束，不能当作普通默认值被较高优先级覆盖。

一次只改一个变量

1. 明确要改变的行为，例如执行命令时何时请求审批。
2. 找到该键的官方定义、当前客户端支持范围和允许值。
3. 修改适用层级，重新启动或创建任务，观察行为。
4. 不符合预期时，检查更高优先级覆盖及组织约束。

示例：在需要保守检查代码的本地任务中，可以从只读配置开始：

sandbox_mode = "read-only"
approval_policy = "on-request"

这是操作范围与审批方式的组合示例，不是所有项目都应使用的默认配置。还需要以运行环境支持为准。

常见误判

把 Web 对话当成本地客户端、在不可信项目中编辑配置、或者忘记启动命令带了覆盖参数，都可能造成“改了没有生效”。不要先删除整个配置文件；先缩小到具体键、来源和客户端。

项目开发约定写在 AGENTS.md；实际权限含义见 审批与沙箱。