Creeta

2026 年 3 月 30 日发生了一件罕见的事:OpenAI 将第一方工具直接植入了竞争对手的终端。其成果就是 codex-plugin-cc,它改变了双代理工作流如何在同一窗口中协同。

codex-plugin-cc 是什么,以及 OpenAI 为什么为 Claude Code 构建它

codex-plugin-cc 是一个官方 OpenAI 插件,可在 Anthropic 的 Claude Code CLI 中运行 Codex 编码代理。它位于 openai/codex-plugin-cc,采用 Apache-2.0 许可,实际上是纯 JavaScript。该插件值得关注的地方在于其方向:一家前沿模型厂商为竞争对手的生态系统打包工具。

它不是一个新的运行时。正如 OpenAI 在开发者论坛公告中所说:

"它不是一个独立的运行时。它就是 Codex,只是从 Claude Code 内部调用。" — OpenAI(来源:OpenAI 开发者社区

该插件委托已安装在机器上的 Codex CLI 和应用服务器,重用现有的身份验证和配置。维护处于活跃状态:v1.0.0 于 2026 年 3 月 30 日发布,当前的 v1.0.6 于 2026 年 7 月 8 日发布——四个月内发布了六个补丁版本。这正是截至 2026 年 6 月每周活跃用户超过 500 万的同一 Codex 代理,只是在不同终端中呈现。

插件对机器的要求

前提条件不多但很具体。你需要 Node.js 18.18.0 或更高版本——这是插件 package.json 中声明的硬性引擎约束(engines: ">=18.18.0"),而非建议值,因此旧版本运行时将拒绝安装。在账户方面,ChatGPT 订阅(免费层级即可)或 OpenAI API 密钥均可解锁 Codex。

身份验证是继承而非重新输入。如果你已在本地登录 Codex,插件会自动重用该状态——无需第二次登录。如果尚未安装 Codex,/codex:setup 可在存在 npm 时提供运行 npm install -g @openai/codex 的选项,或你可先手动运行该命令。

安装流程:从 marketplace 到 /codex:setup

官方完整路径是在活跃的 Claude Code 会话中运行四个斜杠命令,而非病毒式剪辑宣传的两个。按顺序执行:

  1. /plugin marketplace add openai/codex-plugin-cc — 在当前会话中注册 OpenAI 发布的 marketplace。Claude Code 将 marketplaces 视为在安装任何内容前需先添加的目录。
  2. /plugin install codex@openai-codex — 从该目录安装插件。注意命名:插件名为 codex,marketplace 为 openai-codex,因此引用写法为 codex@openai-codex
  3. /reload-plugins — 必须执行。跳过此步,/codex:* 技能将不会出现,codex:codex-rescue 子代理也将从 /agents 中缺失。
  4. /codex:setup — 检查 Codex 是否已安装并完成身份验证。如果 Codex 缺失且 npm 可用,它将提供运行 npm install -g @openai/codex 的选项;如果 Codex 已存在但未登录,它将提示你在 Claude Code 中运行 !codex login

在使用前请验证:一旦 /codex:setup 顺利完成,/codex:review 应有响应,且 codex:codex-rescue 子代理应在 /agents 中可见。如果任一缺失,请重新运行 /reload-plugins——跳过重载是最常见的导致命令界面无法出现的原因。

“两个命令”说法为何不完整

病毒式“两个命令,30 秒”的说法仅涵盖 marketplace 添加和插件安装——即步骤 1 和 2。跳过 /reload-plugins,插件虽已注册但处于休眠状态:其 /codex:* 斜杠命令不会加载到运行中的会话,因此看起来毫无作用。跳过 /codex:setup,插件将不会检查 Codex 是否已安装并完成身份验证——故障是静默的而非可读错误,这是最难排查的一类问题。

在使用前需注意两种行为:

  • 审查门控是可选的,原因自明。通过设置标志启用后,它使用 Claude Code 的 Stop 钩子在每次 Claude 响应时触发 Codex。OpenAI 和实践者警告,这可能引发持续的 Claude/Codex 循环,快速消耗使用额度——请将其视为可选功能,而非默认设置。
  • 计费保持独立。Codex 使用量计入 Codex 额度,Claude 使用量计入 Claude 额度。不存在共享配额,也无跨账户上下文——插件重用本地 Codex 身份验证,而非 Claude 的账户状态。

请保持更新。v1.0.6(2026 年 7 月 8 日发布)移除了 git 命令的 shell 扩展——这是对在仓库内执行 shell 操作的插件进行的正确性和安全性修复。早期版本存在 Windows 兼容性和应用服务器就绪的回归问题,因此请固定使用较新版本。

干净安装后的斜杠命令菜单

/codex:setup 完成后,插件会暴露一组聚焦的 /codex:* 斜杠命令,以及可在 /agents 中看到的 codex:codex-rescue 子代理。这是一个命令界面,而非通用编排运行时——每个命令都映射到针对本地检出的一个 Codex 操作。

命令 功能 关键标志
/codex:review 对未提交更改或分支差异进行只读 Codex 审查 --base--wait--background
/codex:adversarial-review 相同目标选择,但进行质疑设计决策和假设的怀疑性审查,而非仅检查错误 --base + 可选焦点文本
/codex:rescue 将调查或修复委托给 codex:codex-rescue 子代理 --modelsparkgpt-5.3-codex-spark)、--resume--fresh--effort
/codex:transfer 将活跃的 Claude Code 会话移交给持久的 Codex 线程以进行更长时间的委托(v1.0.5 新增)
/codex:status · /codex:result · /codex:cancel 管理后台作业

一个实用习惯:在使用阻塞性 --wait 之前,先运行后台作业并使用 /codex:status/codex:result 轮询结果,通过 /codex:cancel 取消——--wait 会占用终端直至 Codex 返回。具体要点:安装固定较新版本,运行一次 /codex:review 确认子代理响应,然后将审查命令集成到发布清单中——你现在可以在同一终端中实现 Claude 规划与 Codex 审查。

常见问题

使用 codex-plugin-cc 是否需要付费 OpenAI 方案?

不需要。ChatGPT 免费层级账户即可,OpenAI API 密钥同样有效。插件不维护自身凭证——它重用本地 Codex 安装已持有的任何身份验证。如果机器上已登录 Codex,该身份验证将自动获取;如果未登录,在 Claude Code 中运行一次 !codex login 即可。

Codex 插件是否共享我的 Claude 账户或计费?

不共享。Codex 使用量计入 Codex 额度,Claude 使用量计入 Claude 额度——不存在共享配额、无跨账户身份验证,也无关联计费。插件是一个便利的桥梁,调用本地安装的 Codex CLI 和应用服务器;它不会证明两个代理共享上下文、账户或权限。特别注意可选的“审查门控”,因为 Claude/Codex 循环可能快速消耗 Codex 额度。

为什么在步骤 2 后 /codex:* 命令没有出现?

你很可能只执行了两个安装命令而跳过了 /reload-plugins。添加 marketplace 并安装插件仅完成注册,但运行中的会话尚未加载新技能。运行 /reload-plugins,然后执行 /codex:setup/codex:* 斜杠命令及 codex:codex-rescue 子代理就会在 /agents 中显示。这就是为什么“两个命令”的说法实际上是四个。

/codex:review 与 /codex:adversarial-review 有什么区别?

/codex:review 对未提交更改或分支差异(相对于 main 等基础引用)运行标准的只读 Codex 检查,支持 --base--wait--background/codex:adversarial-review 运行可引导的怀疑性检查,主动质疑设计决策和假设,使用相同的目标选择并支持可选焦点文本。当你需要合并前第二意见而非常规变更摘要时,请使用对抗性检查。

codex-plugin-cc 是否等同于 Claude Code 的“OpenAI Developers”插件?

不是。openai/openai-developers-for-claude 是一个独立的插件,捆绑了 Docs MCP 服务器和 API 设置技能,而 openai/codex-plugin-cc 暴露的是 Codex 编码代理本身。它们位于不同仓库,服务于不同目的;安装其中一个不会获得另一个。如果你的目标是代码审查和任务委托,codex-plugin-cc 才是你需要的。

观看 / 来源