GitHub - openai/codex-plugin-cc: 使用 Claude Code 中的 Codex 来进行代码审查或委派任务。

Claude Code 的 Codex 插件

在 Claude Code 内部使用 Codex 进行代码审查，或将任务委托给 Codex 执行。

本插件面向 Claude Code 用户，让他们能够在已有的工作流中轻松开始使用 Codex。

功能概览

• /codex:review 用于普通只读 Codex 审查
• /codex:adversarial-review 用于可引导式挑战性审查
• /codex:rescue、/codex:transfer、/codex:status、/codex:result 和 /codex:cancel 用于委托任务、移交会话以及管理后台作业

环境要求

• 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 可用，它会提示您是否需要自动安装 Codex。

如果您希望自行安装 Codex，请使用：

npm install -g @openai/codex

如果 Codex 已安装但尚未登录，请运行：

! codex login

安装完成后，您应当看到：

• 下方列出的斜杠命令
• /agents 中的 codex:codex-rescue 子 Agent

一个简单的初次使用示例：

/codex:review --background /codex:status /codex:result

使用方法

/codex:review

对您当前的工作运行普通 Codex 审查。其审查质量与在 Codex 内部直接运行 /review 相同。

注意 代码审查（尤其是涉及多文件变更时）可能需要较长时间。通常建议在后台运行。

适用场景：

• 审查当前未提交的变更
• 将当前分支与 main 等基础分支进行对比审查

使用 --base 进行分支审查，同时支持 --wait 和 --background。该命令不可引导，也不支持自定义焦点文本。若您想针对某个具体决策或风险领域提出质疑，请使用 /codex:adversarial-review。

示例：

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

此命令为只读操作，不会执行任何更改。在后台运行时，可使用 /codex:status 查看进度，使用 /codex:cancel 取消正在进行的任务。

/codex:adversarial-review

运行可引导的审查，对所选实现方案和设计提出质疑。

可用于压力测试假设前提、权衡取舍、故障模式，以及评估是否存在更安全或更简洁的替代方案。

使用与 /codex:review 相同的审查目标选择方式，包括使用 --base 进行分支审查，同时支持 --wait 和 --background。与 /codex:review 不同，它可以在标志参数之后接受额外的焦点文本。

适用场景：

• 上线前审查，挑战整体方向，而不仅仅关注代码细节
• 聚焦于设计选择、权衡取舍、隐藏假设以及替代方案的审查
• 针对鉴权、数据丢失、回滚、竞态条件或可靠性等特定风险领域进行压力测试

示例：

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

此命令为只读操作，不会修复代码。

/codex:rescue

通过 codex:codex-rescue 子 Agent 将任务移交给 Codex。

适用于让 Codex 执行以下操作：

• 排查 Bug
• 尝试修复
• 继续之前的 Codex 任务
• 使用更小的模型进行更快速或更经济的处理

注意 根据任务和所选模型的不同，这些任务可能需要较长时间。通常建议强制将任务置于后台运行，或将 Agent 移至后台。

支持 --background、--wait、--resume 和 --fresh。如果省略 --resume 和 --fresh，插件可以提示您是否继续该仓库最近一次的 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：

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

说明：

• 如果不传入 --model 或 --effort，Codex 将自行选择默认值。
• 如果您输入 spark，插件会将其映射为 gpt-5.3-codex-spark。
• 后续的 rescue 请求可以继续该仓库中最新的 Codex 任务。

/codex:transfer

从当前 Claude Code 会话创建一个持久化的 Codex 线程，并打印一条 codex resume 命令。

适用于：您在 Claude Code 中开始了调试或实现方面的对话，并希望直接在 Codex 中以相同的上下文继续。

示例：

/codex:transfer /codex:transfer --source ~ /.claude/projects/-Users-me-repo/ .jsonl

插件现有的 SessionStart 钩子会自动提供当前会话记录的路径；--source 可作为手动覆盖选项使用。该移交操作使用 Codex 的外部 Agent 会话导入功能，因此遵循与在 Codex App 中导入 Claude 历史记录相同的转换规则，并创建可在 App 或 TUI 中继续的可见对话轮次。来源必须位于 ~/.claude/projects 下，且不暴露会话导入接口的旧版 Codex 必须升级后方可使用此命令。

/codex:status

显示当前仓库正在运行及最近完成的 Codex 作业。

示例：

/codex:status /codex:status task-abc123

适用于：

• 查看后台任务的进度
• 查看最近已完成的作业
• 确认某个任务是否仍在运行

/codex:result

显示已完成作业的最终存储输出。如果可用，还会包含 Codex 会话 ID，供您通过 codex resume 直接在 Codex 中重新打开该次运行。

示例：

/codex:result /codex:result task-abc123

/codex:cancel

取消正在进行的后台 Codex 作业。

示例：

/codex:cancel /codex:cancel task-abc123

/codex:setup

检查 Codex 是否已安装并完成身份验证。如果 Codex 缺失且 npm 可用，它可以提示您是否自动安装 Codex。

您也可以使用 /codex:setup 来管理可选的审查门控。

启用审查门控

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

启用审查门控后，插件会使用 Stop 钩子，根据 Claude 的响应运行有针对性的 Codex 审查。如果该审查发现问题，则会阻止停止操作，以便 Claude 优先处理这些问题。

警告 审查门控可能会引发持续运行的 Claude/Codex 循环，并可能迅速耗尽用量限额。请仅在您计划主动监控会话时启用此功能。

典型工作流

上线前审查

/codex:review

将问题交给 Codex 处理

/codex:rescue investigate why the build is failing in CI

启动长时间运行的任务

/codex:adversarial-review --background /codex:rescue --background investigate the flaky test

然后通过以下方式查看进度：

/codex:status /codex:result

Codex 集成

Codex 插件封装了 Codex 应用服务器。它使用您环境中全局安装的 codex 二进制文件，并应用相同的配置。

常见配置

如果您希望更改插件默认使用的推理力度或默认模型，可以在用户级或项目级的 config.toml 中进行定义。例如，若要在某个特定项目中始终在 high 上使用 gpt-5.4-mini，可在您启动 Claude 的目录根路径下，将以下内容添加到 .codex/config.toml 文件中：

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

您的配置将按以下规则生效：

• 用户级配置位于 ~/.codex/config.toml
• 项目级覆盖配置位于 .codex/config.toml
• 项目级覆盖配置仅在项目受信任时才会加载

请查阅 Codex 文档以了解更多配置选项。

将工作迁移至 Codex

委托任务和任何停止门控运行也可以直接在 Codex 中恢复，方法是运行 codex resume，并传入通过 /codex:result 或 /codex:status 获取的具体会话 ID，或从列表中选择。

这样您就可以在 Codex 中查看或继续相关工作。

常见问题

使用本插件是否需要单独的 Codex 账号？

如果您已在本机登录 Codex，该账号在此处也可直接使用。本插件使用您本地 Codex CLI 的身份验证信息。

如果您目前仅使用 Claude Code 而尚未使用过 Codex，则还需要使用 ChatGPT 账号或 API 密钥登录 Codex。Codex 可通过您的 ChatGPT 订阅使用，codex login 同时支持 ChatGPT 和 API 密钥登录方式。运行 /codex:setup 检查 Codex 是否已就绪，如果尚未就绪，请使用 !codex login。

插件是否使用独立的 Codex 运行时？

不。本插件通过同一台机器上的本地 Codex CLI 和 Codex 应用服务器 进行委托。

这意味着：

• 它使用与您直接使用时相同的 Codex 安装
• 它使用相同的本地身份验证状态
• 它使用相同的仓库检出和机器本地环境

插件是否会使用我已有的 Codex 配置？

会。如果您已在使用 Codex，插件会读取相同的配置。

我能继续使用现有的 API 密钥或自定义 base URL 配置吗？

可以。由于插件使用您本地的 Codex CLI，您现有的登录方式和配置仍然适用。

如果您需要将内置 OpenAI 提供商指向不同的端点，请在您的 Codex 配置中设置 openai_base_url。