用途
Codex Configuration 用于管理 OpenAI Codex CLI 的配置文件，涵盖模型设置、沙箱策略、MCP 服务器以及命名配置文件（profiles）。当需要配置 Codex CLI、设置 profiles，或涉及 config.toml、sandbox mode、Codex config、approval policy 等场景时，可使用该技能。
配置文件位置
主配置文件：~/.codex/config.toml
技能路径（优先级从高到低）：
- $CWD/.codex/skills/ - 当前目录
- $CWD/../.codex/skills/ - 父目录
- $REPO_ROOT/.codex/skills/ - 仓库根目录
- ~/.codex/skills/ - 用户级
- /etc/codex/skills/ - 系统/管理员级
- 内置技能 - 随 Codex 捆绑
基本 config.toml
# Model settings
model = "gpt-5.2-codex"
model_verbosity = "medium" # high | medium | low
model_reasoning_effort = "high" # low | high | xhigh
# Permissions
approval_policy = "on-failure" # untrusted | on-failure | on-request | never
sandbox_mode = "workspace-write" # read-only | workspace-write | danger-full-access
exec_timeout_ms = 300000 # 5 minutes
# Misc
file_opener = "cursor" # Editor for opening files
Profiles
可为不同工作流定义命名 profiles：
[profiles.max]
model = "gpt-5.1-codex-max"
model_verbosity = "high"
model_reasoning_effort = "xhigh"
[profiles.fast]
model = "gpt-5.1-codex-mini"
model_verbosity = "low"
model_reasoning_effort = "low"
使用方式：
codex -p max "complex refactoring task"
codex -p fast "quick fix"
MCP 服务器
[mcp_servers.server-name]
command = "npx"
args = ["-y", "@package/mcp-server"]
enabled = true
tool_timeout_sec = 60.0
[mcp_servers.server-name.env]
API_KEY = "your-key"
技能
调用技能：
# Explicit invocation
codex "$plan implement authentication"
codex "$skill-creator new skill for testing"
# Implicit (Codex decides based on context)
codex "plan out the implementation"
内置技能：
- $plan - 研究并创建实现计划
- $skill-creator - 引导创建新技能
- $skill-installer - 从 GitHub 下载技能
CLI 覆盖
可在运行时覆盖任意配置值：
codex -c model="o3"
codex -c 'sandbox_permissions=["disk-full-read-access"]'
codex -c shell_environment_policy.inherit=all
便捷标志：
| Flag | Equivalent |
|---|---|
| --full-auto | -a on-request --sandbox workspace-write |
| --oss | -c model_provider=oss（本地 LM Studio/Ollama） |
| --search | 启用 web search 工具 |
codex --full-auto "implement feature"
codex -C /path/to/project "work in different dir"
codex --add-dir /additional/path "access multiple dirs"
快速校验
# Check TOML syntax
cat ~/.codex/config.toml | toml-lint
# Test config override
codex -c model="test" --help
# Verify MCP servers
codex mcp list
快速排查
- 配置未加载：确认 ~/.codex/config.toml 存在，检查 TOML 语法
- MCP 服务器未连接：检查命令路径、验证 API keys、检查 enabled = true
- 技能未找到：验证路径层级，检查技能文件夹中是否存在 SKILL.md
- 沙箱过于严格：使用 -s workspace-write，检查项目信任级别
参考
针对特定场景的详细文档：
- MCP Servers - 服务器配置示例（Context7、Firecrawl、Graphite、Linear）
- Troubleshooting - 常见问题、调试命令、校验
- Security - 沙箱模式、审批策略、信任级别、最佳实践