codex

Codex 技能指南

运行任务

1. 默认使用 gpt-5.2 模型。通过 AskUserQuestion 询问用户使用哪种推理强度（xhigh、high、medium 或 low）。用户可根据需要覆盖模型（见下方模型选项）。
2. 选择任务所需的沙箱模式；默认使用 --sandbox read-only，除非需要编辑或网络访问。
3. 使用适当的选项组装命令：
   • -m, --model <MODEL>
   • --config model_reasoning_effort="<high|medium|low>"
   • --sandbox <read-only|workspace-write|danger-full-access>
   • --full-auto
   • -C, --cd <DIR>
   • --skip-git-repo-check
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. 运行命令，捕获 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

模型选项

模型	最适合	上下文窗口	关键特性
gpt-5.2-max	Max 模型：超复杂推理、深度问题分析	400K 输入 / 128K 输出	76.3% SWE-bench、自适应推理、$1.25/$10.00
gpt-5.2 ⭐	旗舰模型：软件工程、Agent 编码工作流	400K 输入 / 128K 输出	76.3% SWE-bench、自适应推理、$1.25/$10.00
gpt-5.2-mini	成本高效的编码（4 倍使用额度）	400K 输入 / 128K 输出	接近 SOTA 性能、$0.25/$2.00
gpt-5.1-thinking	超复杂推理、深度问题分析	400K 输入 / 128K 输出	自适应思考深度、在最困难的任务上运行速度慢 2 倍

GPT-5.2 优势：76.3% SWE-bench（相比 GPT-5 的 72.8%）、平均任务速度提升 30%、更好的工具处理、减少幻觉、提升代码质量。知识截止日期：2024 年 9 月 30 日。

推理强度级别：

• xhigh - 超复杂任务（深度问题分析、复杂推理、对问题的深入理解）
• high - 复杂任务（重构、架构、安全分析、性能优化）
• medium - 标准任务（重构、代码组织、功能添加、缺陷修复）
• low - 简单任务（快速修复、简单更改、代码格式化、文档）

缓存输入折扣：重复上下文可享受 90% 折扣（$0.125/M token），缓存最长持续 24 小时。

后续跟进

• 每次执行 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 询问如何调整。

CLI 版本

需要 Codex CLI v0.57.0 或更高版本以支持 GPT-5.2 模型。CLI 在 macOS/Linux 上默认为 gpt-5.2，在 Windows 上默认为 gpt-5.2。检查版本：codex --version

在 Codex 会话中使用 /model 斜杠命令切换模型，或在 ~/.codex/config.toml 中配置默认值。