codex

Codex 技能指南

运行任务

1. 默认情况下，不要指定模型。 Codex CLI 配置为使用 ChatGPT 账户，显式指定模型的标志（-m gpt-5-codex、-m gpt-5、-m o4-mini）都会失败，并显示“使用 ChatGPT 账户运行 Codex 时不支持”。省略 -m 后，Codex 会使用其默认模型，且可以正常运行。只有在用户明确要求使用特定模型时，才添加 -m。
2. 选择任务所需的沙盒模式；除非需要编辑或网络访问，否则默认使用 --sandbox read-only。
3. 使用合适的选项组装命令：
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
   • -m, --model <MODEL>（仅在用户明确要求时使用）
   • --config model_reasoning_effort="<high|medium|low>"（仅在用户明确要求时使用）
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，以隐藏思考令牌（stderr）。只有在用户明确要求查看思考令牌或需要调试时，才显示 stderr。
7. 运行命令，捕获 stdout/stderr（并进行适当过滤），然后向用户总结结果。
8. 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 命令后，立即使用 AskUserQuestion 确认后续步骤、收集澄清信息，或决定是否通过 codex exec resume --last 恢复会话。
• 恢复会话时，通过 stdin 传入新提示词：echo "new prompt" | codex exec resume --last 2>/dev/null。恢复的会话会自动沿用原会话的模型、推理力度和沙盒模式。
• 提出后续操作建议时，重申所选的模型、推理力度和沙盒模式。

错误处理

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