openai codex-plugin-cc

以下是您要求的英文文章的中文翻译，已按照要求保留原文结构、技术术语和代码块，并输出为 Markdown 格式。

Codex 插件 for Claude Code

在 Claude Code 内部使用 Codex 进行代码审查，或将任务委托给 Codex。此插件适用于希望从现有工作流中轻松开始使用 Codex 的 Claude Code 用户。

你能获得什么

/codex:review – 常规只读 Codex 审查
/codex:adversarial-review – 可引导的挑战性审查
/codex:rescue、/codex:transfer、/codex:status、/codex:result 和 /codex:cancel – 用于委托工作、移交会话以及管理后台任务

要求

ChatGPT 订阅（含免费版）或 OpenAI API 密钥。使用量会计入你的 Codex 使用限制。了解更多。
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。

示例：

/codex:review
/codex:review --base main
/codex:review --background

此命令为只读，不会执行任何更改。在后台运行时，你可以使用 /codex:status 检查进度，使用 /codex:cancel 取消正在进行的任务。

`/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，插件可以提供继续该仓库最新救援线程的选项。

示例：

/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。
后续的救援请求可以继续该仓库中最新的 Codex 任务。

`/codex:transfer`

从当前的 Claude Code 会话创建一个持久的 Codex 线程，并打印一条 codex resume 命令。

在以下情况下使用它：你在 Claude Code 中开始了调试或实现对话，并希望直接在 Codex 中继续相同的上下文。

示例：

/codex:transfer
/codex:transfer --source ~/.claude/projects/-Users-me-repo/.jsonl

插件的现有 SessionStart 钩子会自动提供当前转录路径；--source 可作为手动覆盖选项使用。转移使用 Codex 的外部代理会话导入器，因此它遵循与在 Codex App 中导入 Claude 历史相同的转换规则，并创建可在 App 或 TUI 中继续的可见轮次。源文件必须位于 ~/.claude/projects 下，并且未暴露会话导入功能的旧版 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