/goal。
任務的範圍限於工作階段：它們存在於目前的對話中，當您啟動新的對話時就會停止。使用 --resume 或 --continue 繼續會恢復任何尚未過期的任務，除了限制下列出的任務。對於獨立於任何工作階段而存在的排程，請使用 Routines 在雲端建立例行程序、設定 Desktop 排程任務，或使用 GitHub Actions。
比較排程選項
Claude Code 提供三種方式來排程定期或一次性的工作：使用 /loop 重複執行提示
/loop bundled skill 是在工作階段保持開啟的情況下重複執行提示的最快方式。間隔和提示都是選用的，您提供的內容決定了迴圈的行為方式。
您也可以傳遞一個 skill 作為提示，例如
/loop 20m /review-pr 1234，以在每次迭代時重新執行該 skill。排程的執行只會執行 Claude 允許自行叫用的 skill。以下內容會以純文字形式傳達給 Claude，而不是執行：
- 內建命令，例如
/permissions、/model或/clear - 標記為
disable-model-invocation: true的 skill，包括 bundled/verifyskill - 由
skillOverrides設定或Skilldeny rule 從 Claude 隱藏的 skill - MCP prompts，例如
/mcp__github__list_prs
在固定間隔上執行
當您提供間隔時，Claude 會將其轉換為 cron 表達式、排程工作，並確認頻率和工作 ID。30m）在提示前面，或作為子句（如 every 2 hours）在後面。支援的單位為 s（秒）、m（分鐘）、h（小時）和 d（天）。
秒數會四捨五入到最近的分鐘，因為 cron 的粒度為一分鐘。不能均勻分割其單位的間隔（例如 7m 或 90m）會四捨五入到最近的整潔間隔，Claude 會告訴您它選擇了什麼。
讓 Claude 選擇間隔
當您省略間隔時，Claude 會動態選擇一個，而不是在固定的 cron 排程上執行。在每次迭代後，它會根據觀察到的情況選擇一個介於一分鐘到一小時之間的延遲：在建置完成或 PR 活躍時短暫等待，當沒有待處理項目時較長等待。選擇的延遲和原因會在每次迭代結束時列印。 下面的範例檢查 CI 和審查評論，Claude 在 PR 變得安靜後在迭代之間等待更長時間：/loop 排程時，Claude 可能會直接使用它。Monitor 執行背景指令碼並串流回每個輸出行，這完全避免了輪詢，通常比在間隔上重新執行提示更具令牌效率和回應性。
動態排程的迴圈會像任何其他任務一樣出現在您的排程任務清單中，因此您可以以相同的方式列出或取消它。抖動規則不適用於它，但七天過期適用。
執行內建維護提示
當您省略提示時，Claude 會使用內建維護提示而不是您提供的提示。在每次迭代上，它會按順序進行以下操作：- 繼續對話中任何未完成的工作
- 照顧目前分支的拉取請求：審查評論、失敗的 CI 執行、合併衝突
- 執行清理通過，例如當沒有其他待處理項目時的錯誤搜尋或簡化
/loop 在動態選擇的間隔上執行此提示。新增間隔（例如 /loop 15m）以改為在固定排程上執行它。若要用您自己的預設值替換內建提示，請參閱使用 loop.md 自訂預設提示。
使用 loop.md 自訂預設提示
建立loop.md 檔案以用您自己的指示替換內建維護提示。它為裸 /loop 定義單一預設提示，而不是單獨排程任務的清單，並且每當您在命令行上提供提示時 Claude Code 都會忽略它。若要在其旁邊排程其他提示，請使用 /loop <prompt> 或直接要求 Claude。
Claude 在兩個位置尋找檔案，並使用它找到的第一個。
該檔案是純 Markdown，沒有必需的結構。將其寫成您直接輸入
/loop 提示的方式。以下範例保持發行分支健康：
.claude/loop.md
loop.md 的編輯在下次迭代時生效，因此您可以在迴圈執行時精煉指示。當任一位置都不存在 loop.md 時，迴圈會回退到內建維護提示。保持檔案簡潔：超過 25,000 位元組的內容會被截斷。
停止迴圈
若要在自我調整/loop 等待下一次迭代時停止它，請按 Esc。這會清除待處理的喚醒，使迴圈不會再次執行。您透過直接要求 Claude 排程的任務不受 Esc 影響，會保留在原位，直到您刪除它們。
在自我調整模式中，Claude 也可以在任務完成後自行結束迴圈。Claude 呼叫 ScheduleWakeup tool，其中 stop: true，這會立即取消待處理的喚醒。如果迭代結束時既未重新排程也未停止，Claude Code 會排程一個大約 20 分鐘後的備用喚醒，並在該迭代也不重新排程時結束迴圈。
固定間隔上的迴圈會持續執行，直到您像任何其他排程任務一樣取消它們或七天過去。
設定一次性提醒
對於一次性提醒，請用自然語言描述您想要的內容，而不是使用/loop。Claude 會排程一個執行後自動刪除的單次執行任務。
管理排程任務
用自然語言要求 Claude 列出或取消任務，或直接參考基礎工具。
每個排程任務都有一個 8 字元的 ID，您可以傳遞給
CronDelete。一個工作階段最多可以同時保存 50 個排程任務。
排程任務如何執行
排程器每秒檢查一次到期的任務，並以低優先級將其加入佇列。排程的提示在您的回合之間執行，而不是在 Claude 正在回應時執行。如果 Claude 在任務到期時忙碌，提示會等到目前回合結束。 所有時間都以您的本地時區解釋。cron 表達式（例如0 9 * * *）表示您執行 Claude Code 的任何地方的上午 9 點，而不是 UTC。
抖動
為了避免每個工作階段在同一牆上時刻點擊 API，排程器會為執行時間添加一個確定性偏移：- 重複執行的任務最多在排程時間後 30 分鐘執行（或對於執行頻率超過每小時的任務，最多為間隔的一半）。為
:00排程的每小時工作可能在:00到:30之間的任何時間執行。 - 為整點或半點排程的一次性任務最多提前執行 90 秒。
:00 或 :30 的分鐘，例如 3 9 * * * 而不是 0 9 * * *，一次性抖動將不適用。
七天過期
重複執行的任務在建立後 7 天自動過期。任務最後執行一次，然後刪除自己。這限制了被遺忘的迴圈可以執行多長時間。如果您需要重複執行的任務持續更長時間，請在過期前取消並重新建立它，或使用 Routines 或 Desktop 排程任務 進行持久排程。Cron 表達式參考
CronCreate 接受標準 5 欄位 cron 表達式：minute hour day-of-month month day-of-week。所有欄位都支援萬用字元 (*)、單一值 (5)、步驟 (*/15)、範圍 (1-5) 和逗號分隔的清單 (1,15,30)。
星期幾使用
0 或 7 表示星期日，6 表示星期六。不支援擴展語法，例如 L、W、? 和名稱別名，例如 MON 或 JAN。
當月份日期和星期幾都受到限制時，如果任一欄位匹配，日期就匹配。這遵循標準 vixie-cron 語義。
停用排程任務
在您的環境中設定CLAUDE_CODE_DISABLE_CRON=1 以完全停用排程器。cron 工具和 /loop 變得不可用，任何已排程的任務都停止執行。請參閱 環境變數 以取得完整的停用標誌清單。
限制
工作階段範圍的排程有固有的限制：- 任務只在 Claude Code 執行且閒置時執行。關閉終端或讓工作階段退出會停止它們執行。將工作階段放在背景執行會將
/loop任務帶到背景工作階段，該工作階段會持續執行而無需終端。 - 沒有錯過執行的追趕。如果任務的排程時間在 Claude 忙於長時間執行的請求時經過，它會在 Claude 變為閒置時執行一次，而不是每個錯過的間隔執行一次。
- 啟動新的對話會清除所有工作階段範圍的任務。當您使用
claude --resume或claude --continue繼續工作階段時，Claude Code 會復原使用CronCreate排程的任務，除了已過期的重複執行任務和排程時間已經過去的一次性任務。自我調整的/loop（不會被復原），因此請再次執行/loop以重新啟動它。背景 Bash 和監視任務在繼續時永遠不會被復原。 - 當功能旗標擷取關閉時，Claude Code 會將您要求跨工作階段保留的任務儲存在專案的
.claude/scheduled_tasks.json檔案中。當.claude目錄或該檔案是符號連結時，Claude Code 會傳回錯誤，而不是排程任務。已儲存的任務只在您建立它的專案資料夾中執行。如果您將檔案複製到另一個資料夾（例如新的 worktree），該處的工作階段會列出複製的任務，但不會執行它們，因此請在該資料夾中再次建立任務。
- Routines：在雲端按排程執行、透過 API 呼叫或在 GitHub 事件上執行
- GitHub Actions：在 CI 中使用
schedule觸發器 - Desktop 排程任務：在您的機器上本地執行