codex

用途

Codex 技能通过 OpenAI 的 Codex CLI 提供第二意见、验证、分析、代码审查或自主任务委派能力。当用户说出“use codex”等触发词时启用。

主要能力

默认配置：模型固定为 gpt-5.4，推理强度固定为 xhigh，除非用户明确要求其他级别。命令中始终显式传入 -m gpt-5.4 -c model_reasoning_effort="xhigh"，不依赖 config.toml。
快速模式（Fast Mode）：稳定功能标志，默认启用，底层使用 service_tier = "fast"，同一 gpt-5.4 模型，输出约快 1.5 倍，额度消耗为 2 倍。仅适用于 ChatGPT OAuth 登录（不适用于 API key）。默认已激活，无需额外标志；可通过 --disable fast_mode 单次禁用，--enable fast_mode 重新启用，交互式切换使用 /fast。
模型选择：gpt-5.4 为默认且始终使用，需要 ChatGPT OAuth 登录（codex login）；gpt-5.3-codex 仅在 gpt-5.4 失败时作为回退，支持 OAuth 和 API key；gpt-5.2-codex 为更旧的回退；gpt-5.1-codex-max 支持多上下文窗口，适合项目级重构；gpt-5.1-codex-mini 更具成本效益（约 4 倍使用量）。

提示词框架

Codex 默认具有对抗性和批判性，会挑战假设、提出替代方案，有时会反向论证。需要正确构建提示词才能获得建设性输出。提示前应自问：用户意图是否足够清晰以写出聚焦的提示词？若不够，先请用户澄清。

提示词框架规则：

先陈述目标与方向，说明要达成什么以及为什么。
明确限定审查范围，说明关注点和不涉及的内容。
说明想要的反馈类型（找 bug、验证方案、在现有方案内提改进、找盲点）。
提供工作的性质/方向（原型、生产代码、学习练习、性能关键路径）。
固定已做出的决策，告知 Codex 不要重新讨论已锁定的框架或模式。

提示词模板包含：Goal（目标与原因）、Decisions Already Made（已锁定决策）、Context（代码与架构）、What We Need From You（具体编号问题）、Out of Scope（不评论的内容）。

使用方式（三种模式）

1. 快速模式（Quick Mode）：适用于 Claude 已有答案上下文、只需第二意见的简单问题。Bash 工具超时 120000ms。命令示例：

codex exec -m gpt-5.4 --skip-git-repo-check --sandbox read-only --ephemeral \
  -c model_reasoning_effort="xhigh" "<PROMPT>"

2. 分析模式（Analysis Mode）：Claude 整理上下文，Codex 分析。适用于 Codex 不需要文件系统访问、由 Claude 担任上下文工程师的场景。Bash 工具超时 300000ms。步骤：先用 Write 工具写结构化提示词文件，再通过文件 I/O 调用，最后用 Read 工具读取输出文件并呈现给用户。命令示例：

codex exec -m gpt-5.4 \
  --sandbox read-only \
  --ephemeral \
  -c model_reasoning_effort="xhigh" \
  -o "$OUTPUT_FILE" \
  - < "$PROMPT_FILE"

3. 委派模式（Delegated Mode）：Codex 自主工作，拥有完整文件系统访问和工具使用能力。适用于让 Codex 自行审查代码库、探索并形成意见、实现功能、运行测试或调试调查。此模式不要使用 --ephemeral，因为多步骤工作可能需要会话持久化。Bash 工具超时 600000ms；预计超过 10 分钟的任务使用 run_in_background: true 并稍后检查输出文件。命令示例：

codex exec -m gpt-5.4 \
  -C /path/to/project \
  --full-auto \
  -c model_reasoning_effort="xhigh" \
  -o "$OUTPUT_FILE" \
  "<PROMPT>"

代码审查可使用内置 review 子命令：

codex exec review -m gpt-5.4 -C /path/to/project --full-auto \
  -c model_reasoning_effort="xhigh" -o "$OUTPUT_FILE"

或顶层 review 命令：

codex review -m gpt-5.4 -C /path/to/project \
  -c model_reasoning_effort="xhigh" -o "$OUTPUT_FILE"

委派模式无输出约束，-o 标志仅捕获最终消息以保持上下文可控。

模式选择

“Ask codex about X”且 Claude 已有上下文 → 分析模式
“Have codex review the repo” → 委派模式
“Quick question for codex” → 快速模式
“Get codex's opinion on this architecture”且代码已探索 → 分析模式
“Have codex explore and analyze this project” → 委派模式
“Use codex to implement X” → 委派模式

输出处理

除快速模式可内联外，始终使用 -o <file> 捕获输出，仅保留最终响应，去除会话头、工具使用痕迹和思考过程，用 Read 工具读取。分析模式内联呈现时摘要，用户需要细节时给完整输出；委派模式呈现完整输出并检查是否修改了文件。始终验证输出文件存在，若为空或缺失则检查 stderr 并报告。

错误处理

命令非零退出时检查 stderr（不要用 2>/dev/null 抑制）
输出文件为空或缺失时向用户报告错误
认证失败时提示用户运行 codex login
gpt-5.4 失败时回退到 gpt-5.3-codex，将 -m gpt-5.4 替换为 -m gpt-5.3-codex 并用相同标志重试
Bash 工具超时则进程被杀、输出丢失，委派任务用 run_in_background: true 重跑

上下文工程（仅分析模式）

架构用自己话总结而非粘贴 README；代码只给相关片段（热路径、讨论中的具体函数）；依赖给名称和版本而非完整 package.json；问题编号、具体、无需文件系统访问即可回答；方向始终包含原因和已锁定方案。除非用户要求简洁，不要人为限制输出长度。

压缩韧性

输出文件写入 ~/.claude/subagent-results/（持久化，非 /tmp/）。上下文压缩后输出文件仍在磁盘上，可用 Read 工具重读；CLAUDE.md 压缩指令会保留这些文件路径；若丢失路径可运行 ls -t ~/.claude/subagent-results/codex-output-* | head -1。

适用场景与限制

最适合：代码审查、安全分析、bug 排查、验证、实现、自主任务。使用扩展思考（xhigh）进行最深推理。GPT-5.4 是最新模型，具有改进的推理和实时引导能力。--ephemeral 防止会话文件杂乱，仅用于快速和分析模式，不用于委派模式。快速模式仅适用于 ChatGPT OAuth 登录，不适用于 API key。