openai/codex-plugin-cc

来源：https://github.com/openai/codex-plugin-cc

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 使用限制。了解更多信息 (https://developers.openai.com/codex/pricing)。
• 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 子代理

一个简单的首次运行示例：

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

使用方法

/codex:review

对您当前的工作运行常规 Codex 审查。其审查质量与直接在 Codex 中运行 /review 相同。

代码审查，尤其是跨多个文件的更改，可能需要一些时间。通常建议在后台运行。

适用于以下场景：

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

使用 --base <branch> 进行分支审查。同时支持 --wait 和 --background。该命令不可引导，也不接受自定义焦点文本。当您需要质疑特定决策或风险领域时，请使用 /codex:adversarial-review。

示例：

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

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

/codex:adversarial-review

运行可引导的审查，质疑所选实现和设计。可用于压力测试假设、权衡、故障模式，以及探讨是否其他方法更安全或更简单。

它与 /codex:review 使用相同的审查目标选择方式，包括 --base <branch> 进行分支审查。同时支持 --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 子代理将任务交给 Codex。适用于以下场景：

• 调查 Bug
• 尝试修复
• 继续之前的 Codex 任务
• 使用更小模型进行更快、更便宜的尝试

根据任务和所选模型，这些任务可能需要较长时间，通常建议强制任务在后台运行或将代理移至后台。

支持 --background、--wait、--resume 和 --fresh。如果省略 --resume 和 --fresh，插件可以询问是否继续此仓库的最新救援线程。

示例：

/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：

请 Codex 重新设计数据库连接，使其更具弹性。

注意：

• 如果没有传递 --model 或 --effort，Codex 会自行选择默认值。
• 如果使用 spark，插件会将其映射为 gpt-5.3-codex-spark
• 后续的救援请求可以继续该仓库中最新 Codex 任务

/codex:transfer

从当前的 Claude Code 会话创建一个持久的 Codex 线程，并打印 codex resume <session-id> 命令。

适用于以下场景：您在 Claude Code 中开始了调试或实现对话，希望直接在 Codex 中继续该上下文的会话。

示例：

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

插件的现有 SessionStart 钩子会自动提供当前转录路径；--source 可用作手动覆盖。传输使用 Codex 的外部代理会话导入器，因此遵循与在 Codex App 中导入 Claude 历史相同的转换规则，并创建可在 App 或 TUI 中继续的可视轮次。源文件必须位于 ~/.claude/projects 下，且未暴露会话导入功能的旧版 Codex 必须先升级才能使用此命令。

/codex:status

显示当前仓库中正在运行和最近的 Codex 任务。

示例：

/codex:status
/codex:status task-abc123

可用于：

• 检查后台工作的进度
• 查看最新完成的任务
• 确认任务是否仍在运行

/codex:result

显示已完成任务的最终存储 Codex 输出。如果可用，还会包含 Codex 会话 ID，以便您使用 codex resume <session-id> 直接在 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 应用服务器 (https://developers.openai.com/codex/app-server)。它使用环境中全局安装的 codex 二进制文件，并应用相同的配置 (https://developers.openai.com/codex/config-basic)。

常用配置

如果您想更改插件使用的默认推理努力程度或默认模型，可以在用户级或项目级的 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
• 项目级覆盖仅在项目被信任时加载 (https://developers.openai.com/codex/config-advanced#project-config-files-codexconfigtoml)

查看 Codex 文档以获取更多配置选项 (https://developers.openai.com/codex/config-reference)。

将工作移交给 Codex

委派的任务以及任何审查门禁运行也可以在 Codex 中直接恢复，方法是运行 codex resume，并指定您从 /codex:result 或 /codex:status 收到的具体会话 ID，或从列表中选择。这样您就可以在 Codex 中审查工作或继续工作。

常见问题

我需要为这个插件使用单独的 Codex 账户吗？

如果您已在此机器上登录 Codex，该账户应能立即在此处使用。本插件使用您本地的 Codex CLI 认证。如果您目前只使用 Claude Code 且尚未使用过 Codex，您还需要使用 ChatGPT 账户或 API 密钥登录 Codex。Codex 可通过您的 ChatGPT 订阅使用 (https://developers.openai.com/codex/pricing/)，而 codex login (https://developers.openai.com/codex/cli/reference/#codex-login) 同时支持 ChatGPT 和 API 密钥登录。运行 /codex:setup 检查 Codex 是否就绪，如果未就绪请使用 !codex login。

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

不。本插件通过您本地机器上的 Codex CLI (https://developers.openai.com/codex/cli/) 和 Codex 应用服务器 (https://developers.openai.com/codex/app-server/) 进行委派。这意味着：

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

它会使用我已有的 Codex 配置吗？

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

我可以继续使用当前的 API 密钥或基础 URL 设置吗？

可以。因为插件使用您本地的 Codex CLI，现有的登录方法和配置仍然适用。如果您需要将内置 OpenAI 提供程序指向不同的端点，请在您的 Codex 配置中设置 openai_base_url (https://developers.openai.com/codex/config-advanced/#config-and-state-locations)。