Codex 外掛程式 for Claude Code (openai/codex-plugin-cc)
總覽
codex-plugin-cc 是 OpenAI 官方外掛程式，可將 OpenAI Codex CLI 直接整合到 Claude Code 開發者工作流程中。它讓 Claude Code 使用者能夠觸發由 Codex 提供支援的程式碼審查、對抗性設計挑戰和背景任務委派 — 所有這些都無需離開 Claude Code 介面。
此外掛程式連接了兩個強大的 AI 編碼代理：Anthropic 的 Claude Code 和 OpenAI 的 Codex CLI，實現了「第二意見」和多代理協作工作流程。
存在原因
Claude Code 是一個出色的代理式編碼工具，但先前將 Codex 與其搭配使用需要切換上下文並手動呼叫獨立的工具。此外掛程式消除了這種摩擦：
- Codex 在詳細、懷疑的程式碼審查方面特別強大
- 對同一程式碼執行兩個獨立的 AI 模型比單獨一個模型能捕捉到更多問題
- 使用者可以將 Claude Code 作為主要介面，同時將特定任務卸載給 Codex
要求
| 要求 | 詳細資訊 |
|---|---|
| 驗證 | ChatGPT 訂閱（包含免費方案）或 OpenAI API 金鑰 |
| Node.js | v18.18 或更高版本 |
| Codex CLI | 通過 npm install -g @openai/codex 全域安裝 |
使用量計入您現有的 Codex 使用量限制。
安裝
# 1. 在 Claude Code 中新增市集來源
/plugin marketplace add openai/codex-plugin-cc
# 2. 安裝外掛程式
/plugin install codex@openai-codex
# 3. 重新載入外掛程式
/reload-plugins
# 4. 驗證設定
/codex:setup
如果未安裝 Codex CLI，/codex:setup 可以選擇通過 npm 自動安裝它。
核心指令
/codex:review
對您目前未提交的變更或分支差異執行標準的唯讀 Codex 程式碼審查。
/codex:review # 審查未提交的變更
/codex:review --base main # 與 main 分支進行審查
/codex:review --background # 在背景執行（建議用於大型差異）
使用案例： 發佈前的健全性檢查、多檔案變更審查。
/codex:adversarial-review
一個可控、有觀點的審查，它挑戰您的實作選擇 — 不僅僅是表面的程式碼風格。它會質疑假設、權衡、失敗模式和替代方法。
/codex:adversarial-review
/codex:adversarial-review --base main challenge whether the caching strategy is correct
/codex:adversarial-review --background look for race conditions
使用案例： 發佈前審查、架構審計、壓力測試圍繞驗證、資料遺失、回滾和可靠性的設計決策。
/codex:rescue
將任務委派給 Codex 作為背景子代理 (codex:codex-rescue)。Codex 將調查錯誤、套用修復或從先前的工作階段繼續。
/codex:rescue investigate why the tests started failing
/codex:rescue fix the failing test with the smallest safe patch
/codex:rescue --model gpt-5.4-mini --effort medium investigate the flaky test
/codex:rescue --background investigate the regression
/codex:rescue --resume apply the top fix from the last run
您也可以使用自然語言：
Ask Codex to redesign the database connection to be more resilient.
支援的旗標： --background, --wait, --resume, --fresh, --model, --effort
/codex:status
列出目前儲存庫中正在執行和最近完成的 Codex 工作。
/codex:status
/codex:status task-abc123
/codex:result
擷取已完成 Codex 工作輸出的結果。也會傳回 Codex 工作階段 ID，以便直接在 Codex CLI 中重新開啟。
/codex:result
/codex:result task-abc123
/codex:cancel
取消作用中的背景 Codex 工作。
/codex:cancel
/codex:cancel task-abc123
/codex:setup
檢查 Codex 安裝和驗證狀態。也管理可選的審查閘門。
/codex:setup --enable-review-gate # auto-review every Claude response via Codex Stop hook
/codex:setup --disable-review-gate
⚠️ 審查閘門可能會建立一個長時間執行的 Claude/Codex 回饋迴路，並快速耗盡使用量限制。啟用時請積極監控工作階段。
一般工作流程
1. 發佈前審查
/codex:review
2. 處理難題
/codex:rescue investigate why the build is failing in CI
3. 長時間背景工作
/codex:adversarial-review --background
/codex:rescue --background investigate the flaky test
# 稍後檢查：
/codex:status
/codex:result
設定
此外掛程式繼承自 ~/.codex/config.toml（使用者層級）或 .codex/config.toml（專案層級）的 Codex CLI 設定。
例如，專案層級的設定，始終以 xhigh 的努力程度使用 gpt-5.4-mini：
model = "gpt-5.4-mini"
model_reasoning_effort = "xhigh"
也支援自訂 openai_base_url 以用於自訂 API 端點。
架構
此外掛程式封裝了 Codex App Server，並將所有工作委派給同一台機器上全域安裝的 Codex CLI 二進位檔。這意味著：
- 不會引入獨立的 Codex 執行階段
- 驗證狀態與任何現有的 Codex 安裝共用
- 儲存庫簽出和環境與直接使用 Codex 相同
/codex:result的結果包含工作階段 ID，可以使用codex resume <session-id>直接恢復
常見問題
問：我需要單獨的 Codex 帳戶嗎？
否。如果您已在機器上登入 Codex CLI，則外掛程式會重複使用該驗證。
問：此外掛程式是否使用獨立的 Codex 執行階段？
否。它通過您現有的本機 Codex CLI 和應用程式伺服器進行委派。
問：我可以使用我現有的 API 金鑰或自訂基礎 URL 嗎？
是。此外掛程式會讀取您的 Codex CLI 設定，包括 openai_base_url。
摘要
codex-plugin-cc 代表了 AI 編碼工具生態系統中一個有趣的匯聚點：一個旨在擴展競爭產品（Claude Code）的 OpenAI 官方工具。它實現了一個強大的多代理審查工作流程，其中 Claude 編寫和迭代程式碼，而 Codex 提供獨立的審查 — 捕捉單一模型可能會遺漏的問題。