openai/codex-plugin-cc

# Claude Code 的 Codex 插件 在 Claude Code 中使用 Codex 进行代码审查，或将任务委托给 Codex。 此插件专为 Claude Code 用户设计，帮助他们从现有工作流中轻松开始使用 Codex。 ## 您将获得 - `/codex:review` 用于常规的只读 Codex 代码审查 - `/codex:adversarial-review` 用于可控的挑战性审查 - `/codex:rescue`、`/codex:status`、`/codex:result` 和 `/codex:cancel` 用于委托工作并管理后台任务 ## 环境要求 - **ChatGPT 订阅（包括免费版）或 OpenAI API key。** - 使用将计入您的 Codex 用量限制。[了解更多](https://developers.openai.com/codex/pricing)。 - **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` 相同。 适用于以下场景： - 审查您当前未提交的更改 - 将您的分支与 `main` 等基础分支进行对比审查 使用 `--base ` 进行分支审查。它还支持 `--wait` 和 `--background`。此命令不可控，也不接受自定义焦点文本。当您想质疑特定的决策或风险领域时，请使用 [`/codex:adversarial-review`](#codexadversarial-review)。 示例： ``` /codex:review /codex:review --base main /codex:review --background ``` 此命令为只读模式，不会执行任何更改。在后台运行时，您可以使用 [`/codex:status`](#codexstatus) 检查进度，并使用 [`/codex:cancel`](#codexcancel) 取消正在进行的任务。 ### /codex:adversarial-review 运行**可控的**审查，对所选的实现和设计提出质疑。 它可用于压力测试假设、权衡、故障模式，以及探索是否有更安全或更简单的替代方法。 它使用与 `/codex:review` 相同的审查目标选择机制，包括用于分支审查的 `--base `。 它也支持 `--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。 适用于以下场景，当您希望 Codex 能够： - 调查 bug - 尝试修复 - 继续之前的 Codex 任务 - 使用较小的模型进行更快或成本更低的处理 它支持 `--background`、`--wait`、`--resume` 和 `--fresh`。如果您省略 `--resume` 和 `--fresh`，插件会提示继续此仓库最新的 rescue 线程。 示例： ``` /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` - 后续的 rescue 请求可以继续该仓库中最新的 Codex 任务 ### /codex:status 显示当前仓库正在运行和最近的 Codex 任务。 示例： ``` /codex:status /codex:status task-abc123 ``` 适用于以下场景： - 检查后台工作进度 - 查看最新完成的任务 - 确认任务是否仍在运行 ### /codex:result 显示已完成任务的最终存储 Codex 输出。 如果可用，它还会包含 Codex 会话 ID，以便您可以使用 `codex resume ` 直接在 Codex 中重新打开该运行。 示例： ``` /codex:result /codex:result task-abc123 ``` ### /codex:cancel 取消正在活动的后台 Codex 任务。 示例： ``` /codex:cancel /codex:cancel task-abc123 ``` ### /codex:setup 检查 Codex 是否已安装并完成身份验证。 如果缺少 Codex 且 npm 可用，它会提示为您安装 Codex。 您还可以使用 `/codex:setup` 来管理可选的审查关卡。 #### 启用审查关卡 ``` /codex:setup --enable-review-gate /codex:setup --disable-review-gate ``` 当审查关卡启用时，插件会使用一个 `Stop` 钩子根据 Claude 的响应运行针对性的 Codex 审查。如果该审查发现问题，停止操作将被阻止，以便 Claude 优先处理它们。 ## 典型流程 ### 发布前审查 ``` /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 应用服务器](https://developers.openai.com/codex/app-server)。它使用您环境中安装的全局 `codex` 二进制文件，并[应用相同的配置](https://developers.openai.com/codex/config-basic)。 ### 常用配置 如果您想更改插件使用的默认推理工作量或默认模型，可以在您的用户级或项目级 `config.toml` 中进行定义。例如，若要始终在特定项目上以 `high` 工作量使用 `gpt-5.4-mini`，您可以将以下内容添加到启动 Claude 的目录根部的 `.codex/config.toml` 文件中： ``` model = "gpt-5.4-mini" model_reasoning_effort = "xhigh" ``` 您的配置将基于以下方式加载： - `~/.codex/config.toml` 中的用户级配置 - `.codex/config.toml` 中的项目级覆盖 - 仅当[项目受信任](https://developers.openai.com/codex/config-advanced#project-config-files-codexconfigtoml)时才会加载项目级覆盖 查看 Codex 文档以获取更多[配置选项](https://developers.openai.com/codex/config-reference)。 ### 将工作转移到 Codex 通过运行 `/codex:result` 或 `/codex:status` 获得的特定会话 ID，或者从列表中选择，委托的任务以及任何 [stop gate](#what-does-the-review-gate-do) 运行也可以通过运行 `codex resume` 直接在 Codex 内恢复。 这样您就可以在 Codex 中审查其工作或继续未完成的任务。 ## 常见问题 ### 我需要为此插件使用单独的 Codex 账户吗？ 如果您已在此机器上登录 Codex，该账户在此处也可以立即使用。此插件使用您本地的 Codex CLI 身份验证。 如果您目前只使用 Claude Code 而尚未使用过 Codex，您还需要使用 ChatGPT 账户或 API key 登录 Codex。[Codex 可通过您的 ChatGPT 订阅使用](https://developers.openai.com/codex/pricing/)，并且 [`codex login`](https://developers.openai.com/codex/cli/reference/#codex-login) 支持 ChatGPT 和 API key 登录。运行 `/codex:setup` 以检查 Codex 是否准备就绪，如果未就绪，请使用 `!codex login`。 ### 该插件使用单独的 Codex 运行时吗？ 不。此插件通过同一台机器上的本地 [Codex CLI](https://developers.openai.com/codex/cli/) 和 [Codex 应用服务器](https://developers.openai.com/codex/app-server/) 进行委托。 这意味着： - 它使用您直接使用时相同的 Codex 安装 - 它使用相同的本地身份验证状态 - 它使用相同的仓库检出和机器本地环境 ### 它会使用我现有的 Codex 配置吗？ 是的。如果您已经使用了 Codex，插件会沿用相同的[配置](#common-configurations)。 ### 我可以继续使用当前的 API key 或基础 URL 设置吗？ 是的。因为插件使用您本地的 Codex CLI，您现有的登录方法和配置仍然适用。 如果您需要将内置的 OpenAI 提供程序指向不同的端点，请在您的 [Codex 配置](https://developers.openai.com/codex/config-advanced/#config-and-state-locations)中设置 `openai_base_url`。

标签：AI开发工具, Claude Code 插件, GNU通用公共许可证, LLM 集成, MITM代理, Node.js, NPM 包, OpenAI Codex, Petitpotam, 人工智能编程助手, 人机协同, 代码审查, 代码自动化审查, 任务委派, 后台任务管理, 多模型协同, 威胁情报, 开发者工具, 数据管道, 编程效率, 自定义脚本, 软件工程