Skip to main content
排程任務讓 Claude 按間隔自動重新執行提示。使用它們來輪詢部署、監督 PR、檢查長時間執行的建置,或在工作階段稍後提醒自己執行某些操作。若要改為對事件發生時做出反應而不是輪詢,請參閱 Channels:您的 CI 可以直接將失敗推送到工作階段中。若要保持工作階段逐輪執行直到符合條件而不是按間隔執行,請參閱 /goal 任務的範圍限於工作階段:它們存在於目前的對話中,當您啟動新的對話時就會停止。使用 --resume--continue 繼續會恢復任何尚未過期的任務:在過去 7 天內建立的重複執行任務,或排程時間尚未到達的一次性任務。對於獨立於任何工作階段而存在的排程,請使用 Routines 在 Anthropic 管理的基礎設施上建立例行程序、設定 Desktop 排程任務,或使用 GitHub Actions

比較排程選項

Claude Code offers three ways to schedule recurring or one-off work:
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.

使用 /loop 重複執行提示

/loop bundled skill 是在工作階段保持開啟的情況下重複執行提示的最快方式。間隔和提示都是選用的,您提供的內容決定了迴圈的行為方式。 您也可以傳遞一個 skill 作為提示,例如 /loop 20m /review-pr 1234,以在每次迭代時重新執行該 skill。自 v2.1.196 起,排程的執行只會執行 Claude 允許自行叫用的 skill。以下內容會以純文字形式傳達給 Claude,而不是執行:

在固定間隔上執行

當您提供間隔時,Claude 會將其轉換為 cron 表達式、排程工作,並確認頻率和工作 ID。
間隔可以作為裸令牌(如 30m)在提示前面,或作為子句(如 every 2 hours)在後面。支援的單位為 s(秒)、m(分鐘)、h(小時)和 d(天)。 秒數會四捨五入到最近的分鐘,因為 cron 的粒度為一分鐘。不能均勻分割其單位的間隔(例如 7m90m)會四捨五入到最近的整潔間隔,Claude 會告訴您它選擇了什麼。

讓 Claude 選擇間隔

當您省略間隔時,Claude 會動態選擇一個,而不是在固定的 cron 排程上執行。在每次迭代後,它會根據觀察到的情況選擇一個介於一分鐘到一小時之間的延遲:在建置完成或 PR 活躍時短暫等待,當沒有待處理項目時較長等待。選擇的延遲和原因會在每次迭代結束時列印。 下面的範例檢查 CI 和審查評論,Claude 在 PR 變得安靜後在迭代之間等待更長時間:
當您要求動態 /loop 排程時,Claude 可能會直接使用 Monitor tool。Monitor 執行背景指令碼並串流回每個輸出行,這完全避免了輪詢,通常比在間隔上重新執行提示更具令牌效率和回應性。 動態排程的迴圈會像任何其他任務一樣出現在您的排程任務清單中,因此您可以以相同的方式列出或取消它。抖動規則不適用於它,但七天過期適用:迴圈在您啟動它七天後自動結束。
在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上,沒有間隔的提示會改為在固定的 10 分鐘排程上執行。

執行內建維護提示

當您省略提示時,Claude 會使用內建維護提示而不是您提供的提示。在每次迭代上,它會按順序進行以下操作:
  • 繼續對話中任何未完成的工作
  • 照顧目前分支的拉取請求:審查評論、失敗的 CI 執行、合併衝突
  • 執行清理通過,例如當沒有其他待處理項目時的錯誤搜尋或簡化
Claude 不會在該範圍之外啟動新的計畫,不可逆的操作(例如推送或刪除)只在它們繼續文字記錄已授權的內容時進行。
/loop動態選擇的間隔上執行此提示。新增間隔(例如 /loop 15m)以改為在固定排程上執行它。若要用您自己的預設值替換內建提示,請參閱使用 loop.md 自訂預設提示
在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上,沒有提示的 /loop 會列印使用訊息而不是執行維護提示。

使用 loop.md 自訂預設提示

loop.md 檔案用您自己的指示替換內建維護提示。它為裸 /loop 定義單一預設提示,而不是單獨排程任務的清單,並且每當您在命令行上提供提示時都會被忽略。若要在其旁邊排程其他提示,請使用 /loop <prompt>直接要求 Claude Claude 在兩個位置尋找檔案,並使用它找到的第一個。 該檔案是純 Markdown,沒有必需的結構。將其寫成您直接輸入 /loop 提示的方式。以下範例保持發行分支健康:
.claude/loop.md
loop.md 的編輯在下次迭代時生效,因此您可以在迴圈執行時精煉指示。當任一位置都不存在 loop.md 時,迴圈會回退到內建維護提示。保持檔案簡潔:超過 25,000 位元組的內容會被截斷。
在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上,loop.md 不會被讀取,沒有提示的 /loop 會列印使用訊息。

停止迴圈

若要在 /loop 等待下一次迭代時停止它,請按 Esc。這會清除待處理的喚醒,使迴圈不會再次執行。您透過直接要求 Claude 排程的任務不受 Esc 影響,會保留在原位,直到您刪除它們。 自我調整模式中,Claude 也可以在任務完成後自行結束迴圈。Claude 呼叫 ScheduleWakeup tool,其中 stop: true,這會立即取消待處理的喚醒。如果迭代結束時既未重新排程也未停止,Claude Code 會排程一個大約 20 分鐘後的備用喚醒,並在該迭代也不重新排程時結束迴圈。在 v2.1.202 之前,不重新排程是 Claude 自行結束迴圈的唯一方式。 固定間隔上的迴圈會持續執行,直到您停止它們或七天過去

設定一次性提醒

對於一次性提醒,請用自然語言描述您想要的內容,而不是使用 /loop。Claude 會排程一個執行後自動刪除的單次執行任務。
Claude 會使用 cron 表達式將執行時間固定到特定的分鐘和小時,並確認何時執行。

管理排程任務

用自然語言要求 Claude 列出或取消任務,或直接參考基礎工具。
在幕後,Claude 使用這些工具: 每個排程任務都有一個 8 字元的 ID,您可以傳遞給 CronDelete。一個工作階段最多可以同時保存 50 個排程任務。

排程任務如何執行

排程器每秒檢查一次到期的任務,並以低優先級將其加入佇列。排程的提示在您的回合之間執行,而不是在 Claude 正在回應時執行。如果 Claude 在任務到期時忙碌,提示會等到目前回合結束。 所有時間都以您的本地時區解釋。cron 表達式(例如 0 9 * * *)表示您執行 Claude Code 的任何地方的上午 9 點,而不是 UTC。

抖動

為了避免每個工作階段在同一牆上時刻點擊 API,排程器會為執行時間添加一個確定性偏移:
  • 重複執行的任務最多在排程時間後 30 分鐘執行(或對於執行頻率超過每小時的任務,最多為間隔的一半)。為 :00 排程的每小時工作可能在 :00:30 之間的任何時間執行。
  • 為整點或半點排程的一次性任務最多提前執行 90 秒。
偏移是從任務 ID 衍生的,所以相同的任務總是獲得相同的偏移。如果精確計時很重要,請選擇不是 :00:30 的分鐘,例如 3 9 * * * 而不是 0 9 * * *,一次性抖動將不適用。

七天過期

重複執行的任務在建立後 7 天自動過期。任務最後執行一次,然後刪除自己。這限制了被遺忘的迴圈可以執行多長時間。如果您需要重複執行的任務持續更長時間,請在過期前取消並重新建立它,或使用 RoutinesDesktop 排程任務 進行持久排程。

Cron 表達式參考

CronCreate 接受標準 5 欄位 cron 表達式:minute hour day-of-month month day-of-week。所有欄位都支援萬用字元 (*)、單一值 (5)、步驟 (*/15)、範圍 (1-5) 和逗號分隔的清單 (1,15,30)。 星期幾使用 07 表示星期日,6 表示星期六。不支援擴展語法,例如 LW? 和名稱別名,例如 MONJAN 當月份日期和星期幾都受到限制時,如果任一欄位匹配,日期就匹配。這遵循標準 vixie-cron 語義。

停用排程任務

在您的環境中設定 CLAUDE_CODE_DISABLE_CRON=1 以完全停用排程器。cron 工具和 /loop 變得不可用,任何已排程的任務都停止執行。請參閱 環境變數 以取得完整的停用標誌清單。

限制

工作階段範圍的排程有固有的限制:
  • 任務只在 Claude Code 執行且閒置時執行。關閉終端或讓工作階段退出會停止它們執行。將工作階段放在背景執行會將 /loop 任務帶到背景工作階段,該工作階段會持續執行而無需終端。
  • 沒有錯過執行的追趕。如果任務的排程時間在 Claude 忙於長時間執行的請求時經過,它會在 Claude 變為閒置時執行一次,而不是每個錯過的間隔執行一次。
  • 啟動新的對話會清除所有工作階段範圍的任務。使用 claude --resumeclaude --continue 繼續會恢復尚未過期的任務:建立後七天內的重複執行任務,以及排程時間尚未到達的一次性任務。背景 Bash 和監視任務在繼續時永遠不會被恢復。
對於需要無人值守執行的 cron 驅動自動化:
  • Routines:在 Anthropic 管理的基礎設施上按排程執行、透過 API 呼叫或在 GitHub 事件上執行
  • GitHub Actions:在 CI 中使用 schedule 觸發器
  • Desktop 排程任務:在您的機器上本地執行