一、Loop 到底解決什么問(wèn)題？

用 Claude Code 寫(xiě)代碼，你大概率遇到過(guò)這個(gè)場(chǎng)景：

把需求丟給它 → 它忙活一陣 → 輸出一堆代碼 → 停了。

測(cè)試沒(méi)過(guò)？它把報(bào)錯(cuò)貼給你，等你下一步指令。邏輯沒(méi)寫(xiě)完？它聲稱"已完成"就交差了。

這不是 Claude 不夠聰明，而是它默認(rèn)是單輪執(zhí)行——做完一輪推理就認(rèn)為任務(wù)結(jié)束，不會(huì)主動(dòng)回頭跑測(cè)試、發(fā)現(xiàn)問(wèn)題、再改一遍。

Loop（循環(huán)）就是來(lái)填這段空白的：讓 Claude 自動(dòng)"寫(xiě)代碼 → 驗(yàn)證 → 發(fā)現(xiàn)問(wèn)題 → 再改"，反復(fù)迭代，直到達(dá)成你定義的"完成標(biāo)準(zhǔn)"才停。

入門階段你只需要記住三件事：

• loop 不神奇，它會(huì)放大你的提示詞——要求寫(xiě)得清楚，效果驚人；寫(xiě)得模糊，它會(huì)無(wú)限猜測(cè)"什么叫完成"。
• 完成標(biāo)準(zhǔn)必須可量化（測(cè)試通過(guò)、構(gòu)建成功、接口跑通），不能是"做得好一點(diǎn)"。
• 永遠(yuǎn)設(shè)上限（最大迭代次數(shù)），這是成本的安全閥，省略它等于讓 AI 燒光你的額度。

二、三種用法，從最簡(jiǎn)單到最實(shí)用

入門不用貪多。先認(rèn)識(shí)這三種，按場(chǎng)景挑一種用就夠了。

用法 A：bash 循環(huán)（零安裝，最簡(jiǎn)單）

適合批量處理一堆能列出來(lái)的文件/任務(wù)，比如批量遷移、批量審查。本質(zhì)就是用普通的 shell 循環(huán)反復(fù)調(diào)用 claude -p（headless 模式，傳入提示詞、跑完就退出）。

# 第一步：先讓 Claude 生成任務(wù)清單
claude -p "列出所有需要從 React 遷移到 Vue 的文件" > migration-list.txt
# 第二步：循環(huán)處理每個(gè)文件
for file in $(cat migration-list.txt); do
  claude -p "把 $file 從 React 遷移到 Vue" \
    --allowedTools "Edit,Bash(git commit:*)" \
    --max-turns 40 \
    --max-budget-usd 2
done

要點(diǎn)：--allowedTools 限定它能用哪些工具，避免亂來(lái)。--max-turns 和 --max-budget-usd 是成本剎車，務(wù)必帶上。

用法 B：Ralph Loop 插件（裝一下就能用，適合長(zhǎng)任務(wù)）

適合從零搭新項(xiàng)目、可以掛后臺(tái)跑的長(zhǎng)任務(wù)（睡前啟動(dòng)、醒來(lái)看結(jié)果）。它通過(guò)"停止鉤子"在 Claude 每次想退出時(shí)攔住它，把任務(wù)重新喂回去，直到 Claude 輸出你約定的完成關(guān)鍵詞。

安裝（需要 Claude Code 2.0.76 以上）：

# 添加插件市場(chǎng)
/plugin marketplace add anthropics/claude-code

# 安裝 Ralph Wiggum 插件
/plugin install ralph-wiggum@claude-code-plugins

# 重載插件
/reload-plugins

運(yùn)行：

/ralph-wiggum:ralph-loop "<任務(wù)描述>" --completion-promise "DONE" --max-iterations 10

三個(gè)參數(shù)：任務(wù)描述越具體越好；--completion-promise 是完成后必須輸出的關(guān)鍵詞，循環(huán)靠它判斷是否結(jié)束；--max-iterations 是最大迭代次數(shù)，別省略。

中途想停：/ralph-wiggum:cancel-ralph

用法 C：自定義 /loop 命令（驗(yàn)證最可信，適合嚴(yán)肅工程）

適合已有項(xiàng)目里修 bug/重構(gòu)，且項(xiàng)目已經(jīng)有能跑出"綠/紅"的檢查命令（test、lint、類型檢查等）。

它的精髓是把"寫(xiě)"和"驗(yàn)"拆成兩個(gè) Agent：一個(gè)只寫(xiě)代碼，一個(gè)只跑檢查且在工具層面就沒(méi)有改文件的權(quán)限，所以它沒(méi)法自欺欺人地說(shuō)"我做完了"。這種做法更穩(wěn)，但需要寫(xiě)幾個(gè)配置文件，屬于進(jìn)階。入門可以先跳過(guò)，用熟了 A 和 B 再回來(lái)看。

三、入門實(shí)戰(zhàn)：三個(gè)由淺入深的案例

下面三個(gè)案例，照著抄就能感受到 loop 的威力。建議從案例一開(kāi)始，一步步來(lái)。

案例一：5 分鐘體驗(yàn)——寫(xiě)一個(gè)帶測(cè)試的小函數(shù)

這是最適合第一次嘗試的任務(wù)：小、可驗(yàn)證、能明顯看到"每輪在變好"。

/ralph-wiggum:ralph-loop "寫(xiě)一個(gè)校驗(yàn)郵箱地址的 Python 函數(shù)。
要求：處理邊界情況，并寫(xiě) 3 個(gè)測(cè)試用例。
全部完成后輸出 DONE。" --completion-promise "DONE" --max-iterations 5

你會(huì)觀察到：第一輪可能只是基礎(chǔ)實(shí)現(xiàn)，后幾輪逐漸加上邊界處理、優(yōu)化錯(cuò)誤提示、補(bǔ)全測(cè)試覆蓋。輸出質(zhì)量一輪比一輪高——這就是 loop 的價(jià)值。

如果你還沒(méi)裝插件，用 bash 版也能體驗(yàn)類似效果：

claude -p "寫(xiě)一個(gè)校驗(yàn)郵箱的 Python 函數(shù)，含邊界處理和 3 個(gè)測(cè)試，并運(yùn)行測(cè)試確認(rèn)全過(guò)" \
  --allowedTools "Write,Edit,Bash" --max-turns 10

案例二：好提示詞 vs 壞提示詞（這一節(jié)決定你成敗）

同樣的任務(wù)，提示詞差一點(diǎn)，結(jié)果天差地別。這是 loop 入門最重要的一課。

壞提示詞——Claude 不知道什么叫"好"，容易無(wú)限循環(huán)：

做一個(gè) todo API，做好一點(diǎn)。

好提示詞——給出明確的完成清單：

/ralph-wiggum:ralph-loop "做一個(gè) todo 的 REST API。

完成標(biāo)準(zhǔn)：
- 所有增刪改查接口都能用
- 有輸入校驗(yàn)
- 測(cè)試通過(guò)，覆蓋率 80% 以上
- 有 README 寫(xiě)明 API 文檔

全部滿足后輸出 COMPLETE。" --completion-promise "COMPLETE" --max-iterations 15

記住這個(gè)公式：任務(wù) + 可勾選的完成清單 + 完成關(guān)鍵詞。清單上每一條都要是"能客觀判斷對(duì)錯(cuò)"的，這樣 loop 才有明確的前進(jìn)方向，不會(huì)陷入"猜你想要什么"的內(nèi)耗。

案例三：內(nèi)嵌"自我糾錯(cuò)"邏輯——TDD 循環(huán)

把迭代規(guī)則直接寫(xiě)進(jìn)提示詞，讓測(cè)試結(jié)果成為循環(huán)的"燃料"——每次失敗都讓下一輪更精準(zhǔn)。

/ralph-wiggum:ralph-loop "用 TDD 方式實(shí)現(xiàn)購(gòu)物車的'添加商品'功能：

1. 先寫(xiě)會(huì)失敗的測(cè)試
2. 實(shí)現(xiàn)功能
3. 運(yùn)行測(cè)試
4. 如果有測(cè)試失敗，調(diào)試并修復(fù)
5. 需要的話重構(gòu)
6. 重復(fù)直到所有測(cè)試通過(guò)

全部變綠后輸出 DONE。" --completion-promise "DONE" --max-iterations 20

進(jìn)階小技巧——給"卡住"留個(gè)出口，在提示詞末尾加上：

如果 10 輪后仍無(wú)法完成：
- 記錄是什么卡住了進(jìn)度
- 列出你試過(guò)的方法
- 給出替代方案建議
完成時(shí)輸出 DONE，被卡住時(shí)輸出 STUCK。

這樣即使任務(wù)失敗，你也能拿到一份診斷報(bào)告，而不是白燒 token。

四、什么時(shí)候用、什么時(shí)候別用

適合 loop 的場(chǎng)景：

• 成功標(biāo)準(zhǔn)可量化（測(cè)試通過(guò)、構(gòu)建成功、接口跑通）
• 需要反復(fù)"寫(xiě)代碼 → 跑測(cè)試 → 修 bug"的迭代任務(wù)
• 全新項(xiàng)目從零增量搭建
• 可以掛后臺(tái)、睡前啟動(dòng)、醒來(lái)看結(jié)果的長(zhǎng)任務(wù)

不適合 loop 的場(chǎng)景：

• 需要主觀判斷的決策（UI 設(shè)計(jì)、架構(gòu)取舍）
• 簡(jiǎn)單的一次性任務(wù)（沒(méi)必要套循環(huán)）
• 成功標(biāo)準(zhǔn)本身說(shuō)不清楚（沒(méi)有關(guān)鍵詞能觸發(fā)結(jié)束）
• 生產(chǎn)環(huán)境定向排查 bug（這種更需要人來(lái)指揮）

五、新手最該記住的 5 條成本與避坑原則

1. --max-iterations / --max-turns 必填。大多數(shù)任務(wù) 10–20 次足夠，復(fù)雜項(xiàng)目 30–50 次。沒(méi)有上限的循環(huán) = 沒(méi)有終點(diǎn)的馬拉松。
2. 先用小上限試跑，驗(yàn)證提示詞邏輯沒(méi)問(wèn)題，再加大次數(shù)。
3. 完成標(biāo)準(zhǔn)越具體越省錢。模糊的要求讓 AI 反復(fù)猜測(cè)，猜測(cè)就是在燒錢。
4. 簡(jiǎn)單任務(wù)用便宜的模型配置就行，不必每輪拉滿。
5. 任務(wù)太大就拆階段。與其讓它一口氣做完整個(gè)電商系統(tǒng)，不如拆成"階段 1：登錄鑒權(quán) → 階段 2：商品目錄 → 階段 3：購(gòu)物車"，每個(gè)階段驗(yàn)證通過(guò)再進(jìn)下一個(gè)。

總結(jié)

Loop 改變的不是 Claude 的智商，而是它的工作模式——從"給你一個(gè)答案"變成"直到做對(duì)為止"。

而你的角色也變了：以前你是質(zhì)檢員，要肉眼盯著每一行 AI 寫(xiě)的代碼；現(xiàn)在你是需求方，輸入任務(wù)、設(shè)好完成標(biāo)準(zhǔn)、審一眼最終結(jié)果就行。

技術(shù)本身不復(fù)雜，門檻只有一個(gè)：你得會(huì)把"什么叫完成"說(shuō)清楚。

從案例一開(kāi)始，今天就跑一次試試。

以上就是Claude Code自動(dòng)迭代Loop模式的從零上手實(shí)戰(zhàn)指南的詳細(xì)內(nèi)容，更多關(guān)于Claude Code自動(dòng)迭代Loop模式的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！