#19. 配置文件

Codex 的配置分为几个层级。

全局配置位于 ~/.codex/config.toml，影响所有项目。适合设置个人偏好，比如默认模型、审批策略、主题等。

项目配置是项目根目录下的 AGENTS.md 文件。这是 Codex 的"项目指南"，每次启动时自动读取。适合写项目的技术栈、目录结构、测试命令、编码规范等。团队项目中应将 AGENTS.md 提交到 Git 仓库，确保所有人使用 Codex 时获得一致的指导。

临时覆盖可以在启动命令中用 -c 参数实现，只影响当前会话：

codex -m gpt-5.4-mini -c 'approval_policy=on-request' "你的任务"

什么时候修改配置？ 当你发现 Codex 反复犯同样的错误（比如用了错误的代码风格、不知道怎么运行测试），就是时候更新 AGENTS.md 或 config.toml 了。好的配置能大幅减少你在对话中的重复说明。