2026 年 3 月 30 日發生了一件罕見的事:OpenAI 將第一方工具直接送進競爭對手的終端機。結果就是 codex-plugin-cc,它改變了兩個代理工作流程如何在單一視窗中運作。
codex-plugin-cc 是什麼,以及 OpenAI 為何為 Claude Code 打造它
codex-plugin-cc 是 OpenAI 官方推出的外掛,能在 Anthropic 的 Claude Code CLI 內執行 Codex 編碼代理。它位於 openai/codex-plugin-cc,採用 Apache-2.0 授權,基本上是純 JavaScript 。值得注意的是方向性——一家前沿模型供應商為競爭對手的生態系統打包工具。
它不是新的執行環境。如 OpenAI 在開發者論壇公告中所說:
"它不是獨立的執行環境。它就是 Codex,只是從 Claude Code 內呼叫。" — OpenAI (來源:OpenAI 開發者社群)
該外掛會委派給已安裝在機器上的 Codex CLI 與應用程式伺服器,重複使用現有的身份驗證與設定。維護相當積極:v1.0.0 於 2026 年 3 月 30 日發布,目前的 v1.0.6 則在 2026 年 7 月 8 日推出——四個月內有六次修補程式更新。這是同一個 Codex 代理,截至 2026 年 6 月已累積超過 500 萬週活躍用戶,只是出現在不同的終端機中。
外掛對你機器的需求
先決條件不多,但很明確。你需要 Node.js 18.18.0 或更新版本——這是外掛 package.json 中宣告的硬性引擎限制(engines: ">=18.18.0"),而非建議值,因此較舊的執行環境將無法安裝。在帳戶方面,ChatGPT 訂閱(免費方案即可)或 OpenAI API 金鑰皆可啟用 Codex。
身份驗證是繼承而非重新輸入。如果你已經在本機登入 Codex,外掛會自動重複使用該狀態,無需再次登入。尚未安裝 Codex?/codex:setup 可在有 npm 的情況下提供執行 npm install -g @openai/codex 的選項,或你也可以先手動執行該指令。
安裝流程:從市集到 /codex:setup
官方完整流程是在活躍的 Claude Code 工作階段中執行四個斜線指令,而非病毒影片所宣傳的兩個指令。請依序執行:
-
/plugin marketplace add openai/codex-plugin-cc— 在目前的工作階段中註冊 OpenAI 發布的市集。Claude Code 將市集視為在安裝任何項目前必須先加入的目錄。 -
/plugin install codex@openai-codex— 從該市集中安裝外掛。注意命名:外掛名稱為codex,市集名稱為openai-codex,因此參考寫法為codex@openai-codex。 -
/reload-plugins— 必要步驟。跳過此步驟,/codex:*技能將不會出現,codex:codex-rescue子代理也會從/agents中消失。 -
/codex:setup— 檢查 Codex 是否已安裝並完成身份驗證。若 Codex 尚未安裝且 npm 可用,會提示執行npm install -g @openai/codex;若 Codex 已存在但尚未登入,則會提示在 Claude Code 中執行!codex login。
在使用前請先驗證:當 /codex:setup 順利完成後,/codex:review 應可正常回應,且 codex:codex-rescue 子代理應可在 /agents 中看到。若其中任一項目缺失,請重新執行 /reload-plugins——跳過重新載入是最常見導致指令無法顯示的原因。
「兩個指令」說法不足之處
病毒影片的「兩個指令,30 秒」說法僅涵蓋市集新增與外掛安裝(步驟 1 與 2)。若跳過 /reload-plugins,外掛雖然已註冊,但處於休眠狀態:其 /codex:* 斜線指令不會載入執行中的工作階段,因此看似無法運作。若跳過 /codex:setup,外掛不會檢查 Codex 是否已安裝並完成身份驗證——這種失敗是無提示的,而非明確的錯誤訊息,這是最難除錯的類型。
在使用前有兩種行為值得注意:
-
審查閘道是選擇性啟用的有其原因。透過設定旗標啟用後,會使用 Claude Code 的
Stophook 在每次 Claude 回應時觸發 Codex。OpenAI 與實務人士警告,這可能造成持續的 Claude/Codex 迴圈,快速耗盡使用額度——請將其視為選用功能,而非預設值。 - 計費保持分開。Codex 使用量計入 Codex 額度,Claude 使用量則計入 Claude 額度。沒有共享配額,也沒有跨帳戶內容——外掛重複使用你本機的 Codex 身份驗證,而非 Claude 的帳戶狀態。
也請保持更新。v1.0.6(2026 年 7 月 8 日發布)移除了 git 指令的 shell 展開功能——這是針對在外掛內對儲存庫執行 shell 操作的正確性與安全性修正。早期版本曾有 Windows 相容性與應用程式伺服器就緒的回歸問題,因此請鎖定近期版本。
乾淨安裝後的斜線指令選單
在 /codex:setup 完成後,外掛會提供一組聚焦的 /codex:* 斜線指令,以及可在 /agents 中看到的 codex:codex-rescue 子代理。這是指令介面,而非通用協調執行環境——每個指令對應對本機儲存庫執行的單一 Codex 動作。
| 指令 | 功能說明 | 主要旗標 |
|---|---|---|
/codex:review |
對未提交的變更或分支差異進行唯讀的 Codex 審查 |
--base、--wait、--background
|
/codex:adversarial-review |
相同的目標選擇,但會以懷疑的角度審查設計決策與假設,而非僅檢查錯誤 |
--base + 可選焦點文字 |
/codex:rescue |
將調查或修復工作委派給 codex:codex-rescue 子代理 |
--model(spark → gpt-5.3-codex-spark)、--resume、--fresh、--effort
|
/codex:transfer |
將目前的 Claude Code 工作階段移交給持久化的 Codex 執行緒以進行較長時間的委派(v1.0.5 新增) | — |
/codex:status · /codex:result · /codex:cancel
|
管理背景工作 | — |
實用習慣:在使用會阻塞的 --wait 之前,先以背景模式執行工作,再用 /codex:status 與 /codex:result 輪詢,並以 /codex:cancel 取消——--wait 會占用終端機直到 Codex 回應為止。具體結論:安裝鎖定的近期版本,執行一次 /codex:review 確認子代理有回應,然後將審查指令整合到你的發布檢查清單中——你現在可以在單一終端機中同時進行 Claude 規劃與 Codex 審查。
常見問題
使用 codex-plugin-cc 是否需要付費的 OpenAI 方案?
不需要。ChatGPT 免費方案即可使用,OpenAI API 金鑰也同樣有效。外掛不會自行維護憑證——它會重複使用本機 Codex 安裝已持有的任何身份驗證。如果你已經在本機登入 Codex,該身份驗證會自動取得;若尚未登入,只需在 Claude Code 中執行一次 !codex login 即可。
Codex 外掛是否共享我的 Claude 帳戶或計費?
不會。Codex 使用量計入你的 Codex 額度,Claude 使用量則計入 Claude 的額度——沒有共享配額、沒有跨帳戶身份驗證,也沒有連結計費。該外掛只是方便的橋樑,用來呼叫本機已安裝的 Codex CLI 與應用程式伺服器;它並不證明兩個代理共享內容、帳戶或權限。特別要注意選擇性的「審查閘道」,因為 Claude/Codex 迴圈可能快速耗盡 Codex 額度。
為什麼在步驟 2 之後我的 /codex:* 指令沒有出現?
你很可能只執行了兩個安裝指令而跳過了 /reload-plugins。新增市集與安裝外掛只會註冊它,但執行中的工作階段尚未載入新技能。請執行 /reload-plugins,接著執行 /codex:setup,/codex:* 斜線指令與 codex:codex-rescue 子代理就會出現在 /agents 中。這也是為什麼「兩個指令」的說法實際上是四個指令。
/codex:review 與 /codex:adversarial-review 有什麼差別?
/codex:review 會對未提交的變更或分支差異(相對於 main 等基準參考)執行標準的唯讀 Codex 審查,支援 --base、--wait 與 --background。/codex:adversarial-review 則會執行可引導的懷疑式審查,主動質疑設計決策與假設,使用相同的目標選擇加上可選的焦點文字。當你需要合併前的第二意見,而非例行變更摘要時,請使用對抗式審查。
codex-plugin-cc 是否等同於 Claude Code 的「OpenAI Developers」外掛?
不是。openai/openai-developers-for-claude 是另一個外掛,內含 Docs MCP 伺服器與 API 設定技能,而 openai/codex-plugin-cc 則提供 Codex 編碼代理本身。它們位於不同的儲存庫,服務不同的目的;安裝其中一個不會同時取得另一個。如果你目標是程式碼審查與任務委派,codex-plugin-cc 才是你要的。
0 Comments
Log in to join the conversation.No comments yet. Be the first to share your thoughts.