配置文件结构与常用项

Codex CLI 的行为很大程度上由配置文件控制。理解它的分层结构和常用项，能让你不必每次都在命令行重复指定参数，也能让团队在同一项目里保持一致的代理行为。本节不追求罗列全部字段，而是把最常用、最影响日常体验的几项讲清楚，并告诉你去哪里查完整字段清单。

一、配置文件的分层位置

Codex 会按优先级读取多处配置，高优先级覆盖低优先级：

• 项目级配置：仓库根目录下的配置文件，随 Git 提交，团队共享。
• 用户级配置：当前用户主目录下的全局配置，对该用户所有项目生效。
• 命令行参数：单次执行时临时覆盖，优先级最高。

推荐做法是：项目相关的约定（如审批模式、要使用的模型）放进项目级配置并提交，个人偏好（如界面主题）留在用户级配置。这样团队成员 clone 下来即可得到一致的代理行为，又不会污染他人本地习惯。

二、最常用的几个配置项

配置项	作用	建议关注点
模型选择	指定本次会话使用哪个模型	复杂任务用强模型，简单文本整理可换轻量模型省成本
审批/权限模式	控制 Codex 何时需要你确认才能执行命令	默认保守模式最安全，熟悉后再按场景放宽
沙箱/网络访问	限制命令是否允许联网、是否允许写目录	不可信任务默认关网络、限写目录
工作目录	约束 Codex 可读写的根范围	多仓项目时明确边界，防止越界改动

三、修改后如何验证生效

改完配置不要凭感觉。启动会话后，先问一句"你当前使用的模型、审批模式、沙箱设置分别是什么"，或用内置的查看配置命令确认；再故意让它执行一条需要审批的命令，观察是否按预期弹出确认。配置写错最常见的后果是"行为和你想的不一样"，而不是报错，所以一定要用一个小任务实测一遍。

配置字段会随版本迭代调整，完整、最新的字段说明请以 OpenAI 官方文档为准，本节只建立"分层—常用项—实测"的使用心智。