類型 /循環 5 分鐘 檢查部署 Claude Code 會每五分鐘檢查一次部署情況,直到你指示它停止為止。就是這樣。 克勞德代碼循環 大多數人都同意,而且它確實是個很棒的工具。不過,當你合上筆記型電腦時,它就會停止工作,並且會在七天後自動刪除。.
我經營著十家使用無人值守 Claude Code 代理的企業,光是這個容器自 2026 年 6 月 12 日以來就已產生了超過 1800 條運行日誌。這些運行日誌均未使用。 /環形. 那不是因為 /環形 很糟糕。這是因為它最初是為其他用途而設計的。.
這篇 Claude Code 循環指南涵蓋了這兩種情況。您將了解 Claude Code 中的三種循環類型及其具體用法。 /環形 行為(間隔、自我調節節奏、, 循環.md, (抖動,7天有效期),它與…相比如何 /目標, 停止鉤子、bash 風格的「Ralph」循環以及運行我艦隊的 cron 循環。所有數字都來自截至 2026 年 10 月的官方文件或我自己的日誌,我會告訴你哪個是哪個。.
克勞德程式碼循環究竟是什麼(共三種)

搜尋結果中的大多數文章都將「循環」視為一個單一的概念。但實際上,Claude Code 中有三個循環,它們彼此嵌套。大多數混淆都源自於對它們的誤解。.
循環 1:代理循環(在一個回合內)
Claude Code 的每一次運行都是一個循環。 Claude 讀取你的提示,呼叫一個工具,讀取結果,然後決定下一步。它會一直循環,直到它認為任務完成為止。這項功能是免費的,你無需輸入任何代碼來啟用它。.
循環 2:會話循環(回合間)
這裡 /環形 和 /目標 活著。他們保持 一次公開會議 追逐回合通常會將控制權交還給你。. /環形 當時間間隔過去後,開始下一回合。. /目標 當另一位評估人員認定你的條件尚未滿足時,程式就會啟動。.
循環 3:外層循環(會話之間)
這開始了 全新 Claude Code 會話依計畫執行,完成一項任務後退出。 Cron 加 克勞德-p, Anthropic 的雲端定時任務、桌面定時任務和 GitHub Actions 都運行在這裡。我的叢集也運行在這裡。這是我之前規劃的自主化階梯的頂端。 人工智慧編碼代理究竟是什麼?.
| 環形 | 下一輪傳球從哪裡開始? | 關閉終端後還能繼續運作嗎? | 最適合 |
|---|---|---|---|
| 代理循環 | 最後一個工具的結果 | 不適用(一圈) | 每個任務,自動執行 |
/環形 | 克勞德選擇的時間間隔,固定的或選定的 | 不 | 邊工作邊投票 |
/目標 | 如果條件不滿足,則上一回合結束。 | 否(恢復後已恢復) | 朝著可檢查的最終狀態努力 |
| 外層循環(cron、雲端、桌面、CI) | 時鐘或事件 | 是的 | 無人值守的重複性工作 |
透過問一個問題來選擇你的 Claude Code 循環: 是否有人正在開啟此會話? 如果答案是肯定的,請使用會話循環。如果工作必須在凌晨 3 點你睡覺的時候進行,則需要使用外層循環。在這種情況下運行會話循環就像打開終端然後祈禱一樣。.
/loop 指令的工作原理:固定間隔、自主控制節奏和 loop.md 文件

/環形 是一個 捆綁技能. 這兩個參數都是可選的,你給它的參數決定了它的行為。.
| 你輸入 | 會發生什麼 |
|---|---|
/循環 5 分鐘 檢查部署 | 您的提示符號按固定計劃運行(已轉換為 cron) |
/loop 檢查部署 | 自主控制節奏:克勞德每次跑完後都會選擇一個1分鐘到1小時之間的延遲時間。 |
/環形 或者 /循環15米 | 運行你的 循環.md 如果有的話,否則會顯示內建的維護提示 |
固定間隔
設定時間間隔,Claude 會將其轉換為 cron 表達式,進行調度,並確認作業 ID。單位是 s, m, h 和 d. 間隔可以放在前面(30米)或最後(「每 2 小時」)。秒數向上取整到整分鐘,因為 cron 無法安排比 1 分鐘更精確的時間間隔。不能被整除的時間間隔,例如 7米 或者 90米, 取最接近的整數,然後克勞德會告訴你它選了哪一個。.
自主學習
如果省略間隔,Claude 會根據每次觀察到的情況自行選擇間隔時間。建造完成後,它會等待較短時間;而當沒有任何操作發生時,等待時間則會延長。每次循環結束後,它都會列印延遲時間和原因,以便您了解它的運行思路。自同步循環還可以在工作完成後自動結束。在底層,Claude 會呼叫其… 定時叫醒 工具 停止:真. 如果一次循環結束時既沒有安排下一次循環也沒有停止,Claude Code 會在大約 20 分鐘後設置一個備用喚醒。如果該備用喚醒也沒有安排任何操作,則循環結束。.
裸 /loop 和 loop.md
裸露 /環形 它會運行內建的維護提示。它會完成未完成的工作,處理目前分支的 PR(審核評論、失敗的 CI、合併衝突),然後進行清理工作,例如尋找 bug。它不會創建新項目。推送或刪除等風險操作只有在討論獲得批准後才會執行。.
若要使用您自己的預設提示符,請建立 .claude/loop.md (投影儀 ~/.claude/loop.md (用戶)。如果兩個檔案都存在,則專案文件優先。像輸入提示符一樣編寫。變更會在下一次循環中生效,因此您可以在循環運行時進行調整。超過 25,000 位元組的內容將被截斷。.
你也可以循環使用某個技能: /循環 20分鐘 /review-pr 1234. 但這裡有個問題。預定的運行只會執行克勞德的技能。 允許自行調用. 內建指令如 /模型, 技能標記 禁用模型呼叫:true, 而且,MCP 提示會以純文字形式傳回,而不是運行。如果你的循環技能“沒有任何反應”,請先檢查這一點。.
阻止它
這個很容易讓人上當。 自主學習 按下按鈕循環停止 Esc鍵 在等待期間。 固定區間 循環忽略 Esc鍵 和 Ctrl+C. 你必須讓 Claude 取消它(「取消部署檢查循環」),否則它會一直運行到七天期限到期。底層工具是 CronCreate, 定時任務列表 和 定時刪除. 每個任務都會獲得一個 8 個字元的 ID,一個會話最多可以容納 50 個任務。.
細則:抖動、7天有效期限以及蓋上蓋子後會發生什麼

本學期大多數排名靠前的指南都忽略了這些限制。如果你想嘗試治療,那麼每個限制都至關重要。 /環形 作為調度員。.
| 行為 | 文件怎麼說(2026年10月) | 這對你意味著什麼 |
|---|---|---|
| 會話必須處於開啟狀態 | 任務僅在 Claude Code 運行且空閒時觸發。 | 關閉終端,循環就會停止。後台會話可以繼續執行此操作。. |
| 繁忙的會議 | 到期提示會等到目前回合結束後才會發出。 | 當克勞德正在執行任務時,你「每隔5分鐘」的提醒可能會失效。 |
| 錯失的跑步機會 | 無追趕機制:空閒時觸發一次,而不是每個錯過的時間間隔觸發一次。 | 不要將其用於任何需要計算跑分的操作。 |
| 抖動(反覆出現) | 列車運行延遲時間最多可達預定時間的一半,上限為 30 分鐘。整點或每日列車運轉延遲 0-30 分鐘。. | 每天上午 9 點的例行檢查可能會在 9:27 運行。 |
| 抖動(每 5 分鐘一次) | */5 上次跑步後 4 分 45 秒再次跑步 | 快速輪詢結果穩定(優於 5 分鐘提示快取)。 |
| 一次性觸發,時間為 0:00 或 0:30 | 最多可提前 90 秒運轉。 | 在一些奇怪的時間安排提醒,例如 3 9 * * * |
| 到期日 | 重複性任務會在建立後最後一次執行,並在 7 天後自動刪除。 | 這裡不可能找到一份每週固定、長期穩定的工作。 |
| 恢復 | 定時任務已恢復 - 恢復; ;自主學習 /環形 不是 | 重播 /環形 重啟後 |
| 終止開關 | CLAUDE_CODE_DISABLE_CRON=1 禁用調度程序和 /環形 | 在共享或持續整合環境中非常有用 |
時代使用你的 當地時區, 不是 UTC 時間。文件中的比較表格將最低時間為一分鐘。 /環形, 當 Claude 設定桌面任務時,雲端排程任務的等待時間為一小時,桌面任務的等待時間為一分鐘(表單中顯示為一小時)。.
七天過期時間是設計特性,並非漏洞。它的作用是防止你忘記的循環導致代幣在一個月內被銷毀。如果你覺得這個限制很煩人,那麼你的工作就需要用到外層循環。.
這是根據我的日曆計算出的到期時間。這個容器已經運作了 137 天。 /環形 做同樣的事情大約會過期並需要重新創建 19 次,而且只有在終端一直打開的情況下才會發生這種情況。.

取得人工智慧策略手冊
10 家無人值守企業的具體循環、逾時和結果行,以及本週出現的所有故障。完全免費,您可以隨時離開。.
/loop 對陣 /goal 對陣 Stop Hooks 對陣 Ralph Loop

“「Claude Code loop」現在涵蓋了四種不同的工具。以下是如何選擇。.

⚡ 取得人工智慧優勢
每週提供真正省時省錢的AI小技巧。沒有廢話,沒有誇大其詞——只有切實有效的方法。.
目標:循環直到條件為真
/goal test/auth 目錄下的所有測試都通過,而且 lint 檢查步驟也合格。 立即開始回合。每個回合結束後, 分離 模型會檢查條件是否成立。如果不成立,克勞德會開始新一輪行動。當條件滿足、評估器認為不可能或你運作後,目標就會清除。 進球. 每次會話中,你可以設定一個目標,目標內容最多可以包含 4000 個字元。.
有兩個細節很重要。首先是評估者。 它本身不運行命令或讀取文件。. 它只會判斷克勞德在對話中輸入的內容。因此,請編寫克勞德可以通過輸出證明的條件,例如“npm 測試 出口 0」。其次,, /目標 不會改變你的權限模式。在手動模式下,它仍然會在呼叫你未授權的工具之前停止並詢問。增加一個限制,例如“或20回合後停止”,這樣它就不會一直運行下去。.
停止鉤子:/goal 的永久版本
停止鉤子也會在每回合結束後觸發,但它存在於你的設定檔中,並應用於該作用域內的所有會話。它可以運行腳本來執行必須精確的檢查,或提示你進行需要判斷的檢查。 /目標 用於一次性工作和每次都希望執行的規則的停止鉤子。.
拉爾夫循環:圍繞整個東西猛擊
在這一切建成之前,人們把克勞德包裹在一個殼裡。 儘管 不斷循環的相同物料 提示.md 進入一個全新的運行。傑弗裡·亨特利(Geoffrey Huntley)將其命名為“拉爾夫”(Ralph)。每次運行都從一個乾淨的上下文開始,並從磁碟上的檔案中讀取進度。它有效,而且極為簡單。它也沒有內建的停止規則、預算上限和進度安排。這三者都需要你自己加。.
| 你想要… | 使用 |
|---|---|
| 工作時每隔幾分鐘檢查一下。 | /循環 5 分鐘… |
| 不選擇節奏就照顧PR | /環形 … (自主學習) |
| 堅持不懈,直到測試通過或積壓工作全部完成。 | /目標 … (附旋轉帽) |
| 在每次會話中強制執行「直到達到 X 才停止」的原則 | 止鉤 |
| 在全新的環境中執行大型任務,直到完成為止。 | 拉爾夫式 bash 循環(加蓋) |
| 每天都運行一個任務,筆記型電腦關著。 | 外循環:cron + 克勞德-p, 雲端或桌面定時任務,或 GitHub Actions |
我實際運行的循環:Cron 加上一次全新的 Claude 會話,超過 1800 次

以下是本網站背後的 Claude Code 循環:一個外層循環,故意寫得比較枯燥。一個簡單的調度器會讀取… schedule.json 並在每個時間槽呼叫一個 shell 調度器。調度器啟動一個全新的無頭 Claude Code 會話,並執行一條指令:讀取並執行此技能檔。.
claude --print --dangerously-skip-permissions -p "$INSTRUCTION" < /dev/null
這個標誌之所以有意義,是因為每個品牌都在各自獨立的 Docker 容器中運作。我在我的文章中介紹了具體的設定。 Claude Code 沙箱編寫. 不要把那一行複製到你的筆記型電腦上。.
這些數字(根據該貨櫃的日誌統計,2026年10月26日)
| 指標 | 價值 |
|---|---|
| 自 2026 年 6 月 12 日以來的運行日誌 | 1,806 歷時137天 |
| 每日活躍槽位 | 12(每小時的07分) |
| 每週活躍時段 | 10(在 :07 或 :37,絕不在整點) |
| 每個時隙的超時 | 30 到 90 分鐘(這位部落客獲得了 90 分鐘) |
| 演出時間:9月26日至10月25日 | 402 項技能 |
結束 成功 / 跳過 / 失敗 | 369 / 16 / 1 |
| 完全沒有結果行 | 16 |
/環形 或者 /目標 生產中的呼叫 | 0 |
為什麼外循環在無人值守工作上更勝一籌
- 每次運行都會有新的上下文。. 每個任務開始時都是空白的,並從文件中讀取所需資訊:它的技能,, CLAUDE.md 以及記憶體日誌。一個持續數天的循環會話會累積大量上下文資訊。我的會話從來不會執行超過一個任務。.
- 每個插槽都有嚴格的超時限制。. 如果運行掛起,調度器會終止它。失控的
/目標只有當評估員示意停止時才會停止。. - 每個插槽配一把鎖。. 調度器會寫入一個以日期、插槽和任務命名的鎖定檔案。只有第一個到達的文件才能運行,舊的鎖文件每天都會被清理。兩個調度器同時執行任務無法發布兩個帖子。.
- 一條可以計數的結果線。. 每項技能都必須以…結尾
技能結果:成功|跳過|失敗. 這就是我如何得出上面表格的原因。目前我的弱點是那 16 次沒有結果行的運行。它們都正常退出,列印了簡潔的摘要,但跳過了腳本可以計數的那一行。. - 奇數分鐘時段。. 整點不會觸發任何任務。每日任務的觸發時間是 07:00,每週任務的觸發時間是 07:00 或 037:00。這與文件中一次性任務的建議一致,這可以避免我的任務在每次呼叫 API 時都面臨整點高峰。.
那麼,它在哪裡呢? /環形 適合我嗎?在需要調整部署流程的互動環節中:例如觀察緩慢的部署流程,或是在我審核其他內容時照看某個分支。這正是它存在的意義。不過,有一點要注意:無人值守並不代表無人審核。我的代理商已經提交了數百張審批卡,而且 只有當有人完成閉環時,循環中的人才算數。.
如果你想用這種外循環模式來運行你自己的重複性工作(內容創作、收件匣分類、潛在客戶跟進),而無需花費數月時間反覆試驗,這就是我的建議。 現成的自動化構建 是為了。 克勞德代碼最佳實踐 帖子內容涵蓋了我首先要製定的規則。.
今天你可以複製的 Claude Code Loop 配方

五種圖案,從最小到最大。每一種都有明確的終止方式,因為沒有終止方式的克勞德密碼環只是一張鈔票。.
1.部署監視器(固定、短生命週期)
/loop 2m 檢查生產環境部署是否完成。如果失敗,拉取錯誤日誌並總結原因。成功或失敗後,通知我並取消此循環。.
2. 公關保母(自主學習)
/loop 檢查 PR 1234:如果 CI 顯示紅色,則讀取失敗的作業日誌並推送最小的修復;如果有新的審查意見,則逐一處理。如果 CI 顯示綠色且一切正常,則以一行文字說明。當 PR 合併後停止。.
3. 專案循環.md
# .claude/loop.md 檢查發布版本/下一個 PR。用盡可能小的改動修復紅色 CI。回覆新的程式碼審查意見。永遠不要推送到主分支。永遠不要刪除分支。如果沒有需要做的事情,回覆"quiet",下次再等等。.
4. 有上限的目標
/goal src/legacy/ 中的每個檔案都從新的 api 用戶端匯入,`npm test` 退出程式碼為 0,並且沒有測試檔案被修改,或在 25 回合後停止並報告剩餘內容。.
5. 外環大約有 10 行
# crontab: 每小時運行 7 次,但從不在整點運行 7 * * * * /opt/agents/run-job.sh inbox-triage # run-job.sh #!/usr/bin/env bash set -euo pipefail 1TP4(mpdate/date +%F-%H)-$1.lock" ( set -o noclobber; : > "$LOCK" ) 2>/dev/null || exit 0 timeout 30m claude -p "讀取 skills/$1.md 並執行它。 "/var/log/agents/$(date +%F_%H-%M)_$1.log" 2>&1
第 5 個方案只是一個入門範例,並非我的完整腳本。在無人值守運行之前,請新增權限規則(或沙箱)和警報。我發送了一個 每次糟糕的跑步都會收到 Telegram 訊息. 如果一項工作不斷「簽到」卻沒有任何改變,請參考我的數據。 主動型經紀人是否值得聘用 在添加更多循環之前。.
克勞德代碼循環常見問題解答

如何讓 Claude Code 循環執行直到任務完成?
使用 /目標 克勞德可以在其輸出中證明一個條件,再加上一個回合限制。例如:「“npm 測試 出口 0,或轉彎 20 次後停止。 ” 使用 /環形 如果「完成」指的是時間的流逝,例如部署結束,則無需設定間隔。 Claude 可以自行結束一個自定節奏的循環。.
關閉終端機後,/loop 指令還會繼續運作嗎?
不。會話作用域的任務僅在 Claude Code 運作且空閒時觸發。將會話移至背景不會影響會話的執行。 /環形 任務完成。對於任何需要在筆記型電腦合上後仍然運行的任務,請使用雲端定時任務、桌面定時任務、GitHub Actions 或 cron。 克勞德-p.
如何停止 Claude Code 循環?
如需進行自定節奏循環播放,請按 Esc鍵 在等待期間。對於像這樣的固定間隔循環 /循環 5米, 讓 Claude 取消,或問「我有哪些已排程的任務?」然後按 ID 取消。. Esc鍵 阻止不了那些人。.
最短間隔是多少?
一分鐘。 Cron 已經無法再精細調整了,所以 30年代 向上取整 1米.
我的循環為什麼過期了?
循環會話任務會在建立七天後(即最後一次執行後)自動刪除。請在此之前重新建立該任務,或將其移至外層循環。.
/loop 和 Ralph 循環是一樣的嗎?
不。. /環形 在同一會話中,按定時器重複執行提示符號。 Ralph 式循環是一種 shell 操作。 儘管 每次循環都會啟動新的 Claude 運行,並將進度儲存到檔案中。 Ralph 循環每次運行都會獲得一個全新的上下文。. /環形 保留會話上下文,這有助於短期監控,但長期運作會有不利影響。.
循環迴路成本更高嗎?
每次循環都是模型完整旋轉,所以是的。這就是為什麼自定節奏循環在無事發生時會等待更長時間,以及為什麼 */5 為了保持在提示快取範圍內,輪詢會提前開始。上限開啟 /目標, 限制外層循環的時間,並取消 /環形 你已經不再觀看的劇集。.
結論:選擇 Who's Watching 的《循環》
克勞德程式碼循環並非單一功能,而是一種選擇。 在哪裡 重複發生。在回合中,克勞德已經為你循環播放。在會話中,, /環形 處理時間安排和 /目標 終點線處理得非常出色,而且當你在現場觀看時,兩者都非常棒。在會議之外,一個簡單的日程安排器會開啟一段新的旅程。 克勞德-p run 程式在凌晨 3 點依然正常運作。它已經為本網站的十個品牌車隊運行了 1800 多次,而且無人值守。.
從小處著手。 /環形 下次部署時,如果某個作業以相同的方式運行了一周,就將其移到外層循環,並設定逾時、鎖定和可計數的返回值。如果您不想進行反覆試驗,, 預約自動化策略會議 我們會確定哪些作業應該循環執行。.

取得人工智慧策略手冊
每週:介紹艦隊中的一套系統,它的成本,以及讓我學到東西的日誌要點。絕無廢話,隨時可以取消訂閱。.

📥 免費:《人工智慧劇本》
我用來經營一人代理公司的所有工具和工作流程。 25 年的行銷經驗濃縮成一份實用指南。免費贈送。.
