跳转到主要内容
AI 开发工具

Claude Code 的 Codex 插件如何安装:先查地区,再选审查或委派

复制命令前先确认地区、账号与本机 Codex 条件;满足要求后,再按权限选择只读审查、任务委派或会话移交。

12 分钟阅读
Claude Code 通过 codex-plugin-cc 连接本机 Codex 的工作流示意图

codex-plugin-cc 是 OpenAI 维护的 Claude Code 插件:它让 Claude Code 在当前工作流中调用本机的 Codex做代码审查或接手任务。它不是 VS Code 扩展,不是 MCP 配置,也不会把 Claude Code 的底层模型替换成 Codex。

如果你人在中国大陆,先不要把“ChatGPT Free 也在要求列表里”理解成当地可注册、可登录或一定能安装。截至 2026 年 8 月 15 日,OpenAI 的 ChatGPT 支持国家和地区列表Anthropic 的支持地区页面均未列出中国大陆;两家公司也没有在这些页面中给出一份单独的 codex-plugin-cc 地区兼容矩阵。你需要按自己当前所在地区、账号和工作区政策核对资格,不应通过绕过地区限制来尝试使用。

如果地区、账号与本机条件都满足,再按官方文档依次添加 marketplace、安装插件、重载插件并运行设置。之后先从只读审查开始;只有明确允许 Codex 接手工作时,才使用委派或会话移交。本文给出的是可核对的官方流程,不代表已在你的系统和账号上实测成功。

先确认:你找的是哪条调用路线

这款插件的方向是:

Claude Code → codex-plugin-cc → 本机 Codex app server / 全局安装的 Codex CLI

OpenAI 仓库说明,插件会使用本机的 Codex CLI,并复用相同的认证、当前仓库、机器环境和 Codex 配置。因此,它不是一个独立沙盒,也不会替你绕过本机已有的信任设置、权限、自定义 provider 配置或使用限额。

插件调用链示意:Claude Code 通过 codex-plugin-cc 连接本机 Codex app server 与 Codex CLI

下面几类常见搜索结果不是同一件事:

你看到的说法实际路线是否属于本文插件
“在 Claude Code 中用 Codex 审查代码”Claude Code 调用本机 Codex
“给 VS Code 安装 Claude/Codex 扩展”编辑器扩展
“把 Codex 配成 MCP”MCP 服务或工具接入不是官方 README 给出的安装路线
“在 Codex 中调用 Claude Code”反向调用或其他项目
“把 Codex 模型装进 Claude Code”容易误解成替换底层模型不是插件的准确工作方式

认准仓库 openai/codex-plugin-cc 和插件标识 codex@openai-codex,可以避开名称相近的教程与旧命令。

复制命令前,先过三道条件检查

1. 地区与账号资格

插件同时依赖 Claude Code 与 Codex 所需的账号或 API 条件。对中国大陆读者,公开支持地区列表是第一道停止线:如果当前所在地或账号资格不在官方支持范围内,就停在这里,不要用第三方镜像、借用账号或规避地区政策继续安装。

这里也不能从支持列表反推出“插件在所有已支持地区都一定可用”。Claude Code 插件的具体可用性还会受到账号、组织和 workspace 政策影响,公开产品页无法替你确认这些状态。

2. Codex 资格与剩余额度

插件要求列出两种 Codex 认证来源:包含 Codex 的 ChatGPT 订阅(README 当前也提到 Free),或者 OpenAI API key。插件执行会计入 Codex 使用限额。

“计划名称出现在文档里”不等于你的账号在当地可注册、仍有额度,或这次任务免费。OpenAI 的 Codex 定价说明列出 Free、Go、Plus、Pro、Business、Edu、Enterprise 与 API key 路线,但实际可用量会随计划、模型、任务复杂度、上下文和工作区条件变化。Claude Code 自身成本、Codex 消耗、税费与当地最终价格也不能合并成一个对所有人有效的固定数字。

3. 本机运行条件

当前 README 明确要求 Node.js 18.18 或更高版本。你还需要已能使用 Claude Code,以及全局安装并完成相应认证的 Codex CLI,因为插件最终调用的就是这套本机 Codex 环境。

官方 README 没有写出 codex-plugin-cc 所需的最低 Claude Code 版本。本次也没有在任何操作系统、Claude Code 版本、Node.js 环境、网络、认证状态或自定义 Codex provider 上执行安装。因此,本文可以给出官方合同和检查点,但不能承诺你的环境一次安装成功。

官方安装顺序:四条命令分别做什么

在 Claude Code 内,OpenAI 当前 README给出的顺序是:

text
/plugin marketplace add openai/codex-plugin-cc /plugin install codex@openai-codex /reload-plugins /codex:setup

这四步各自完成不同工作,不能压缩成一句“安装成功”:

  1. /plugin marketplace add openai/codex-plugin-cc 注册 OpenAI 提供的 marketplace 来源。
  2. /plugin install codex@openai-codex 从已添加的来源安装具体插件。
  3. /reload-plugins 让当前 Claude Code 会话重新加载插件。
  4. /codex:setup 进入插件提供的设置流程,检查本机 Codex 条件。

“OpenAI 维护这个仓库”不等于它被收录进 Anthropic 的官方 marketplace。Anthropic 的插件文档也把注册 marketplace 与安装单个插件写成两个步骤,并提醒用户:插件和 marketplace 都属于高信任组件,可能以用户权限运行代码。安装前应核对来源,尤其不要把来源相似的第三方仓库当成官方项目。

如果某一步失败,先记录失败发生在哪一条命令,再分别核对地区与账号资格、Node.js、Claude Code 版本、Codex CLI 安装与认证、网络以及工作区政策。由于目前没有最低 Claude Code 版本和跨环境实测证据,遇到报错时不宜直接归因于“插件失效”,也不应照抄旧教程降级命令。

审查、挑战式审查与委派,不是同一种权限

README 的用法说明/codex:review/codex:adversarial-review 描述为只读审查动作;rescuetransfer 以及后台任务管理则属于委派、会话移交和任务控制范围。选择命令时,关键不是哪个名字更强,而是你是否愿意让 Codex 从“给建议”进入“接手工作”。

目标相关命令应如何理解权限
请 Codex 检查当前代码/codex:reviewREADME 标注为只读审查,适合先获得第二视角
要求更刻意地寻找反例或缺陷/codex:adversarial-review同样是文档标注的只读审查,但审查取向不同
把卡住的工作交给 Codex 处理/codex:rescue属于任务委派,不要沿用“审查一定只读”的假设
把当前会话工作移交给 Codex/codex:transfer属于会话移交,应在发送前检查任务、上下文和权限
查看、取得或取消后台任务/codex:status/codex:result/codex:cancel用于管理已经启动的后台工作,不代表任务本身只读

命令权限分层示意:只读审查、任务委派、会话移交与后台任务

这里的“只读”仅适用于 README 明确这样描述的审查动作,不能扩展到插件的每一种命令。插件复用当前仓库、机器环境与 Codex 配置;委派前应像直接运行本机 Codex 一样检查工作区是否有未提交改动、允许修改哪些文件、可执行哪些命令,以及是否需要人工确认。

本次没有实际运行这些命令,无法用运行结果证明它们在你的版本和配置中表现完全一致。第一次使用时,更稳妥的顺序是从范围明确的只读审查开始,确认来源、输出和额度变化,再决定是否交出写入型任务。

会话移交和后台任务,解决的是上下文与等待问题

transfer 允许把当前工作移交给 Codex;后台任务相关命令让你查询状态、取得结果或取消工作。它们适合处理需要等待的任务,但也更容易让人忘记任务仍在消耗限额,或忽略工作区已经发生变化。

开始委派前,至少把以下边界写进任务:

  • 要完成的具体结果,而不是笼统地“优化代码”;
  • 允许读取和修改的目录;
  • 是否允许执行测试、安装依赖或访问网络;
  • 遇到权限、失败或不确定事实时应停止还是继续;
  • 返回时需要报告哪些文件变化和验证结果。

这些边界不是插件替你自动保证的。由于它使用本机 Codex 配置,已有的审批策略、自定义 provider、仓库状态和机器权限都会影响实际行为。

review gate 只适合有人持续看守的会话

插件还提供可选的 review gate。OpenAI 在相关说明中明确警告,它可能让 Claude 与 Codex 形成长时间循环,并迅速消耗使用限额;只应在你会主动监控会话时启用。

官方资料没有给出固定的循环时长或额度消耗,因为它们取决于模型、上下文、任务复杂度和发现的问题。不要把 review gate 当成“打开后自动提高质量”的免费开关。更实际的判断是:只有当本次任务值得多轮反馈、你能及时停止循环、并且已经确认剩余额度时,才考虑启用。

第一次使用,把成功标准缩到一次可逆验证

即使插件成功加载,也还不能证明:

  • 兼容性已普遍验证。 当前没有最低 Claude Code 版本说明,也没有覆盖不同系统、Node.js、网络和自定义 provider 的本地复现结果。
  • 账号和费用已确定。 公开页面无法看到你的地区资格、workspace 权限、剩余 Codex 使用量、当地税费或 Claude Code 与 Codex 的合计成本。
  • 代码质量一定提升。 官方资料说明了能力和工作方式,但没有为你的仓库、模型、提示与任务提供可复现的胜率、速度或质量结论。

第一次采用这款插件时,不必追求“一次把 Claude Code 和 Codex 全自动串起来”。更可靠的成功标准是完成一个小而可逆的验证:确认官方来源;核对地区、账号与工作区条件;完成四步安装;再对范围明确的代码请求一次只读审查。只有当输出、权限和额度都符合预期,才进入委派、会话移交或 review gate。

对中国大陆读者,决定仍发生在安装命令之前:截至本文核对日期,两家公司的公开支持地区列表都没有列出中国大陆,且没有单独的插件地区矩阵。先重新查看当前官方页面并核对自己的真实账号条件;条件不成立,就在这里停下,不要让一篇安装教程替你做合规判断。

#Claude Code#Codex#开发工具
分享文章: