基本配置

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

配置层次

个人默认值：~/.codex/config.toml
仓库特定配置：.codex/config.toml
命令行覆盖：仅用于一次性场景
Profile 覆盖：$CODEX_HOME/<profile>.config.toml

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

可配置项

toml

# 模型
model = "gpt-5.5"
model_reasoning_effort = "high"

# 沙箱
sandbox_mode = "workspace-write"

# 审批
approval_policy = "default"

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

# MCP
[mcp_servers]

沙箱和审批

Codex 有两个关键安全控制项：

审批模式：决定 Codex 何时需要您的许可才能运行命令
沙箱模式：决定 Codex 可以访问哪些文件和资源

从默认权限开始，需要时再放松。