Codex 基础配置

Codex 的配置主要影响本地 Codex 工作流，例如 Codex CLI 和 Codex App 的 Local 或 Worktree 线程。CLI、App、本地线程会共享一部分配置、MCP 和 Skills 语境，但 App 的 Cloud 模式还会受云端环境、账号和工作区设置影响，不要把它简单理解成本地 config.toml 完全控制。

这些配置决定它默认用什么模型、运行命令前是否需要你确认、能访问哪些文件，以及项目里有哪些长期规则。新手不需要一开始就改很多配置，但要知道这些配置是什么意思。

配置文件在哪里

官方手册说明，用户级配置通常在：

~/.codex/config.toml

项目级配置可以放在仓库里的：

.codex/config.toml

项目级配置只在你信任这个项目时加载。这样可以避免陌生项目偷偷改变 Codex 的行为。

Codex 配置文件示例

常见配置项

配置	作用
`model`	默认使用哪个模型。
`approval_policy`	什么时候需要你确认命令或操作。
`sandbox_mode`	Codex 能访问和修改哪些文件。
`web_search`	是否允许使用网络搜索。

新手推荐思路

不清楚时，不要一开始使用完全无限制权限。
对陌生项目，先让 Codex 只阅读和解释。
需要修改文件时，先让它说明计划。
需要运行命令时，先看清命令用途。

项目规则 AGENTS.md

AGENTS.md 可以放项目里的长期说明，例如：

项目目录结构。
如何运行测试。
代码风格。
哪些文件不能改。
完成任务前要做哪些检查。

它相当于写给 AI Agent 的项目说明书。团队项目里，AGENTS.md 比每次口头重复规则更稳定。

一个简单配置示例

approval_policy = "on-request"
sandbox_mode = "workspace-write"

这表示 Codex 可以在工作区内工作，并在需要时请求确认。实际可用值以你安装的 Codex 版本和官方文档为准。

验证结果

配置后可以检查：

Codex 是否仍能正常启动。
当前项目是否被信任。
修改文件前是否按预期请求确认。
运行命令时是否符合你的权限预期。

Codex 项目信任或权限提示

常见问题

我应该马上改模型吗

不一定。先用默认推荐模型完成简单任务，等你知道自己需要更快、更便宜或更强时，再调整模型。

配置改坏了怎么办

先撤回最近改动，或把配置文件临时改名，让 Codex 回到默认配置，再逐项恢复。