codex-plugin-cc：在 Claude Code 裡呼叫 Codex 做程式碼審查與任務接力

Mon, 06 Jul 2026 07:30:09 +0800

OpenAI 的 codex-plugin-cc 是一個给 Claude Code 使用的插件。它的目标很直接：如果你平時主要在 Claude Code 裡開發，但又想讓 Codex 参與程式碼審查、問題排查或長任務接力，就可以通過這個插件把 Codex 接进现有工作流。

它不是另一個独立的程式碼编辑器，也不是重新实现一套 Codex。它调用的是本机已经安裝并登录的 Codex CLI 和 Codex app server，所以账号、設定、倉庫目录和本機环境都沿用你机器上的 Codex 状态。

適合谁用

這個插件適合幾类人：

日常主要使用 Claude Code，但也想用 Codex 做独立程式碼審查；
希望在提交前讓另一個 Agent 挑問題、质疑設計或檢查風險；
想把某個 bug、测试失败或重构任務交给 Codex 在背景跑；
已经設定好 Codex，希望 Claude Code 和 Codex 可以在同一個倉庫裡顺手协作；
想把 Claude Code 目前會话转成 Codex 可继續接手的 thread。

如果你只使用 Codex，不使用 Claude Code，這個插件意义不大。它的价值就在于把两個工具之间的切换成本压低。

前置要求

官方 README 给出的要求很少：

ChatGPT 订阅，包括 Free，或 OpenAI API key；
Node.js 18.18 或更高版本；
本机能安裝并執行 Codex CLI。

需要注意的是，通過這個插件调用 Codex 仍然會计入你的 Codex usage limits。它不是绕過额度的入口，只是把 Codex 放进 Claude Code 的命令体系裡。

如果 Codex 還没安裝，可以後面讓 /codex:setup 引导安裝，也可以自己先装：

`1`	`npm install -g @openai/codex`

如果 Codex 已经安裝但還没登录，在 Claude Code 裡可以執行：

`1`	`!codex login`

安裝方法

在 Claude Code 裡先添加插件 marketplace：

`1`	`/plugin marketplace add openai/codex-plugin-cc`

然後安裝插件：

`1`	`/plugin install codex@openai-codex`

重新加载插件：

`1`	`/reload-plugins`

最後執行初始化檢查：

`1`	`/codex:setup`

/codex:setup 會檢查 Codex 是否可用。如果 Codex 缺失，并且目前环境可以使用 npm，它會提示你安裝 Codex。安裝完成後，Claude Code 裡应該能看到一组 /codex:* slash commands，并且在 /agents 中看到 codex:codex-rescue subagent。

一個最小的首次测试流程是：

1
2
3

/codex:review --background
/codex:status
/codex:result

主要命令

`/codex:review`

/codex:review 用来讓 Codex 對目前改动做普通程式碼審查。它是只读命令，不會修改程式碼。

常見用法：

1
2
3

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

如果目前改动比较多，建議加 --background。多檔案審查可能會跑一段時间，放到背景後可以用 /codex:status 查看进度，用 /codex:result 读取结果。

這個命令適合檢查：

目前未提交改动有没有明显 bug；
分支相對 main 的改动是否有風險；
提交前是否遗漏了测试、边界条件或兼容性問題。

它不接受自定义審查焦点。如果你想讓 Codex 专门挑戰某個設計選擇，应該用 /codex:adversarial-review。

`/codex:adversarial-review`

/codex:adversarial-review 是可引导的挑戰式審查。它同样只读，不會修程式碼，但會更强调质疑实现方向、設計取舍和隐藏假设。

示例：

1
2
3

/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:rescue 會把一個任務交给 codex:codex-rescue subagent。它更像“把問題交给 Codex 跑一轮”，可以用于 bug 排查、修测试、继續上一次 Codex 任務，或者用较小模型做一個更快的尝试。

示例：

/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

也可以用自然语言讓 Claude Code 把任務委托给 Codex：

`1`	`Ask Codex to redesign the database connection to be more resilient.`

幾個细节要记住：

不传 --model 或 --effort 時，Codex 會自己選擇預設值；
spark 會映射到 gpt-5.3-codex-spark；
不传 --resume 和 --fresh 時，插件可以提示是否继續目前倉庫裡最近的 rescue thread；
複杂任務建議配合 --background，否则容易卡住目前工作节奏。

`/codex:transfer`

/codex:transfer 是 v1.0.5 中值得注意的新功能。它可以把目前 Claude Code 會话转成一個持久的 Codex thread，并输出 codex resume <session-id> 命令。

示例：

1
2

/codex:transfer
/codex:transfer --source ~/.claude/projects/-Users-me-repo/<session-id>.jsonl

這個命令適合用在“我已经和 Claude Code 讨论了很多上下文，但後面想交给 Codex 继續”的场景。插件會使用 Claude Code 的 SessionStart hook 找到目前 transcript path；--source 则可以手动指定来源。

限制也要注意：

source 必须位于 ~/.claude/projects 下；
依赖 Codex 的 external-agent session importer；
老版本 Codex 如果没有 session import 能力，需要先升級。

`/codex:status`、`/codex:result` 和 `/codex:cancel`

這三個命令负责管理背景任務。

查看任務状态：

1
2

/codex:status
/codex:status task-abc123

读取任務结果：

1
2

/codex:result
/codex:result task-abc123

取消任務：

1
2

/codex:cancel
/codex:cancel task-abc123

如果任務结果裡包含 Codex session ID，你還可以用 codex resume <session-id> 在 Codex 裡继續那個任務。

可選的 review gate

/codex:setup 還可以管理一個可選的 review gate：

1
2

/codex:setup --enable-review-gate
/codex:setup --disable-review-gate

启用後，插件會通過 Claude Code 的 Stop hook 触發一次有针對性的 Codex review。如果 Codex 找到問題，這次停止會被阻止，讓 Claude Code 先處理反馈。

這個功能听起来很诱人，但要谨慎开。官方也提醒，它可能形成 Claude 和 Codex 之间的長循环，并快速消耗 usage limits。更適合在你盯着看的关键任務中临時开启，而不是長期預設打开。

設定怎么繼承

codex-plugin-cc 使用本机全局 codex binary，因此會沿用你的 Codex 設定。

如果想给某個專案指定預設模型和推理强度，可以在專案根目录的 .codex/config.toml 中写：

1
2

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

設定读取顺序主要包括：

使用者級設定：~/.codex/config.toml；
專案級設定：.codex/config.toml；
專案級設定只會在專案被 Codex trust 後加载。

如果你已经用 API key、base URL 或其他 Codex 設定跑通了工作流，插件會继續使用這些設定。需要改 OpenAI provider endpoint 時，可以在 Codex 設定裡设置 openai_base_url。

常見工作流

提交前審查

1
2
3

/codex:review --background
/codex:status
/codex:result

適合在准备 commit 前跑一遍。它不會帮你自动修，但能用 Codex 的视角指出 bug、测试缺口和風險。

挑戰設計

`1`	`/codex:adversarial-review --background look for auth bypass and rollback risks`

適合权限、資料迁移、缓存失效、重试策略這类“程式碼能跑，但設計可能埋雷”的改动。

把問題交给 Codex 跑

`1`	`/codex:rescue --background investigate why the build is failing in CI`

適合你不想中断目前 Claude Code 對话，但又希望 Codex 在背景独立排查。

從 Claude Code 转到 Codex

`1`	`/codex:transfer`

当 Claude Code 裡已经积累了足够上下文，但你想在 Codex App 或 TUI 继續，就用這個命令生成可恢複的 Codex thread。

使用建議

我的建議是先把它当成“第二審查者”和“背景救援通道”，不要一上来就把 review gate 打开。

比较稳的顺序是：

先跑 /codex:setup，确認 Codex 安裝、登录和 Claude Code 插件都正常；
用 /codex:review --background 做一次只读審查；
需要挑戰設計時再用 /codex:adversarial-review；
确認背景任務管理顺手後，再尝试 /codex:rescue；
只有在明确需要跨工具延續上下文時，再用 /codex:transfer。

這样用下来，codex-plugin-cc 的定位會比较清楚：Claude Code 继續做主工作台，Codex 负责独立審查、背景排查和必要時接手上下文。對已经在两個工具之间来回切的人来说，這個插件能少掉不少手工複制上下文和重新解释任務的時间。

程式碼審查 on KnightLi的博客