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 审查代码” | 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
这四步各自完成不同工作,不能压缩成一句“安装成功”:
/plugin marketplace add openai/codex-plugin-cc注册 OpenAI 提供的 marketplace 来源。/plugin install codex@openai-codex从已添加的来源安装具体插件。/reload-plugins让当前 Claude Code 会话重新加载插件。/codex:setup进入插件提供的设置流程,检查本机 Codex 条件。
“OpenAI 维护这个仓库”不等于它被收录进 Anthropic 的官方 marketplace。Anthropic 的插件文档也把注册 marketplace 与安装单个插件写成两个步骤,并提醒用户:插件和 marketplace 都属于高信任组件,可能以用户权限运行代码。安装前应核对来源,尤其不要把来源相似的第三方仓库当成官方项目。
如果某一步失败,先记录失败发生在哪一条命令,再分别核对地区与账号资格、Node.js、Claude Code 版本、Codex CLI 安装与认证、网络以及工作区政策。由于目前没有最低 Claude Code 版本和跨环境实测证据,遇到报错时不宜直接归因于“插件失效”,也不应照抄旧教程降级命令。
审查、挑战式审查与委派,不是同一种权限
README 的用法说明把 /codex:review 与 /codex:adversarial-review 描述为只读审查动作;rescue、transfer 以及后台任务管理则属于委派、会话移交和任务控制范围。选择命令时,关键不是哪个名字更强,而是你是否愿意让 Codex 从“给建议”进入“接手工作”。
| 目标 | 相关命令 | 应如何理解权限 |
|---|---|---|
| 请 Codex 检查当前代码 | /codex:review | README 标注为只读审查,适合先获得第二视角 |
| 要求更刻意地寻找反例或缺陷 | /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。
对中国大陆读者,决定仍发生在安装命令之前:截至本文核对日期,两家公司的公开支持地区列表都没有列出中国大陆,且没有单独的插件地区矩阵。先重新查看当前官方页面并核对自己的真实账号条件;条件不成立,就在这里停下,不要让一篇安装教程替你做合规判断。



