codex

Codex 技能指南

运行任务

1. 对于新会话（恢复的会话会沿用之前的模型和推理力度——见第 5 步），通过 AskUserQuestion 向用户询问要使用的模型和推理力度，并在同一条提示中提出两个问题。如果用户没有偏好，默认使用 gpt-6-astra 和 high。
   • 模型 — 默认使用 gpt-6-astra：
     • GPT-6： gpt-6-astra（前沿／能力最强——默认）
     • GPT-5.6： gpt-5.6-sol（可靠的 Agent 工作主力）、gpt-5.6-terra（均衡，适合日常使用）、gpt-5.6-luna（快速且经济）
     • 旧版（为兼容性保留）： gpt-5.5、gpt-5.4、gpt-5.4-mini、gpt-5.3-codex-spark、gpt-5.3-codex
   • 推理力度 — 默认使用 high：low、medium、high、xhigh、max、ultra。
     • max／ultra 需要 GPT-6 或 GPT-5.6 模型；ultra 仅适用于 astra／sol／terra（luna 最高支持 max）；旧版模型最高支持 xhigh。
     • ultra = 最高推理力度，并自动委派任务（最慢且成本最高——仅用于最困难的任务）。
     • 如果所选推理力度超出所选模型的上限，则改用该模型支持的最高推理力度，并告知用户。
2. 选择任务所需的沙箱模式；除非需要编辑或访问网络，否则默认使用 --sandbox read-only。
3. 使用适当的选项组装命令：
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<low|medium|high|xhigh|max|ultra>"（max／ultra 仅适用于 GPT-6／GPT-5.6 模型；ultra 仅适用于 astra／sol／terra——见第 1 步）
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
   • "your prompt here"（作为最后一个位置参数）
4. 始终使用 --skip-git-repo-check。
5. 继续之前的会话时，通过 stdin 使用 codex exec --skip-git-repo-check resume --last。恢复会话时，不要使用任何配置标志，除非用户明确要求，例如在请求恢复会话时指定模型或推理力度。恢复语法：echo "your prompt here" | codex exec --skip-git-repo-check resume --last 2>/dev/null。所有标志都必须放在 exec 和 resume 之间。
6. 重要： 默认情况下，在所有 codex exec 命令后追加 2>/dev/null，以抑制思考 token（stderr）。只有用户明确要求查看思考 token 或需要调试时，才显示 stderr。
7. 重要（stdin）： codex exec 始终会读取 stdin，并将其与位置提示词拼接，即使提示词已完全通过位置参数提供。如果 stdin 未关闭，codex 将永久阻塞。通过执行框架调用时（例如后台任务、钩子、脚本，其中 stdin 不是 TTY 且未关闭），请显式重定向 stdin：在命令后追加 </dev/null，例如 codex exec ... "prompt" </dev/null 2>/dev/null。出错时的表现：stdout 字节数为零、累计 CPU 时间为零、进程似乎无限期挂起。
8. 运行命令，捕获 stdout／stderr（并按需过滤），然后向用户总结结果。
9. Codex 完成后，告知用户：“你可以随时说‘codex resume’，或让我继续进行分析或修改，以恢复此 Codex 会话。”

快速参考

用例	沙箱模式	关键标志
只读审查或分析	read-only	--sandbox read-only 2>/dev/null
应用本地编辑	workspace-write	--sandbox workspace-write --full-auto 2>/dev/null
允许网络或广泛访问	danger-full-access	--sandbox danger-full-access --full-auto 2>/dev/null
恢复最近的会话	沿用原会话设置	echo "prompt" | codex exec --skip-git-repo-check resume --last 2>/dev/null（不允许使用标志）
从其他目录运行	与任务需求匹配	-C <DIR> 加上其他标志 2>/dev/null

执行超时

Codex 不会生成中间输出——只会在完成时写入结果。如果进程在完成前被终止，输出文件会静默地变成空文件（不会报错）。

**首选方法：**同步运行——完全消除超时风险，而且对话无论如何都要等待结果。

如果在后台运行，请根据推理强度设置执行超时时间：

推理强度	超时时间
low	150s
medium	300s
high	600s
xhigh	1200s
max	1800s
ultra	1800s

后续操作

• 每次执行 codex 命令后，立即使用 AskUserQuestion 确认下一步、收集澄清信息，或决定是否通过 codex exec resume --last 继续。
• 恢复会话时，通过标准输入传入新提示词：echo "new prompt" | codex exec resume --last 2>/dev/null。恢复的会话会自动沿用原会话的模型、推理强度和沙盒模式。
• 提出后续操作建议时，请重申所选模型、推理强度和沙盒模式。

对 Codex 输出进行批判性评估

Codex 由 OpenAI 模型驱动，这些模型有各自的知识截止时间和局限性。请将 Codex 视为同事，而非权威。

指南

• 有把握时相信自己的知识。如果 Codex 的说法与你确信的事实不符，请直接提出异议。
• 通过 WebSearch 或文档调查分歧，再决定是否接受 Codex 的说法。必要时通过恢复会话将调查结果分享给 Codex。
• 牢记知识截止时间——Codex 可能不了解训练数据之后发布的版本、API 或变更。
• 不要盲目听从——Codex 可能会出错。请特别审慎地评估以下方面的建议：
  • 模型名称和能力
  • 近期的库版本或 API 变更
  • 可能随时间变化的最佳实践

Codex 出错时

1. 明确向用户说明你的不同意见
2. 提供证据（来自自身知识、网络搜索或文档）
3. 可选择恢复 Codex 会话讨论分歧。请表明你是 Claude，让 Codex 知道这是同级 AI 之间的讨论。使用你当前运行所用的实际模型名称（例如你当前运行的模型），而不要使用硬编码的名称：

   echo "This is Claude (<your current model name>) following up. I disagree with [X] because [evidence]. What's your take on this?" | codex exec --skip-git-repo-check resume --last 2>/dev/null
   

4. 将分歧作为讨论来处理，而非纠正——任何一方的 AI 都可能出错
5. 如果确实存在歧义，请让用户决定如何继续

错误处理

• 如果 codex --version 或 codex exec 命令以非零状态退出，请停止并报告失败；重试前先征求用户指示。
• 使用高影响标志（--full-auto、--sandbox danger-full-access、--skip-git-repo-check）前，请使用 AskUserQuestion 征求用户许可，除非用户已授权。
• 输出中包含警告或部分结果时，请总结相关情况，并使用 AskUserQuestion 询问如何调整。