openai/codex-plugin-cc：将 Claude Code 的 Codex 功能直接嵌入 VS Code 实现代码审查与任务委托

## 这是什么

openai/codex-plugin-cc 是 OpenAI 官方发布的 Claude Code 插件。它允许 Claude Code 用户在现有工作流中直接调用 OpenAI 的 Codex CLI 和 app server，无需切换工具或离开终端。

插件通过 Claude Code 的插件系统加载 /codex:review、 /codex:adversarial-review、 /codex:rescue 等斜杠命令，将 Codex 的代码审查、任务委派、持久化线程等能力无缝集成进 Claude Code 的 Stop hook 和 SessionStart hook。

安装后，用户可在同一终端中同时运行 Claude Code 的多文件编辑和 Codex 的 background 任务，共享本地 Codex 安装、认证状态和 config.toml 配置。

## 解决的问题

Claude Code（Anthropic 终端 AI 编码助手）以多文件协作和上下文理解著称，但用户常因模型限制无法获得 OpenAI 高质量审查或完成特定任务。

使用 Codex 可以：

• 对 Claude 生成的代码进行独立、深度审查（包括设计权衡和风险点）
• 委派长耗时任务（如 flaky 测试排查、回归调查）或用更小模型快速原型
• 从 Claude session 直接转移到 Codex 持久化线程，继续未完成对话
• 实现 Claude 输出后自动触发 Codex 审查门（review gate），防止低质量提交

这些需求在纯 Claude Code 或纯 Codex 中都难以同时满足。

## 核心功能

• /codex:review：对当前未提交修改或分支 vs base（e.g. main）执行只读 Codex 审查，支持 --base <ref>、--wait、--background。进度可通过 /codex:status 监控。
• /codex:adversarial-review：可控审查模式，接受额外焦点文本，用于压力测试假设、tradeoffs、隐藏风险（如 auth、race conditions、rollback）。同样支持 background 和 base 分支。
• /codex:rescue：通过 codex:codex-rescue 子代理委派任务，支持 --background、--wait、--resume、--fresh、--model（可映射 spark 为 gpt-5.3-codex-spark）和 --effort（medium 等）。可自然语言直接下达任务，如“Ask Codex to redesign the database connection to be more resilient.”；后续请求会自动延续最新线程。
• /codex:transfer：将当前 Claude Code 会话转存为 Codex 持久化线程，自动或手动指定源文件路径（必须在 ~/.claude/projects 内），输出 codex resume <session-id> 命令，支持后续在 Codex App/TUI 中继续。
• /codex:status / /codex:result / /codex:cancel：实时查看/管理当前 repo 的 Codex 后台任务，查看最终输出并获取 session ID。
• /codex:setup：检查 Codex 安装与认证状态，可一键 npm 安装；同时管理 review gate（Stop hook 触发 Codex 审查，问题未解决则阻塞 Claude 提交）。

插件全部通过全局 codex 二进制和 app server 调用，兼容用户现有 config.toml（user-level 或 project-level .codex/config.toml，支持 model = "gpt-5.4-mini" 和 model_reasoning_effort = "high"）。

## 亮点 / 与同类相比

• 零切换、无额外运行时：直接复用 Codex CLI 的本地安装、认证和环境，而非单独部署服务或启动独立进程。这是与 Claude Code 原生插件或社区 fork（如 byom-review）最大的差异。
• 上下文无缝迁移： /codex:transfer 利用 Codex external-agent session importer，可将 Claude transcript 转为可见 turns，支持导入历史对话并在 Codex 恢复。
• 审查 gate 功能：可选 review gate 可在 Claude 停止时自动调用 Codex 审查，防止直接提交问题代码，解决了跨模型质量把控难题。
• 模型灵活与成本控制：支持任意 OpenAI 模型（包括 spark 系列），默认跟随 Codex 配置，可指定 --model 和 --effort；小模型快速迭代 vs 大模型深度审查，显著降低长任务成本。
• 与 Codex 原生体验一致：所有命令最终都在 Codex App 或 TUI 中可继续/查看，支持 worktree、Git 操作和多线程并行。

相比纯 Claude Code，用户可获得 OpenAI 模型在代码执行和多模态（截图/图表）支持上的优势；相比纯 Codex，无需切换桌面或额外配置即可在已有终端工作流中使用。

## 适合谁用 / 上手

适合已使用 Claude Code（或计划迁移到它）的开发者，尤其需要：

• 独立于 Claude 的代码质量把关（pre-shipping 审查、风险压力测试）
• 委派长耗时或模型敏感任务（如 CI 故障、集成测试、数据库重构）
• 从 Claude 多文件协作转向 Codex 持久化线程或 background 作业
• 同时享受两个模型生态红利（Anthropic + OpenAI）

上手门槛极低：

1. 确保 Node.js 18.18+ 和 ChatGPT 订阅（含 Free）或 OpenAI API key。
2. 在 Claude Code 中执行：/plugin marketplace add openai/codex-plugin-cc、 /plugin install codex@openai-codex、 /reload-plugins、 /codex:setup。
3. 若未登录 Codex，运行 !codex login。
4. 首测：/codex:review --background（监控状态和结果）。
5. 高级流程示例：先 Claude 写代码，执行 /codex:adversarial-review 挑战设计，再用 /codex:rescue 委派修复，或 /codex:transfer 保留上下文。

插件目前为 1.0.x 版本（2026 年 6 月更新），无已知 Breaking Change。推荐在 trusted 项目中使用 project-level config.toml 覆盖默认模型/ effort，避免影响全局设置。

安装后立即可用，无需额外 SDK 或环境配置，开发者可直接将 Codex 能力注入 Claude Code 现有 workflow。