配置基础

Codex 从多个位置读取配置。你的个人默认配置位于 ~/.codex/config.toml，可以通过 .codex/config.toml 文件添加项目级覆盖。

配置文件

Codex 在 ~/.codex/config.toml 存储用户级配置。要将设置限定到特定项目或子文件夹，在仓库中添加 .codex/config.toml 文件。

CLI 和 IDE 扩展共享相同的配置层。你可以使用它们来：

• 设置默认模型和提供商
• 配置审批策略和沙箱设置
• 配置 MCP 服务器

配置优先级

Codex 按以下顺序解析值（优先级从高到低）：

1. CLI 参数和 --config 覆盖
2. 项目配置文件：.codex/config.toml（从项目根到当前目录，最近者优先，仅受信任的项目）
3. 使用 --profile profile-name 选择的配置文件（~/.codex/profile-name.config.toml）
4. 用户配置：~/.codex/config.toml
5. 系统配置：Unix 上的 /etc/codex/config.toml
6. 内置默认值

常见配置选项

# 默认模型
model = "gpt-5.5"

# 审批策略
approval_policy = "on-request"

# 沙箱级别
sandbox_mode = "workspace-write"