Claude Code 的 Codex 插件

在 Claude Code 中调用 Codex,审查代码或委派开发任务。

Star 数
★ 34k
最近更新
3 个月前
License
Apache-2.0
主语言
JavaScript

30 秒速览

运行形态
Agent 插件 / 技能
可在哪里用
平台专用Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
低 · 几分钟可跑通
开始前需要
Node.js 18.18 或更高版本Codex CLIShell / 命令行网络访问本地文件系统
典型场景
使用 Claude Code 的开发者想对未提交改动或相对 main 的分支变更做只读 Codex 审查。
不适合
  • 不使用 Claude Code 的开发者
  • 无法接受代码交由 Codex 审查或处理的团队

这个 Agent 能做什么,适合哪些场景?

这是一个面向 Claude Code 用户的插件,可从现有工作流中调用本机 Codex CLI 和 Codex app server。它提供常规只读审查、可指定关注点的对抗式审查,以及将任务交给 Codex 子代理处理的命令。长任务可在后台运行,并通过状态、结果和取消命令管理。插件还可把当前 Claude Code 会话导入为持久的 Codex 线程,以便在 Codex 中继续。运行需要 Node.js 18.18 或更高版本,以及已安装并完成认证的 Codex;使用量计入 Codex 限额。

在 Claude Code 中安装后,/codex:setup 检查 Codex CLI 的安装和认证状态;如缺少 Codex 且可用 npm,可提供安装选项。/codex:review 针对当前未提交更改或指定基准分支执行只读审查,/codex:adversarial-review 还可接收额外关注点。/codex:rescue 将调查、修复或后续任务交给 codex:codex-rescue 子代理,可选择后台运行、恢复旧任务或开启新任务。用户可用 /codex:status、/codex:result 和 /codex:cancel 管理后台任务;/codex:transfer 则导入当前 Claude 会话并给出 codex resume <session-id> 命令。

  1. 使用 Claude Code 的开发者想对未提交改动或相对 main 的分支变更做只读 Codex 审查。
  2. 准备发布的工程师想让审查重点挑战某项设计选择、权衡或风险。
  3. 遇到构建失败或回归的开发者想把调查或修复任务交给 Codex 子代理。
  4. 需要运行耗时审查或调查的用户想在后台启动任务,再查看状态与最终结果。
  5. 已在 Claude Code 中开始调试的用户想把会话上下文转入 Codex,继续处理同一问题。

如何安装或部署这个 Agent?

需要 ChatGPT 订阅(包括 Free)或 OpenAI API key,以及 Node.js 18.18 或更高版本。先在 Claude Code 添加市场并安装插件:

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

然后检查 Codex 是否就绪:

/codex:setup

若要自行安装 Codex,可运行:

npm install -g @openai/codex

如果 Codex 已安装但尚未登录,可运行:

!codex login

如何使用这个 Agent?

从当前工作开始,只读审查:

/codex:review

审查相对基准分支的改动,或在后台运行审查:

/codex:review --base main
/codex:review --background

委派调查任务并检查后台进度与结果:

/codex:rescue --background investigate why the build is failing in CI
/codex:status
/codex:result

针对设计决策开展可引导审查:

/codex:adversarial-review --base main challenge whether this was the right caching and retry design

要转移当前 Claude Code 会话,可运行 /codex:transfer;完成后按输出使用 codex resume <session-id> 在 Codex 中继续。

这个 Agent 有哪些优点和局限?

优点
  • 把只读审查和任务委派命令直接集成到 Claude Code 工作流中。
  • 对抗式审查可附加关注文本,针对设计取舍和指定风险提问。
  • 长任务支持后台运行,并提供状态、结果和取消命令。
  • 使用本机 Codex CLI、认证状态、配置和仓库环境,结果可用 Codex 恢复命令继续。
局限
  • 需要 Claude Code、Node.js 18.18 或更高版本,以及本机安装并认证的 Codex CLI。
  • 必须使用 ChatGPT 订阅或 OpenAI API key,相关使用量计入 Codex 限额。
  • 插件依赖 Codex 与 Claude Code;README 未说明其他宿主或模型提供方的原生支持。
  • 可选审查门可能形成耗时循环并快速消耗使用限额。

这个 Agent 与同类方案有什么区别?

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Claude Code 的 Codex 插件 当前 63 · 存在缺口 Agent 插件 / 技能免费 + 模型费 ★ 34k 3 个月前 JavaScript Codex · Claude Code
GStack 工程工作流 80 · 表现良好 Agent 插件 / 技能免费 + 模型费 ★ 137k 今天 TypeScript Claude Code
Claudexor 76 · 表现良好 命令行工具免费 + 模型费 ★ 515 今天 TypeScript Codex · Claude Code
Pilot Shell 53 · 缺口较多 命令行工具付费 ★ 2.1k 今天 JavaScript Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
63/ 100 五分制 3.2 / 5
信任安全 18/29
可靠稳定 8/14
适用触发 12/18
规范维护 14/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

README 将普通审查和对抗式审查描述为只读,并提供后台任务状态、结果和取消命令;修复工作通过 rescue 委派,Codex 安装也由 setup 提供选项,说明权限与副作用有一定边界。README 说明使用本机 Codex CLI、认证状态、配置和仓库环境,也说明会消耗 Codex 使用额度;但没有说明敏感内容处理、保留或传输细节,也未给出恢复被委派修改的具体机制,因此这些方面扣分。来源归属有明确仓库名和给定的官方组织出处,但没有具体维护者信息。

可靠稳定8 / 14 · 2.9/5

README 对命令用途、只读审查、后台作业和本机 CLI 的描述整体一致,package.json 与 CI 文件也表明有测试和构建流程。依赖可用性部分依赖用户安装的 Codex CLI、登录状态、Node.js 版本和网络服务;CI 安装 CLI 时没有固定版本。README 提供 setup 检查,但没有足够证据说明各类运行失败会给出什么诊断,因此失败消息得分较低。

适用触发12 / 18 · 3.3/5

目标用户和场景较清楚:在 Claude Code 中审查代码、质疑设计或委派任务。命令说明区分只读审查与可尝试修复的 rescue,也区分后台运行与等待;这支持一般边界判断。触发方式主要是用户显式调用命令,另有可选 Stop 审查门。适配性受到 Claude Code、Node.js、本机 Codex 安装与认证要求限制,未展示更广泛环境支持。

规范维护14 / 18 · 3.9/5

README 按安装、命令、典型流程、配置和 FAQ 组织,安装步骤、前置要求和大量示例较完整。命令名和功能映射清楚,但没有足够材料证明长期命名稳定性。文档说明旧版 Codex 可能需升级、长任务可能耗时、审查门可能形成循环并消耗额度等限制;LICENSE 和 package.json 明确 Apache-2.0。package.json 有版本号和版本检查脚本,但给定材料没有变更日志。给定的 OpenAI 官方组织出处支持归属判断,但没有明确的维护责任人或更新承诺。

有效结果7 / 13 · 2.7/5

插件把 Codex 审查、任务委派、会话转移和后台作业管理接入 Claude Code,并能查看存储结果及恢复会话,提供了可操作的输出路径。其额外价值主要来自跨工具工作流整合;源材料没有提供用户结果或比较证据,无法证明效果提升幅度。文档提醒会消耗 Codex 额度,且审查门可能长时间运行,但没有具体成本估算,因此成本效益只部分得到说明。

证据核验4 / 8 · 2.5/5

主要使用说明可在 README 中按命令和流程追溯;package.json 与 CI 配置对版本、运行时要求和自动化流程提供有限交叉支持。给定材料没有提供实现源码、测试内容或变更记录,因而跨来源佐证较弱。README 对功能和要求作出明确陈述,但本静态审查无法独立确认运行行为;评分未将这些未验证陈述当作运行证据。

风险与缓解建议
  • 委派任务可能尝试修改代码;使用 rescue 前应确认 Codex 任务范围,并在需要时检查其更改。
证据充分度:低 评估于 2026年10月21日 审查版本 db52e28f4d9d
查看完整评分方法 →

常见问题

使用插件需要单独的 Codex 账号吗?
不需要另建账号。如果本机已登录 Codex,可直接使用现有认证;否则可使用 ChatGPT 账号或 API key 登录。
插件会使用独立的 Codex 运行环境吗?
不会。它通过同一台机器上的本地 Codex CLI 和 Codex app server 工作,并沿用本机认证、配置、仓库检出和环境。
代码审查命令会修改文件吗?
/codex:review 和 /codex:adversarial-review 是只读审查,不会修复代码。/codex:rescue 可受托调查或尝试修复任务。
启用 review gate 有什么影响?
启用后,Stop hook 会根据 Claude 的回复运行定向 Codex 审查;若发现问题,会阻止 Claude 停止,以便先处理问题。它可能造成长时间循环并快速消耗使用限额。
会话转移有什么要求?
/codex:transfer 使用 Codex 的外部代理会话导入功能;来源必须位于 ~/.claude/projects。不支持会话导入的旧版 Codex 需要先升级。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents