乐于分享
好东西不私藏
当前位置：夜雨聆风 > 技术教程 > 软件教程 > Codex 插件来了:在 Claude Code 里直接调用 Codex 进行 CodeReview

Codex 插件来了:在 Claude Code 里直接调用 Codex 进行 CodeReview

当前时间： 2026-04-06 18:42:12 更新时间： 2026-04-06 分类：软件教程 评论(0)

Codex 插件来了:在 Claude Code 里直接调用 Codex 进行 CodeReview

如果你已经在用 Claude Code，这个 Codex 插件可以帮你把 Codex 无缝接入现有的工作流，不需要在两个工具之间来回切换。插件地址：https://github.com/openai/codex-plugin-cc

它主要做三件事：

  • 常规代码审查——和在 Codex 里直接跑 /review 一样

  • 对抗性审查（Adversarial Review）——不只是检查代码细节，而是质疑你的设计决策和隐含假设

  • 任务委派——把问题交给 Codex，让另一个智能体接手

前置条件

  • ChatGPT 订阅（包括免费版），或者一个 OpenAI API 密钥

  • 使用会计入你的 Codex 用量上限

  • Node.js 18.18 或更高版本

安装

在 Claude Code 中添加插件市场并安装：

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

然后运行初始化：

/codex:setup

/codex:setup 会检查 Codex 是否已经就绪。如果本机没有安装 Codex 且有 npm 环境，它会提示你自动安装。

如果你想手动安装：

npm install -g @openai/codex

如果 Codex 已安装但未登录：

!codex login

安装完成后你应该能看到下面列出的斜杠命令，以及 /agents 中出现的 codex:codex-rescue 子智能体。

核心命令详解

/codex:review——标准代码审查

运行一次常规的 Codex 只读审查，效果和在 Codex 内部直接跑 /review 一样。

适合这些场景：

  • 审查当前未提交的改动

  • 审查当前分支与 main 等基线分支的差异

/codex:review                    # 审查当前改动/codex:review --base main        # 审查整个分支/codex:review --background# 后台运行

提示：多文件变更的审查可能耗时较长，建议加 --background 在后台运行。

这个命令是只读的，不会修改任何代码。它不支持自定义关注点——如果你想针对特定风险区域做审查，用下面的对抗性审查。

/codex:adversarial-review——对抗性审查

这是这个插件最有价值的命令。它不只是检查代码有没有写错，而是质疑你的实现方向——设计权衡、隐含假设、失败模式，以及”换一种方案是不是更安全”。

/codex:adversarial-review/codex:adversarial-review --base main challenge whether this was the right caching and retry design/codex:adversarial-review --backgroundlookfor race conditions and question the chosen approach

和 /codex:review 一样支持 --base、--wait、--background，但额外支持在参数后面加自由文本来引导审查方向。

特别适合这些场景：

  • 发布前的最终审查——挑战方向，而不只是检查细节

  • 设计决策审查——权衡、隐含假设、替代方案

  • 高风险区域压力测试——认证逻辑、数据丢失、回滚策略、竞态条件、可靠性

对抗性审查在数据库迁移、认证变更、基础设施脚本、大规模重构这些场景下特别好用——凡是隐患藏在隐含假设里而非明显语法错误中的地方。

/codex:rescue——任务委派

把一个任务直接交给 Codex 处理，通过 codex:codex-rescue 子智能体执行。

/codex:rescue investigate why the tests started failing/codex:rescue fix the failing test with the smallest safe patch/codex:rescue --resume apply the top fix from the last run/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky integration test/codex:rescue --model spark fix the issue quickly/codex:rescue --background investigate the regression

适合的场景：

  • 让 Codex 调查一个 bug

  • 让 Codex 尝试修复

  • 继续上一次 Codex 的任务（--resume）

  • 用更小的模型快速过一遍（--model spark 会映射为 gpt-5.3-codex-spark）

提示：根据任务复杂度和模型选择，执行可能耗时较长，建议加 --background 或在运行中将智能体移至后台。

如果不传 --resume 也不传 --fresh，插件会提示你是否要继续这个仓库上次的 rescue 线程。

你也可以用自然语言直接请求委派：

Ask Codex to redesign the database connection to be more resilient.

/codex:status、/codex:result、/codex:cancel——任务管理

/codex:status                # 查看当前仓库的运行中和最近的任务/codex:status task-abc123    # 查看特定任务/codex:result                # 查看最近完成的任务结果/codex:result task-abc123    # 查看特定任务结果（含 session ID）/codex:cancel                # 取消当前后台任务/codex:cancel task-abc123    # 取消特定任务

/codex:result 返回的结果中会包含 Codex session ID，你可以用 codex resume <session-id> 在 Codex 中直接恢复该会话。

推荐工作流

日常审查——所有代码改动都跑一遍 /codex:review：

/codex:review

发布前深度检查——高风险部分加一轮对抗性审查：

/codex:adversarial-review --base main

委派调查任务——遇到问题丢给 Codex：

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

一个好用的默认模式：

  1. /codex:review 跑所有改动

  2. /codex:adversarial-review 跑高风险部分

  3. /codex:rescue 处理卡住的线程或需要 Codex 接手的场景

工作原理

插件通过本地的 Codex CLI 和 Codex 应用服务器来执行操作。它复用的是你在 Codex 中已有的：

  • 本地认证状态

  • 仓库检出和本机环境

  • 配置文件

  • MCP 设置

这也是它用起来很轻量的原因——它不是一个独立的运行时，就是 Codex 本身，只不过从 Claude Code 内部发起调用。

自定义配置

如果你想修改插件使用的默认模型或推理力度，可以在 Codex 的配置文件中设置。

比如，要让某个项目始终使用 gpt-5.4-mini 并开启高推理力度，在项目根目录创建 .codex/config.toml：

model="gpt-5.4-mini"model_reasoning_effort="xhigh"

配置加载顺序：

  1. 用户级：~/.codex/config.toml

  2. 项目级：.codex/config.toml（项目需被标记为可信）

项目级配置会覆盖用户级。

可选：审查门禁

你还可以开启审查门禁（Review Gate）：

/codex:setup --enable-review-gate/codex:setup --disable-review-gate

开启后，插件会通过 Stop Hook 在 Claude Code 结束响应前自动触发一次 Codex 审查。如果审查发现问题，会阻止 Claude 退出，让它先解决问题。

注意：审查门禁可能导致 Claude 和 Codex 之间的长时间循环调用，快速消耗用量配额。只在你打算主动监控会话时开启。

与 Codex 的互操作

通过 /codex:result 或 /codex:status 获取到的 session ID，可以直接在 Codex 中恢复：

codex resume <session-id>

这意味着你可以在 Claude Code 中发起任务，然后在 Codex 中继续审查或推进工作。两个工具之间的切换是无缝的。

常见问题

需要单独的 Codex 账号吗？

不需要。如果你已经在本机登录过 Codex，插件会直接复用已有的认证。如果你是第一次用 Codex，需要先 codex login 登录一个 ChatGPT 账号或 API 密钥。

插件会使用独立的 Codex 运行时吗？

不会。插件通过你本地安装的 Codex CLI 执行，共享同一套安装、认证、环境和仓库上下文。

已有的 Codex 配置会生效吗？

会。插件读取的是同一套 Codex 配置文件，包括用户级和项目级的 config.toml。

可以用自定义的 API endpoint 吗？

可以。因为插件走的是本地 Codex CLI，你已有的 API 密钥和 endpoint 设置都会生效。如果需要修改内置 OpenAI provider 的地址，在 Codex 配置中设置 openai_base_url。

总结

这个插件的核心价值很明确：不用离开 Claude Code，就能拿到另一个 AI 智能体的独立审查。

装好插件，跑一下 /codex:setup，把 /codex:review 当作默认的二次审查手段。遇到需要挑战设计决策的场景，用 /codex:adversarial-review。需要 Codex 接手具体任务时，用 /codex:rescue。

这不是要替换 Claude Code 或 Codex 中的任何一个，而是让两个工具各自做擅长的事——在同一个终端窗口里。

插件地址：https://github.com/openai/codex-plugin-cc