用途
Codex plugin for Claude Code 面向已经在使用 Claude Code 的用户，目的是让用户在自己现有的工作流中便捷地开始使用 Codex。它可以从 Claude Code 内部调用 Codex 进行代码审查，或把任务委派给 Codex。
主要能力
插件提供以下命令：
- /codex:review：执行常规的只读 Codex 审查。适用于审查当前未提交的改动，或比较分支与基线分支（如 main）。支持 --base <ref> 进行分支审查，也支持 --wait 和 --background。该命令不可引导，不接受自定义关注文本。命令为只读，不会做任何修改。后台运行时可用 /codex:status 查看进度，用 /codex:cancel 取消进行中的任务。多文件变更的代码审查可能耗时较久，一般建议在后台运行。
- /codex:adversarial-review：运行可引导的挑战式审查，质疑所选实现与设计。可用于压力测试假设、权衡、失败模式，以及是否存在更安全或更简单的替代方案。审查目标选择方式与 /codex:review 相同，包括 --base <ref>，也支持 --wait 和 --background。与 /codex:review 不同，它可以在参数后附加额外关注文本。该命令为只读，不会修复代码。
- /codex:rescue：通过 codex:codex-rescue 子代理把任务交给 Codex。可用于调查 bug、继续之前的 Codex 任务、或用更小的模型做一次更快或更省的处理。支持 --background、--wait、--resume、--fresh。若省略 --resume 和 --fresh，插件可提示继续该仓库最近的 rescue 线程。若未传 --model 或 --effort，Codex 自行选择默认值；若指定 spark，插件会映射为 gpt-5.3-codex-spark。后续 rescue 请求可继续该仓库中最近的 Codex 任务。
- /codex:transfer：从当前 Claude Code 会话创建一个持久的 Codex 线程，并打印 codex resume <session-id> 命令。适用于在 Claude Code 中开始调试或实现对话后，希望直接在 Codex 中继续同一上下文。插件已有的 SessionStart hook 会自动提供当前记录路径，--source 可作为手动覆盖。该转移使用 Codex 的外部代理会话导入器，遵循与在 Codex App 中导入 Claude 历史相同的转换规则，并生成可在 App 或 TUI 中继续的可见轮次。源文件必须位于 ~/.claude/projects 下，未暴露会话导入功能的旧版 Codex 需要先升级。
- /codex:status：显示当前仓库正在运行和最近的 Codex 任务。可用于查看后台工作进度、查看最近完成的任务、确认任务是否仍在运行。
- /codex:result：显示已完成任务的最终存储 Codex 输出。在可用时还会包含 Codex 会话 ID，便于用 codex resume <session-id> 直接在 Codex 中重开该次运行。
- /codex:cancel：取消一个活跃的后台 Codex 任务。
- /codex:setup：检查 Codex 是否已安装并完成认证。若 Codex 缺失且 npm 可用，可提供安装 Codex。也可用于管理可选的 review gate。
使用方式
前置条件：ChatGPT 订阅（含免费版）或 OpenAI API key；用量会消耗 Codex 使用限额。需要 Node.js 18.18 或更高版本。
安装步骤（在 Claude Code 中）：
-
添加 marketplace： 添加 marketplace 的具体命令暂未提供。
-
安装插件： 安装插件的具体命令暂未提供。
-
重载插件： 重载插件的具体命令暂未提供。
/codex:setup 会告知 Codex 是否就绪。若 Codex 缺失且 npm 可用，它可提议为你安装 Codex。若想自行安装 Codex，命令暂未提供。若 Codex 已安装但未登录，运行：
codex login
安装后应看到以下 slash 命令，以及 /agents 中的 codex:codex-rescue subagent。
一个简单的首次运行是运行 /codex:review。
插件会包裹 Codex app server，使用环境中安装的全局 codex 二进制，并应用相同配置。
常用配置：若想更改插件使用的默认推理强度或默认模型，可在用户级或项目级 config.toml 中定义。例如，要在特定项目始终使用 gpt-5.4-mini 并设为 high，可在启动 Claude 的目录根部的 .codex/config.toml 中添加相应配置。配置读取顺序为：~/.codex/config.toml 中的用户级配置；.codex/config.toml 中的项目级覆盖。项目级覆盖仅在项目被信任时加载。更多配置选项见 Codex 文档。
把工作移回 Codex：委派的任务以及任何 stop gate 运行，也可以在 Codex 内直接恢复，方法是运行 codex resume（带从 /codex:result 或 /codex:status 获得的特定会话 ID），或从列表中选取。这样可以审查或继续 Codex 的工作。
适用场景
- 发布前审查：质疑方向而非仅代码细节，审查聚焦设计选择、权衡、隐藏假设与替代方案，针对 auth、数据丢失、回滚、竞态条件或可靠性等特定风险领域进行压力测试。
- 把问题交给 Codex 处理。
- 启动长时间运行的任务，然后用 /codex:status 等进行检查。
限制
- 用量会消耗 Codex 使用限额。ChatGPT 订阅（含免费版）或 OpenAI API key 均可使用。
- 需要 Node.js 18.18 或更高版本。
- /codex:review 和 /codex:adversarial-review 为只读，不会修改或修复代码。
- review gate 会形成长时间运行的 Claude/Codex 循环，可能快速消耗使用限额。仅在计划主动监控会话时才启用。
- 若已在本机登录 Codex，该账号应可直接使用；插件使用本地 Codex CLI 认证。若仅使用 Claude Code 且从未用过 Codex，则需要用 ChatGPT 账号或 API key 登录 Codex。可用 /codex:setup 检查是否就绪，未就绪时用 !codex login。
- 插件不使用单独的 Codex 运行时，而是通过本机本地 Codex CLI 和 Codex app server 委派，使用相同的 Codex 安装、本地认证状态、仓库检出和机器本地环境，并沿用相同的 Codex 配置。
- 若需把内置 OpenAI 提供方指向不同端点，可在 Codex 配置中设置 openai_base_url。
- /codex:transfer 的源文件必须位于 ~/.claude/projects 下，旧版 Codex 需先升级。
