codex-plugin-cc

Claude Code 的 Codex 插件

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

此插件面向希望在已有工作流中轻松开始使用 Codex 的 Claude Code 用户。

功能概述

• /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 子代理

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

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

使用方法

/codex:review

对您当前的工作运行常规 Codex 审查。它提供的代码审查质量与直接在 Codex 内运行 /review 相同。

[!NOTE] 代码审查，尤其是多文件变更的审查，可能需要一些时间。通常建议在后台运行。

在以下场景使用：

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

使用 --base <ref> 进行分支审查。它也支持 --wait 和 --background。此命令不可引导，也不接受自定义焦点文本。当您想对特定决策或风险领域进行挑战时，请使用 /codex:adversarial-review。

示例：

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

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

/codex:adversarial-review

运行可引导的审查，旨在质疑当前的实现和设计。

可用于压力测试假设、权衡、失败模式，以及不同方法是否更安全或更简单。

它使用与 /codex:review 相同的审查目标选择方式，包括支持 --base <ref> 进行分支审查。同时也支持 --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 的任务
• 使用更小的模型进行更快或更便宜的尝试

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

支持 --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：

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

注意：

• 如果不指定 --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/<session-id>.jsonl

插件现有的 SessionStart hook 会自动提供当前对话记录路径；--source 可用于手动覆盖。传输使用 Codex 的外部 Agent 会话导入器，因此遵循与在 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 管理可选的审查门控（review gate）。

启用审查门控

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

启用审查门控后，插件会使用 Stop hook 基于 Claude 的响应运行一次针对性的 Codex 审查。如果该审查发现问题，则会阻止停止，让 Claude 先解决问题。

[!WARNING] 审查门控可能会产生长时间运行的 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 中定义。例如，要为特定项目始终使用 gpt-5.4-mini（high 努力程度），可以在启动 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 密钥或基础 URL 设置吗？

是的。因为插件使用您本地的 Codex CLI，您现有的登录方法和配置仍然有效。

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