#配置与 CLI 参考

#配置层次

Codex 配置自外而内叠加：

1. ~/.codex/config.toml — 用户默认
2. .codex/config.toml — 项目覆盖（需 trust 项目）
3. requirements.toml — 组织强制策略（托管设备）
4. CLI 标志 — 单次会话覆盖

CLI 与 IDE 扩展 共享同一套配置模型。

#config.toml 常用项

# 模型（示例，以账户可用为准）
model = "gpt-5.3-codex"

# 沙箱与审批
sandbox_mode = "workspace-write"
approval_policy = "on-request"

# AGENTS.md 发现
project_doc_fallback_filenames = ["TEAM_GUIDE.md"]
project_doc_max_bytes = 32768

# Skills 开关
# [[skills.config]]
# path = "/path/to/skill"
# enabled = false

# MCP
[mcp_servers.my_server]
command = "npx"
args = ["-y", "some-mcp-server"]
enabled = true

完整键列表见 Configuration Reference。

#常用 CLI 标志

#子命令概览

详细参数见 CLI Reference。

#模型切换

TUI 内：

/model

选择 GPT-5.x、Codex 优化型号等。长任务、复杂 refactor 选强推理；简单脚本选低延迟型号。

#日志与会话

codex -c log_dir=./.codex-log

• TUI 日志：codex-tui.log
• 会话 JSONL（若启用）：session-*.jsonl

用于审计 AGENTS.md 是否加载、工具调用序列。

#脚本化示例

#!/usr/bin/env bash
set -euo pipefail

codex exec \
  --sandbox workspace-write \
  --ask-for-approval never \
  --json \
  --output-last-message \
  "运行 go test ./... 并仅修复测试失败，不改 go.mod"

#CODEX_HOME 多 Profile

export CODEX_HOME="$HOME/.codex-work"
codex exec "..."

适合工作 / 个人账号分离，或 CI 机器人用户。

#下一步

• 沙箱与安全：理解各 preset 风险
• 实战案例：组合 exec + CI