Agent 插件 · 官方实现

Codex Plugin for Claude Code

OpenAI 为 Claude Code 发布的官方 Codex 插件,通过 8 个斜杠命令提供只读代码审查、对抗式复核、任务委派、故障救援、后台作业管理和会话转移,并复用本机 Codex CLI 的认证与配置。

32.6k StarsApache-2.0JavaScript1 个月前更新
01

项目介绍

Codex Plugin for Claude Code 是 OpenAI 发布的官方 Claude Code 插件,用本机已配置的 Codex CLI 为 Claude Code 增加独立代码审查、对抗式复核、任务救援、后台作业和会话转移能力。它不是远程托管代理或独立 IDE:Claude Code 负责入口与上下文组织,插件启动本地 Node.js 和 Codex app-server 进程,认证、模型、端点与仓库访问沿用用户的 Codex 配置。普通 review 面向只读分析,rescue 则可在授权范围内修改项目,因此采用前要把两类权限清楚区分。

02

核心功能

01

只读代码审查

/codex:review 针对当前工作树或指定范围启动 Codex 复核,命令约束只读并允许 Read、Glob、Grep 以及受限的 Node/Git 调用。

02

对抗式持续复核

/codex:adversarial-review 用可继续追问的会话挑战实现与结论,适合在高风险设计或修复上引入独立视角。

03

任务救援与委派

/codex:rescue 调用 codex-rescue agent 调查或完成任务;除非用户明确要求只读或仅诊断,代理默认可能写文件并执行命令。

04

后台作业控制

status、result 与 cancel 用于查看、取回和停止后台 Codex 工作,作业状态和日志按工作区保存在本地插件数据目录。

05

Claude 会话转移

/codex:transfer 只接受 ~/.claude/projects 下经 realpath 校验的 JSONL 记录,并在 Codex App 或 TUI 创建可继续的可见会话。

03

安装与使用

在 Claude Code 中添加 OpenAI marketplace,安装 codex@openai-codex,重载插件后运行 /codex:setup。setup 会检查或引导安装本地 Codex CLI;任何全局 npm 安装、登录或启用 Stop review gate 都应先单独确认。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装 https://github.com/openai/codex-plugin-cc 的 Codex Plugin for Claude Code。先核对 README、v1.0.6 Release、LICENSE、插件 manifest、hooks 与 setup 命令,并确认当前 Claude Code、Node.js 版本和本地 Codex CLI 状态。说明它会启动本地进程、读取仓库与 Codex 配置、保存作业日志,rescue 可能写文件,transfer 会读取 ~/.claude/projects 会话。得到我确认后再执行 README 的 marketplace、install 和 reload 命令。遇到 npm -g 安装、Codex 登录、API 密钥、额外权限、覆盖配置或启用 review gate 时必须再次询问;不要打印凭据。最后只在非生产仓库运行后台只读 review,并用 status/result 验证,不要运行 rescue 或 transfer。
01开始前准备
  • 已安装支持插件 marketplace 的 Claude Code
  • Node.js 18.18 或更高版本
  • ChatGPT 订阅或 OpenAI API 密钥,可供本地 Codex CLI 认证
  • 有一个可安全读取的测试仓库,并已决定 rescue 是否允许写入
02复制安装命令或配置
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
03按步骤完成安装
  1. 1
    添加 OpenAI 插件市场

    在 Claude Code 运行 /plugin marketplace add openai/codex-plugin-cc,然后用 /plugin install codex@openai-codex 安装插件。

  2. 2
    重载并完成本地设置

    运行 /reload-plugins 与 /codex:setup;检查 Node.js、Codex CLI 和认证状态,全局安装或登录前先确认影响。

  3. 3
    做一次只读后台审查

    在非生产仓库运行 /codex:review --background,保持范围明确,不把密钥、个人数据或无关文件加入提示。

  4. 4
    读取并核对结果

    用 /codex:status 查看作业,再用 /codex:result 取回结论;将发现视为待人工核实的审查意见。

  5. 5
    按需开放高权限能力

    只有在理解写入和数据边界后才使用 rescue 或 transfer;review gate 仅在有人主动监控时启用。

如何确认安装成功

重载并完成 setup 后,先确认 /codex:* 命令和 codex-rescue agent 可见;在非生产仓库运行 /codex:review --background,再用 /codex:status 和 /codex:result 查看只读结果。不要用首次验证触发 rescue、transfer 或 review gate。

使用前注意
  • 使用 API 密钥时不要把密钥粘贴到聊天、草稿或仓库文件中
  • setup 可能建议 npm install -g @openai/codex,属于全局环境变更,应先确认
  • review gate 默认可选且可能形成长循环,首次安装不要启用
04

使用场景

SCENARIO 01

提交前独立审查

让 Codex 从与 Claude Code 不同的上下文视角检查当前差异,并由开发者核实发现。

SCENARIO 02

挑战高风险方案

用对抗式审查持续追问边界条件、错误假设和缺失测试,而不自动修改实现。

SCENARIO 03

委派受控修复任务

把范围清楚的实现或故障排查交给 rescue,同时用分支、沙箱和命令权限限制影响。

SCENARIO 04

跨客户端延续会话

将选择的 Claude Code 会话导入 Codex App 或 TUI,继续使用可见的上下文轮次。

05

使用评价

这款插件的价值在于把 Claude Code 与本机 Codex 连接成可追踪的双代理工作流,而不是把某个模型包装成质量保证。OpenAI 官方仓库提供了明确安装命令、Apache-2.0 许可证、版本化 Release、命令源码、hooks 和测试;普通 review 的只读约束与 rescue 的可写默认也能从实际文件中区分。主要代价是数据和权限面扩大:仓库内容与提示会由本地 Codex 配置的模型端点处理,transfer 读取 Claude 会话,后台作业写本地日志,review gate 可能延长循环并消耗额度。最稳妥的采用顺序是先完成 setup,再在非生产仓库验证只读 review,最后按需开放 rescue、transfer 或 Stop hook。本评价仅基于公开一手资料和源码结构,未做安装或功能实测。

值得一试的地方

  • 官方仓库、清晰安装路径、版本化 Release 与 Apache-2.0 许可证
  • 8 个命令覆盖审查、委派、作业管理和会话转移
  • 只读审查与可写救援在命令和 agent 指令中有明确区分
  • 仓库包含自动化测试、hooks 与实际运行脚本,非空壳项目

使用前要知道

  • 依赖 Claude Code、Node.js、Codex CLI 认证和可用额度
  • rescue、transfer 与 review gate 扩大文件、会话和模型数据边界
  • CHANGELOG 更新落后于 Release,仓库未见专属 SECURITY.md
  • 本次没有安装插件或执行任何命令
06

README

Codex Plugin for Claude Code


Overview

OpenAI 为 Claude Code 发布的官方 Codex 插件,通过 8 个斜杠命令提供只读代码审查、对抗式复核、任务委派、故障救援、后台作业管理和会话转移,并复用本机 Codex CLI 的认证与配置。 Use Codex from Claude Code to review code or delegate tasks.

Getting started

  • 在 Claude Code 中添加 OpenAI marketplace,安装 codex@openai-codex,重载插件后运行 /codex:setup。setup 会检查或引导安装本地 Codex CLI;任何全局 npm 安装、登录或启用 Stop review gate 都应先单独确认。
  • README 将插件定位为 Claude Code 与 Codex 的本地桥梁:既可做正常或对抗式代码审查,也可把任务交给 Codex 子代理。
  • 安装流程先添加 openai/codex-plugin-cc marketplace,再安装 codex@openai-codex、重载插件并运行 /codex:setup。
  • 重载并完成 setup 后,先确认 /codex:* 命令和 codex-rescue agent 可见;在非生产仓库运行 /codex:review --background,再用 /codex:status 和 /codex:result 查看只读结果。不要用首次验证触发 rescue、transfer 或 review gate。

Configuration

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setup
在 GitHub 阅读完整 README