最近,OpenAI 官方亲自下场,开发了一个名为 openai/codex-plugin-cc 的 Claude Code 插件。它专为 Claude Code 用户设计,主要作用是将 OpenAI Codex CLI 直接集成到你的 Claude Code 工作环境中。

想象一下,你正在 Claude Code 中进行编程对话,突然需要使用 Codex 进行深入的代码审查,或者委托一个复杂的调试任务。如果没有这个插件,你通常需要停止当前的会话,切换到 Codex 环境,重新设置上下文,然后再执行任务。而有了这个插件,你可以在同一个环境中无缝完成所有工作,大幅提升开发效率。

如何安装 Codex Plugin

安装过程非常简单,只需在 Claude Code 中添加市场源并直接安装即可。请按顺序执行以下三行命令:

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

Codex Plugin 命令详解

该插件共提供了 8 个主要命令,涵盖代码审查、任务委托、任务管理和配置四大功能类别。

代码审查类命令

/codex:review

标准代码审查,对当前代码更改进行只读审查,提供与直接在 Codex 中运行 /review 相同质量的审查结果。

参数选项:

  • --base <ref>:指定基准分支进行分支审查
  • --scope <auto|working-tree|branch>:指定审查范围
  • --wait:前台等待完成
  • --background:后台运行

使用示例:

/codex:review # 审查当前未提交的更改
/codex:review --base main # 审查相对于 main 分支的更改
/codex:review --background # 后台运行审查

这是一个适合在提交前进行质量检查的只读操作,它不会修改代码。

/codex:adversarial-review

对抗性审查,运行可引导的审查流程,主动质疑代码的实现与设计选择,用于压力测试假设、权衡与潜在的失败模式。

参数选项:

  • --base <ref>:指定基准分支
  • --scope <auto|working-tree|branch>:指定审查范围
  • --wait:前台等待完成
  • --background:后台运行
  • [focus text]:额外的焦点文本

使用示例:

/codex:adversarial-review # 对抗性审查当前更改
/codex:adversarial-review --base main challenge whether this was the right caching design
/codex:adversarial-review --background look for race conditions

这是一个专注于挖掘设计选择、权衡和隐藏假设的只读审查机制。它虽然不会直接修复代码,但支持通过自定义焦点文本进行针对性排查,非常适合在发布前进行深度的设计审查。

前面两个命令只是用来审查,但是不会修改代码,如果想要让 AI 帮你一起修复,可以使用下面的命令。

任务委托类命令

/codex:rescue

任务委托与编程,通过 codex:codex-rescue 子代理将任务委托给 Codex,支持调查 Bug、尝试修复以及继续之前的任务等。

参数选项:

  • --background:后台运行
  • --wait:前台等待完成
  • --resume:继续之前的 Codex 线程
  • --fresh:启动新线程
  • --model <model|spark>:指定模型
  • --effort <none|minimal|low|medium|high|xhigh>:推理努力级别
  • [task description]:任务描述

使用示例:

/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 test
/codex:rescue --model spark fix the issue quickly
/codex:rescue --background investigate the regression

该命令非常适合用于调查复杂 Bug、尝试代码修复、继续未完成的 Codex 任务,或是使用更小、更快的模型进行快速迭代。

/codex:transfer

会话转移,从当前 Claude Code 会话创建持久化的 Codex 线程,并输出 codex resume <session-id> 命令。

参数选项:

  • --source <claude-jsonl>:手动指定 Claude 会话文件路径

使用示例:

/codex:transfer
/codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl

这个命令适合在 Claude Code 中开始调试或实现对话后,希望将当前上下文无缝转移到 Codex 中继续处理的场景。

任务管理类命令

/codex:status

查看任务状态,显示当前仓库中正在运行和最近的 Codex 任务。

参数选项:

  • [job-id]:查看特定任务的详细信息
  • --wait:等待任务达到终止状态
  • --timeout-ms <ms>:等待超时时间
  • --all:显示所有任务(不仅限于当前会话)

使用示例:

/codex:status # 显示当前会话的任务列表
/codex:status task-abc123 # 显示特定任务的详细信息
/codex:status --wait task-abc123 # 等待任务完成

输出内容包含任务 ID、类型、状态与阶段,运行时间或持续时间,Codex 会话 ID,任务摘要以及后续操作命令。

/codex:result

查看任务结果,显示已完成任务的最终存储输出,并包含 Codex 会话 ID,以便直接在 Codex 中重新打开该任务。

参数选项:

  • [job-id]:指定任务 ID

使用示例:

/codex:result # 显示最新任务结果
/codex:result task-abc123 # 显示特定任务结果

输出内容包含任务 ID 和状态,完整的结果负载(verdict、summary、findings、details、artifacts、next_steps),文件路径和行号,错误消息(如果有)以及后续操作命令。

/codex:cancel

取消任务,用于终止活动的后台 Codex 任务,如果不传参数默认取消最新任务。

参数选项:

  • [job-id]:指定要取消的任务 ID

使用示例:

/codex:cancel # 取消最新任务
/codex:cancel task-abc123 # 取消特定任务

配置类命令

/codex:setup

设置和配置,用于检查 Codex 是否已安装并完成认证。如果缺少 Codex 且本地有 npm 可用,该命令还可以提供安装引导。

参数选项:

  • --enable-review-gate:启用审查门控
  • --disable-review-gate:禁用审查门控
  • --json:以 JSON 格式输出

使用示例:

/codex:setup # 检查 Codex 状态
/codex:setup --enable-review-gate # 启用审查门控
/codex:setup --disable-review-gate # 禁用审查门控

审查门控功能启用后,插件会使用 Stop hook 基于 Claude 的响应运行有针对性的 Codex 审查。如果审查发现问题,它会阻止会话停止,以便 Claude 优先解决这些问题。需要注意的是,这可能会触发长时间运行的 Claude/Codex 循环,从而快速消耗 token,非必要不开启。

最后

如果你已经在使用 Claude Code,强烈建议立刻安装这个OpenAI官方提供的插件,可以让你的代码质量更上一层楼。

本文为原创,未经授权,禁止任何媒体或个人自媒体转载
商业侵权必究,如需授权请联系340443366@qq.com