按排程執行提示

使用 /loop 和 cron 排程工具在 Claude Code 工作階段內重複執行提示、輪詢狀態或設定一次性提醒。

排程任務讓 Claude 按間隔自動重新執行提示。使用它們來輪詢部署、監督 PR、檢查長時間執行的建置，或在工作階段稍後提醒自己執行某些操作。若要改為對事件發生時做出反應而不是輪詢，請參閱 Channels：您的 CI 可以直接將失敗推送到工作階段中。若要保持工作階段逐輪執行直到符合條件而不是按間隔執行，請參閱 /goal。

任務的範圍限於工作階段。當您使用 --resume 或 --continue 繼續時，Claude Code 會復原任何尚未過期的任務，除了限制下列出的任務。對於獨立於任何工作階段而存在的排程，請使用 Routines 在雲端建立例行程序、設定 Desktop 排程任務，或使用 GitHub Actions。

​

比較排程選項

Claude Code 提供三種方式來排程定期或一次性的工作：

	Cloud	Desktop	/loop
執行位置	Cloud，預設由 Anthropic 管理	您的機器	您的機器
需要機器開啟	否	是	是
需要開啟的工作階段	否	否	是
跨重新啟動持續存在	是	是	在 --resume 上復原，有例外
存取本機檔案	否（全新複製）	是	是
MCP 伺服器	每個工作配置的連接器	設定檔和連接器	繼承自工作階段
權限提示	否（自主執行）	每個工作可設定	繼承自工作階段
可自訂排程	透過 CLI 中的 /schedule	是	是
最小間隔	1 小時	1 分鐘	1 分鐘

使用雲端工作來執行應該在沒有您的機器的情況下可靠執行的工作。當您需要存取本機檔案和工具時，使用Desktop 工作。使用 /loop 進行工作階段期間的快速輪詢。

​

使用 /loop 重複執行提示

/loop bundled skill 是在工作階段保持開啟的情況下重複執行提示的最快方式。間隔和提示都是選用的，您提供的內容決定了迴圈的行為方式。

您提供的內容	範例	發生的情況
間隔和提示	/loop 5m check the deploy	您的提示在固定排程上執行
僅提示	/loop check the deploy	您的提示在 Claude 選擇的間隔上執行，每次迭代
僅間隔或無	/loop	內建維護提示執行，或您的 loop.md（如果存在）

您也可以傳遞一個 skill 作為提示，例如 /loop 20m /review-pr 1234，以在每次迭代時重新執行該 skill。排程的執行只會執行 Claude 允許自行叫用的 skill。以下內容會以純文字形式傳達給 Claude，而不是執行：

• 內建命令，例如 /permissions、/model 或 /clear
• 標記為 disable-model-invocation: true 的 skill，包括 bundled /verify skill
• 由 skillOverrides 設定或 Skill deny rule 從 Claude 隱藏的 skill
• MCP prompts，例如 /mcp__github__list_prs

​

在固定間隔上執行

當您提供間隔時，Claude 會將其轉換為 cron 表達式、排程工作，並確認頻率和工作 ID。

/loop 5m check if the deployment finished and tell me what happened

間隔可以作為裸令牌（如 30m）在提示前面，或作為子句（如 every 2 hours）在後面。支援的單位為 s（秒）、m（分鐘）、h（小時）和 d（天）。

秒數會四捨五入到最近的分鐘，因為 cron 的粒度為一分鐘。不能均勻分割其單位的間隔（例如 7m 或 90m）會四捨五入到最近的整潔間隔，Claude 會告訴您它選擇了什麼。

​

讓 Claude 選擇間隔

當您省略間隔時，Claude 會動態選擇一個，而不是在固定的 cron 排程上執行。在每次迭代後，它會根據觀察到的情況選擇一個介於一分鐘到一小時之間的延遲：在建置完成或 PR 活躍時短暫等待，當沒有待處理項目時較長等待。選擇的延遲和原因會在每次迭代結束時列印。

下面的範例檢查 CI 和審查評論，Claude 在 PR 變得安靜後在迭代之間等待更長時間：

/loop check whether CI passed and address any review comments

在提供 Monitor 工具的工作階段中，當您要求動態 /loop 排程時，Claude 可能會直接使用它。Monitor 執行背景指令碼並串流回每個輸出行，這完全避免了輪詢，通常比在間隔上重新執行提示更具令牌效率和回應性。

動態排程的迴圈會像任何其他任務一樣出現在您的排程任務清單中，因此您可以以相同的方式列出或取消它。清單會將其待處理的喚醒顯示為一次性任務，因此排程在 :00 或 :30 的喚醒可能會稍微提早執行。七天過期同樣適用於此迴圈。

動態選擇的間隔和內建維護提示在每個提供者上都有效，並且功能旗標擷取已關閉。在 Amazon Bedrock、Claude Platform on AWS、Google Cloud 的 Agent Platform 和 Microsoft Foundry 上，或擷取已關閉時，兩者都需要 Claude Code v2.1.248 或更新版本。

​

執行內建維護提示

當您省略提示時，Claude 會使用內建維護提示而不是您提供的提示。在每次迭代上，它會按順序進行以下操作：

• 繼續對話中任何未完成的工作
• 照顧目前分支的拉取請求：審查評論、失敗的 CI 執行、合併衝突
• 執行清理通過，例如當沒有其他待處理項目時的錯誤搜尋或簡化

Claude 不會在該範圍之外啟動新的計畫，不可逆的操作（例如推送或刪除）只在它們繼續文字記錄已授權的內容時進行。

/loop

裸 /loop 在動態選擇的間隔上執行此提示。新增間隔（例如 /loop 15m）以改為在固定排程上執行它。若要用您自己的預設值替換內建提示，請參閱使用 loop.md 自訂預設提示。

​

使用 loop.md 自訂預設提示

建立 loop.md 檔案以用您自己的指示替換內建維護提示。它為裸 /loop 定義單一預設提示，而不是單獨排程任務的清單，並且每當您在命令行上提供提示時 Claude Code 都會忽略它。若要在其旁邊排程其他提示，請使用 /loop <prompt> 或直接要求 Claude。

Claude 在兩個位置尋找檔案，並使用它找到的第一個。

路徑	範圍
.claude/loop.md	專案層級。當兩個檔案都存在時優先。
~/.claude/loop.md	使用者層級。適用於任何未定義自己的專案。

該檔案是純 Markdown，沒有必需的結構。將其寫成您直接輸入 /loop 提示的方式。以下範例保持發行分支健康：

.claude/loop.md

Check the `release/next` PR. If CI is red, pull the failing job log,
diagnose, and push a minimal fix. If new review comments have arrived,
address each one and resolve the thread. If everything is green and
quiet, say so in one line.

對 loop.md 的編輯在下次迭代時生效，因此您可以在迴圈執行時精煉指示。當任一位置都不存在 loop.md 時，迴圈會回退到內建維護提示。保持檔案簡潔：超過 25,000 位元組的內容會被截斷。

​

停止迴圈

若要在自我調整 /loop 等待下一次迭代時停止它，請按 Esc。這會清除待處理的喚醒，使迴圈不會再次執行。您透過直接要求 Claude 排程的任務不受 Esc 影響，會保留在原位，直到您刪除它們。

在自我調整模式中，Claude 也可以在任務完成後自行結束迴圈。Claude 呼叫 ScheduleWakeup tool，其中 stop: true，這會立即取消待處理的喚醒。如果迭代結束時既未重新排程也未停止，Claude Code 會排程一個大約 20 分鐘後的備用喚醒，並在該迭代也不重新排程時結束迴圈。

固定間隔上的迴圈會持續執行，直到您像任何其他排程任務一樣取消它們或七天過去。

​

設定一次性提醒

對於一次性提醒，請用自然語言描述您想要的內容，而不是使用 /loop。Claude 會排程一個執行後自動刪除的單次執行任務。

remind me at 3pm to push the release branch

in 45 minutes, check whether the integration tests passed

Claude 會使用 cron 表達式將執行時間固定到特定的分鐘和小時，並確認何時執行。

​

管理排程任務

用自然語言要求 Claude 列出或取消任務，或直接參考基礎工具。

what scheduled tasks do I have?

cancel the deploy check job

這些是 Claude 使用的基礎工具：

工具	用途
CronCreate	排程新任務。接受 5 欄位 cron 表達式、要執行的提示，以及是否重複或執行一次。
CronList	列出排程任務及其 ID、排程、下次執行時間和提示詞。
CronDelete	按 ID 取消任務。

每個排程任務都有一個 8 字元的 ID，您可以傳遞給 CronDelete。一個工作階段最多可以同時保存 50 個排程任務。

​

排程任務如何執行

排程器每秒檢查一次到期的任務，並以低優先級將其加入佇列。排程的提示在您的回合之間執行，而不是在 Claude 正在回應時執行。如果 Claude 在任務到期時忙碌，提示會等到目前回合結束。

所有時間都以您的本地時區解釋。cron 表達式（例如 0 9 * * *）表示您執行 Claude Code 的任何地方的上午 9 點，而不是 UTC。

​

抖動

排程任務的實際執行時間可能與其排程所指定的時間不同。如果每個工作階段的任務都完全按照排程執行，許多任務就會在同一時刻呼叫 API，因此 Claude Code 會偏移每個任務的執行時間。重複執行的任務會延後執行，但每五分鐘執行一次（寫成 */5 * * * *）的任務除外。排程在整點或半點的一次性任務則會稍微提前執行。

若要查看任務下一次的到期時間，請閱讀終端機中 Claude 的 CronCreate 呼叫下方的那一列。該列會在排程之後顯示該時間，例如 next run 10:21 AM。若要稍後再次查看，請要求 Claude 列出您的任務，並在 CronList 呼叫下方的各列中尋找 next run。這些列中的下次執行時間需要 Claude Code v2.1.299 或更新版本。

​

重複執行的任務會延後多久

除非每五分鐘執行一次，否則重複執行的任務每次執行都會延後開始，延後時間最多為距下一次執行間隔的一半，且最多不超過 30 分鐘。您的任務屬於以下三種情況之一：

• 間隔均勻的執行：間隔相等的任務（例如每小時、每天或每 10 分鐘）每次都會延後相同的分鐘數，即使工作階段處於閒置時也是如此。
• 間隔不均勻的執行：間隔不相等的任務（例如排程在每小時 :00 和 :15 的任務）在每次執行時可能延後不同的分鐘數。
• 每五分鐘：寫成 */5 * * * * 的任務不會延後。在上一次執行整整五分鐘後才開始的執行，會在五分鐘的提示快取過期之後才開始，因此每次執行會提早 15 秒開始。

在此表格的第一欄中找到您的排程，即可查看其每次執行的開始時間。

排程	每次執行的開始時間
每 5 分鐘，寫成 */5 * * * *，即 /loop 5m 所建立的排程	上一次執行後 4 分 45 秒
每 10 分鐘	延後 0 到 5 分鐘
每 30 分鐘	延後 0 到 15 分鐘
每小時，或頻率更低（例如每天）	延後 0 到 30 分鐘

例如，7,37 * * * * 會將任務排程在 :07 和 :37，兩者相隔 30 分鐘，因此其延遲介於 0 到 15 分鐘之間。如果此任務的延遲為 14 分鐘，它會在每小時的 :21 和 :51 執行。將排程改為不同的分鐘會移動執行時間，但仍會在其上加上延遲。

​

一次性任務何時會提前執行

排程在 :00 或 :30 的一次性任務最多會提前 90 秒執行。Claude Code 不會偏移排程在其他任何分鐘的一次性任務，因此當時間點很重要時，請避開整點和半點進行排程：使用 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)。

範例	含義
*/5 * * * *	每 5 分鐘
0 * * * *	每小時整點
7 * * * *	每小時的第 7 分鐘
0 9 * * *	每天上午 9 點（本地時間）
0 9 * * 1-5	工作日上午 9 點（本地時間）
30 14 15 3 *	3 月 15 日下午 2: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），該處的工作階段會列出複製的任務，但不會執行它們，因此請在該資料夾中再次建立任務。

對於需要無人值守執行的 cron 驅動自動化：

• Routines：在雲端按排程執行、透過 API 呼叫或在 GitHub 事件上執行
• GitHub Actions：在 CI 中使用 schedule 觸發器
• Desktop 排程任務：在您的機器上本地執行