Codex 插件：Claude Code

项目概述

Codex 插件让 Claude Code 用户可以直接在现有工作流中调用 Codex 完成代码审查或将任务委派给 Codex。该插件依赖本地 Codex CLI 与 Codex app server，使用同一份 Codex 安装、登录状态与配置。

可用命令

• /codex:review：对当前改动或指定分支执行只读 Codex 审查，支持 --base <ref>、--wait、--background，但不支持额外聚焦文本。
• /codex:adversarial-review：可引导的对抗式审查，会质疑当前实现与设计决策，适合压测取舍、隐藏假设与替代方案。语法与 review 相同，但可在参数后追加聚焦说明。
• /codex:rescue：通过 codex:codex-rescue 子代理把任务交给 Codex，例如排查缺陷、应用补丁或继续上一次任务。支持 --background、--wait、--resume、--fresh、--model、--effort；spark 会映射到 gpt-5.3-codex-spark，省略模型与 effort 参数时由 Codex 自选默认。
• /codex:transfer：将当前 Claude Code 会话转成持久的 Codex 线程，并输出 codex resume <session-id> 命令，--source 可手动指定 transcript 路径，文件须位于 ~/.claude/projects 下。
• /codex:status：查看当前仓库运行中与最近的 Codex 任务。
• /codex:result：读取已完成任务的最终输出，附带回话 ID，可直接 codex resume 打开。
• /codex:cancel：取消正在运行的后台 Codex 任务。
• /codex:setup：检查 Codex 安装与登录状态；缺失时若 npm 可用会提示安装。提供 --enable-review-gate 与 --disable-review-gate 开关审查门禁。

环境要求

需要 ChatGPT 订阅（含免费版）或 OpenAI API Key，使用会占用 Codex 用量额度；本地需安装 Node.js 18.18 及以上。

安装步骤

/plugin marketplace add openai/codex-plugin-cc   # 添加市场源
/plugin install codex@openai-codex                # 安装插件
/reload-plugins                                   # 重载插件
/codex:setup                                      # 校验就绪状态

如需手动安装 Codex CLI：

npm install -g @openai/codex
!codex login   # 已安装但未登录时使用

首次建议执行：

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

典型工作流

# 提交前审查
/codex:review

# 委派问题
/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

审查门禁

启用后，插件会通过 Stop 钩子对 Claude 的回复触发一次定向 Codex 审查；发现问题时会阻止停止，让 Claude 先处理再继续。该机制容易形成长循环并快速消耗额度，仅建议在主动盯盘时开启。

配置

可在用户级 ~/.codex/config.toml 或项目级 .codex/config.toml 中覆盖默认模型与推理强度，例如：

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

项目级配置只有在项目被信任时才会加载。若需切换内置 OpenAI Provider 的端点，可在 Codex 配置中设置 openai_base_url。所有交给 Codex 的任务及门禁触发的运行，都可以使用 /codex:result 或 /codex:status 输出的会话 ID 通过 codex resume 在 Codex 中继续。

常见问题

插件使用本地 Codex CLI 的鉴权状态，已在机器上登录 Codex 即可直接使用。运行环境、配置文件、API Key 与 base URL 与独立使用 Codex 时保持一致，无需单独账号或额外运行时。