~/教學/LOOP.md

文章 / Claude Code

Claudex Loop:Claude Code 寫計畫、Codex 一輪一輪審,過了才寫程式(免費開源外掛,安裝與用法)

Claude Code 和 Codex 互審計畫,改到 APPROVED 才寫程式,寫完再換另一個驗收。兩行安裝指令、開始 loop 和只審計畫的指令,還有它需要什麼、什麼時候別用。

Claude Code 寫的計畫,如果讓另一家公司的模型來挑毛病,會挑出什麼?Claudex Loop 是一個免費開源的外掛:Claude Code 寫計畫,Codex 一輪一輪審,Claude 改完再送回去,直到 Codex 說 APPROVED 才開始寫程式;寫完,再換沒寫程式的那一個驗收。這篇是 Reels 裡 LOOP 那支的完整版:它怎麼分工、Claude Code 怎麼裝(兩行指令)、怎麼開始一個 loop、只審計畫怎麼下指令,還有它需要什麼、什麼時候別用。全部照官方 README 和 SKILL.md,我在 2026 年 11 月 10 日核對過。

01先看結果:計畫被審了五輪,問題從 26 個降到 0

Reels 畫面:筆電螢幕上是 claudex-loop 的執行範例,ROUND 1 到 4 是 REVISE,ROUND 5 是 APPROVED,旁邊貼著「問題 26 → 0」
Reels 畫面:筆電上是官方 repo 的範例圖,最後一輪 APPROVED。

Claudex Loop 處理的是「動手寫程式之前」和「寫完之後」這兩段。你在 Claude Code 裡講需求,Claude 寫計畫;接著交給另一家公司的模型 Codex 審。Codex 每一輪都給一個結論:REVISE(要改)、APPROVED(過了)或 BLOCKED(卡住)。Claude 改完再送回同一個 Codex,直到過關或到輪數上限。計畫過了才寫程式,寫完再換沒寫程式的那一個來驗收。

官方 repo 範例圖:ROUND 1 到 4 是 REVISE(26、15、12、2 個問題),ROUND 5 是 APPROVED(0 個問題)
官方 repo 的範例圖(assets/run.svg)。README 說這是第一次回報的完整規劃,五輪共 55 個問題,是示範,不是對照實驗。
  1. 這篇會講:它到底在做什麼,誰寫、誰審、誰驗收。
  2. Claude Code 的安裝方式:兩行指令,可以直接複製。
  3. 怎麼開始一個 loop、只審現有計畫怎麼下指令、輪數怎麼改。
  4. 它需要什麼、什麼時候不要用,還有我自己沒跑過的部分。

02它是什麼:一個寫,另一個審,寫的人不准自己打分

Reels 畫面:橘色 Claw'd(Claude)和戴眼鏡的藍色 Claw'd(Codex)站在兩邊,中間的 PLAN.md 被蓋上「✗ 自己打分」,上方告示寫著「寫的人 ≠ 打分的人」
Reels 畫面:只有一條規則,寫的人不准自己打分。

Claudex Loop 是一組給 Claude Code 和 Codex 用的技能,MIT 授權、免費。repo 的介紹最後一句是「Whoever built it never grades it.」,意思就是:誰寫的,就不能由它自己打分數。

官方 README 的表格:從 Claude Code 開始,Codex 審計畫、Claude 寫程式、全新的 Codex 驗收;從 Codex 開始則反過來
官方 README:從哪一邊開始,就由另一邊審。
  1. 你在 Claude Code 裡開始:Claude 負責問需求、寫計畫,Codex 審計畫,預設由 Claude 寫程式,最後開一個全新的 Codex session 驗收。
  2. 你在 Codex 裡開始:反過來,Codex 寫計畫,Claude 審。
  3. 想讓 Codex 寫程式,加 builder=codex;驗收的永遠是另一個。
  4. 計畫寫在 PLAN.md,每一輪的意見、處理方式和結果記在 PLAN-REVIEW-LOG.md。

03第 1 步:在 Claude Code 安裝(兩行指令)

官方 README 的 Claude Code plugin 區塊,裡面是兩行 /plugin 安裝指令
官方 README 的 Claude Code 安裝區塊。

在 Claude Code 裡依序打這兩行:

安裝指令(在 Claude Code 裡打)
/plugin marketplace add chaseai-yt/claudex-loop
/plugin install claudex-loop@claudex-loop
  1. 裝好之後,指令會長這樣:/claudex-loop:claudex-loop(完整流程)、/claudex-loop:codex-review(只讓 Codex 審計畫)、/claudex-loop:codex-build(讓 Codex 寫程式)。
  2. Codex 那邊也能裝:把 repo 下載下來,把 skills/ 整個資料夾複製到 ~/.agents/skills/(Codex)和 ~/.claude/skills/(Claude Code),README 有 macOS / Linux 和 Windows PowerShell 的指令。
  3. 開一個新的 session,技能才會出現。

04第 2 步:開始一個 loop

Reels 畫面:PLAN.md 在 Claude 和 Codex 之間傳來傳去,上方五張卡片:第 1 輪 26 REVISE、第 2 輪 15、第 3 輪 12、第 4 輪 2、第 5 輪 0 APPROVED,中間蓋著 APPROVED
Reels 畫面:每一輪 Codex 挑毛病,Claude 改完再送審,直到 APPROVED(數字取自官方範例圖)。

在你的專案裡開 Claude Code,直接叫它跑完整流程,後面接你要做的功能:

完整流程:規劃、互審、實作、驗收(把[]換成你的功能)
/claudex-loop:claudex-loop [你要做的功能,例如:幫這個專案加上匯入 CSV 的功能,規劃完直接實作]

它會先看你的程式碼、列出它的假設請你確認,問清楚會影響結果的決定,再寫 PLAN.md。接著 Codex 開始審:

  1. Codex 讀計畫和相關程式碼,每個問題都要附上證據,最後給 REVISE、APPROVED 或 BLOCKED。
  2. REVISE:Claude 一條一條判斷,有道理的改進計畫,沒道理的寫下理由不改,再送回同一個 Codex。
  3. APPROVED:這份計畫的檔名和內容雜湊會被記下來,之後再改計畫,就要重新審。
  4. 預設最多審 5 輪;到上限還沒過,它會把沒解決的問題攤給你看,不會假裝過了。

如果你手上已經有一份計畫,只想讓它被審:

只審現有計畫(路徑換成你的)
claudex this plan, mode=review, plan=[PLAN.md 或 docs/你的計畫.md], rounds=3

05第 3 步:計畫過了才寫程式,寫完換人驗收

Reels 畫面:Claude 在紙筆電上寫程式,Codex 拿放大鏡檢查,上方貼著「計畫過了 ✓」「換人驗收 ⇄」「也能反過來:Codex 寫,Claude 驗」
Reels 畫面:寫的人和驗收的人一定不同。
  1. 寫程式的一方照 PLAN.md 做,開工前會記下當時的 commit;交給 Codex 寫的話,工作目錄要先是乾淨的(README:delegated builds require a clean checkout)。
  2. 它會先跑計畫裡約定好的驗證指令,再開一個全新的 session,讓另一個模型檢查所有改過的檔案。
  3. 驗收有意見就修,修完要再驗一次;預設最多修 2 次,驗收最多 2 次(第一次,加上修完後一次)。
  4. 最後它會給你:改了哪些、驗證結果、驗收看了哪些地方、還有哪些問題沒解決。
想讓 Codex 寫、Claude 驗收時(把[]換成你的功能)
/claudex-loop:claudex-loop [你要做的功能], builder=codex

06要注意

官方 README 的 Install 段落:兩個 CLI 都要安裝並登入,需要 Python 3.10 以上,不用另外的 API key
官方 README:兩個 CLI 都要裝好並登入。
  1. Claude Code 和 Codex CLI 都要裝好、登入,還要 Python 3.10 以上。不用另外申請 API key,但兩邊的帳號額度都會用到;審查那一邊額度用完,它不會偷偷換別的模型,只能等額度恢復。
  2. 小改動不要用。官方 SKILL.md 寫明「not for trivial edits」,改一行字直接改就好。
  3. APPROVED 是模型的判斷,不是保證。README 說,結果格式乾淨不代表模型是對的;問題數量多也不代表品質分數。測試還是要跑。
  4. 審查的一方是唯讀的:Codex 在唯讀沙盒裡跑,外掛和 MCP 伺服器會先關掉;Claude 只能讀檔和搜尋。
  5. repo 是 Chase AI 做的開源專案,README 最下面有他的付費社群連結;這篇沒有合作關係。
  6. 我沒有在自己的專案跑過完整流程:影片裡 26 → 0 是官方範例圖,這篇的指令都來自 README 和 SKILL.md。

資料來源

延伸閱讀