一、Loop 到底解決什么問題？

用 Claude Code 寫代碼，你大概率遇到過這個場景：

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

測試沒過？它把報錯貼給你，等你下一步指令。邏輯沒寫完？它聲稱"已完成"就交差了。

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

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

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

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

二、三種用法，從最簡單到最實用

入門不用貪多。先認識這三種，按場景挑一種用就夠了。

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

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

# 第一步：先讓 Claude 生成任務(wù)清單
claude -p "列出所有需要從 React 遷移到 Vue 的文件" > migration-list.txt
# 第二步：循環(huán)處理每個文件
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

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

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

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

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

# 添加插件市場
/plugin marketplace add anthropics/claude-code

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

# 重載插件
/reload-plugins

運行：

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

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

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

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

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

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

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

下面三個案例，照著抄就能感受到 loop 的威力。建議從案例一開始，一步步來。

案例一：5 分鐘體驗——寫一個帶測試的小函數(shù)

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

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

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

如果你還沒裝插件，用 bash 版也能體驗類似效果：

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

案例二：好提示詞 vs 壞提示詞（這一節(jié)決定你成?。?/h3>

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

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

做一個 todo API，做好一點。

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

/ralph-wiggum:ralph-loop "做一個 todo 的 REST API。

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

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

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

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

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

/ralph-wiggum:ralph-loop "用 TDD 方式實現(xiàn)購物車的'添加商品'功能：
1. 先寫會失敗的測試
2. 實現(xiàn)功能
3. 運行測試
4. 如果有測試失敗，調(diào)試并修復(fù)
5. 需要的話重構(gòu)
6. 重復(fù)直到所有測試通過
全部變綠后輸出 DONE。" --completion-promise "DONE" --max-iterations 20

進階小技巧——給"卡住"留個出口，在提示詞末尾加上：

如果 10 輪后仍無法完成：
- 記錄是什么卡住了進度
- 列出你試過的方法
- 給出替代方案建議
完成時輸出 DONE，被卡住時輸出 STUCK。

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

四、什么時候用、什么時候別用

適合 loop 的場景：

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

不適合 loop 的場景：

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

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

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

結(jié)語

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

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

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

從案例一開始，今天就跑一次試試。

本文為 JeecgBoot AI 專題研究系列文章。

到此這篇關(guān)于Claude Code Loop快速入門指南:從一行命令到自動迭代的文章就介紹到這了,更多相關(guān)Claude Code Loop詳解內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論