最近,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官方提供的插件,可以让你的代码质量更上一层楼。
评论