基本配置

配置是让 Codex 在会话和使用方式间保持一致行为的主要方式之一。

配置层次

Codex 使用多层次的配置系统：

• 个人默认值：保存在 ~/.codex/config.toml（在桌面应用中通过 设置 → 配置 → 打开 config.toml 编辑）
• 仓库特定配置：保存在 .codex/config.toml
• 命令行覆盖：仅用于一次性场景（如果使用 CLI）
• Profile 覆盖：独立配置文件，保存在 $CODEX_HOME/profile-name.config.toml

CLI、IDE 和桌面应用共享相同的配置层次。

可配置项

config.toml 是定义持久化偏好的地方，例如：

• MCP 服务器
• 多 Agent 设置
• 功能标志
• 模型选择
• 推理力度
• 沙箱模式
• 审批策略

关于沙箱和审批

Codex 提供操作级别的沙箱机制，有两个关键控制项：

• 审批模式：确定 Codex 何时需要你的许可才能运行命令
• 沙箱模式：确定 Codex 能否读取或写入目录，以及 Agent 可以访问哪些文件

如果你是编程助手的新手，从默认权限开始。默认保持审批和沙箱的严格限制，只在需要时才放松权限。

常见配置示例

# 模型设置
model = "gpt-5.5"

# 推理力度
model_reasoning_effort = "high"  # low | medium | high | extra_high

# 多 Agent 设置
[agents]
max_threads = 6
max_depth = 1

# MCP 服务器
[mcp_servers]
[mcp_servers.my-server]
command = "node"
args = ["path/to/server.mjs"]

尽早为真实环境配置 Codex。许多质量问题实际上是配置问题——错误的工作目录、缺少写入权限、错误的模型默认值或缺少工具和连接器。