Codex
配置文件
- （无配置文件） — 只读分析（不编译、不测试）
--profile edit— 本地编辑、构建或测试（workspace-write，全自动）--profile full— 网络或广泛文件系统访问（danger-full-access，全自动）
只要任务涉及 go test、go build 或任何写入构建产物的命令，请使用 --profile edit。默认的只读沙盒会阻止所有写入操作，包括编译器的临时目录。
对于复杂任务，可添加 --config model_reasoning_effort="xhigh"。
模型选择
默认使用 .codex/config.toml 中的项目模型（gpt-5.4）。
对于速度优先的交互式工作，请使用 --model gpt-5.3-codex-spark：
- 紧密的来回迭代
- 快速修复错误和有针对性的编辑
- 中小型重构或 UI 调整
- 需要频繁重定向/中断的快速原型开发
对于深度优先的工作，保持默认的 gpt-5.4：
- 长时间自主学习运行
- 需要大量推理的广泛多文件更改
- 测试密集型或验证密集型任务
- 更高的正确性/风险场景，其中更深入的推理值得额外的延迟
如果用户明确请求某个模型，请遵循用户的请求。
命令
项目默认值在 .codex/config.toml 中。始终包含 --skip-git-repo-check 和 2>/dev/null。仅当用户明确请求时，或当任务明确符合上述 Spark 速度优先标准时，才覆盖模型。
| 用例 | 命令 |
|---|---|
| 只读分析 | codex exec --skip-git-repo-check -o "$CODEX_OUT" "prompt" 2>/dev/null |
| 速度优先的交互式循环（Spark） | 添加 --model gpt-5.3-codex-spark |
| 应用本地编辑 | 添加 --profile edit |
| 网络 / 广泛访问 | 添加 --profile full |
| 恢复会话 | `echo "prompt" |
在运行之前创建一个用于输出的临时文件：CODEX_OUT=$(mktemp /tmp/codex-out.XXXXXX)。完成后从 $CODEX_OUT 读取结果。
使用 Bash run_in_background: true 运行。通过 TaskOutput 监控，设置 block: true, timeout: 600000——不要使用 sleep 命令进行轮询。读取 -o 文件以获取最终答案。
恢复
恢复时不要传递模型/努力/沙盒标志——原始会话设置会延续。-o 可以安全包含。
约定
这是一个 Go 项目。在提示中使用 go test、go build、go vet。Codex 工作器不会收到 CLAUDE.md 或钩子，因此项目约定必须明确。
执行后验证
始终通过 git diff --stat 验证 Codex 输出——永远不要相信工作器自我报告的文件列表。Codex 工作器可能会进行超出范围的更改（删除文件、恢复不相关的代码、移除测试函数）。完成承诺可能只列出预期的文件，而忽略破坏性的副作用。
当同一代码库中存在其他工作时，在提示中包含明确的“请勿修改或删除”文件列表。正面的指令（“仅接触这些文件”）是不够的——Codex 会宽泛地解释“清理”。
依据 [[principles/prove-it-works]]：信任产物，而不是自我报告。
工作树使用
使用 -C <worktree-dir> 时，工作树有自己的 git 索引。.claude/ 可能符号链接到 .agents/——对 git 操作使用 .agents/ 路径。