配置参考

配置文件位置

作用域	路径	优先级
全局个人配置	~/.codex/config.toml	基础
项目级配置	.codex/config.toml	覆盖全局
命令行参数	codex exec --flag	最高
Profile 配置	$CODEX_HOME/<profile>.config.toml	场景覆盖

常用配置项

# 模型设置
model = "gpt-5.5"
model_reasoning_effort = "high"  # low | medium | high | extra_high

# 沙箱和安全
sandbox_mode = "workspace-write"  # read-only | workspace-write | danger-full-access

# 审批策略
approval_policy = "default"  # default | never | always

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

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

# 后备文件名
project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 65536

配置优先级

1. 命令行参数覆盖配置文件
2. 项目级配置覆盖全局配置
3. 具体设置覆盖通用设置
4. Profile 配置在特定场景下生效