SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-09-11 23:01 UTC to 2026-09-12 03:02 UTC

This page contains 14 additions and 14 deletions.

2026
Thu 10 23:00 Sat 12 03:02

在 Claude Code Desktop 中排程定期任務

在 Claude Code Desktop 中設定排程任務，以定期自動執行 Claude 進行每日程式碼審查、相依性稽核或早晨簡報。

排程任務會在您選擇的時間和頻率自動啟動新的工作階段。使用它們進行定期工作，例如每日程式碼審查、相依性更新檢查，或從您的日曆和收件匣提取資訊的早晨簡報。

Desktop 應用程式的 Routines 頁面可讓您建立本機排程任務和遠端 routines。本機任務在您的機器上執行，可直接存取您的檔案和工具，但只有在應用程式開啟且您的電腦處於喚醒狀態時才會觸發。遠端 routine 在雲端執行，即使您的電腦關閉也能執行，並且也可以透過 API 呼叫或 GitHub 事件觸發。本頁涵蓋本機排程任務；如需遠端 routine 及其觸發選項，請參閱 Routines。

比較排程選項

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

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

建立排程任務

在 Claude Desktop 1.1.5368 之前，本機排程任務不可用。在 Code 標籤中，按一下側邊欄中的 Routines 或側邊欄的 More 選單，然後按一下 New routine 並選擇 Local。設定這些欄位：

欄位 說明
Name 任務的識別碼。轉換為小寫 kebab-case 並用作磁碟上的資料夾名稱。在您的任務中必須是唯一的。
Description 在任務清單中顯示的簡短摘要。
Instructions Claude 執行任務時應執行的操作。以您在提示框中撰寫任何訊息的相同方式撰寫此項。instructions 輸入包括權限模式和模型的選擇器，在其下方您可以選擇工作資料夾以及是否在隔離的 worktree 中執行。
Schedule 任務執行的頻率。請參閱下方的 schedule options。

您必須先有一個資料夾才能儲存任務。如果您尚未信任該資料夾，Desktop 會在儲存前提示您信任它。

您也可以透過在任何工作階段中描述您想要的內容來建立任務。例如，「設定每天早上 9 點執行的每日程式碼審查」會建立定期任務，而「提醒我明天下午 3 點檢查部署」會建立一次性任務，在觸發後會自動停用。

排程選項

從 Schedule 控制項中選擇預設值：

  • Manual：無排程，只有在您按一下 Run now 時才執行。適用於儲存您按需觸發的提示
  • Hourly：每小時執行一次
  • Daily：顯示時間選擇器，預設為本機時間上午 9:00
  • Weekdays：與 Daily 相同，但跳過星期六和星期日
  • Weekly：顯示時間選擇器和日期選擇器

對於選擇器不提供的間隔，例如每 15 分鐘、每月的第一天或在特定未來時間的單次執行，請在任何 Desktop 工作階段中詢問 Claude 以設定排程。使用純文字；例如，「排程任務每 6 小時執行一次所有測試」。

排程任務如何執行

排程任務在您的機器上執行。Desktop 在應用程式開啟時每分鐘檢查一次排程，並在任務到期時啟動新的工作階段，獨立於您開啟的任何手動工作階段。每個任務在排程時間後會有幾分鐘的小延遲，以錯開 API 流量。延遲是確定性的：同一任務始終在相同的偏移量處啟動。

當任務觸發時，您會收到桌面通知，新的工作階段會在側邊欄的 Scheduled 部分下出現。開啟它以查看 Claude 執行的操作、審查變更或回應權限提示。Claude 可以編輯檔案、執行命令、建立提交和開啟提取請求，與您自己啟動的工作階段相同，但無法透過 desktop 應用程式的工作階段介面傳送或接收您的 desktop 工作階段之間的訊息。

任務只有在 desktop 應用程式執行且您的電腦處於喚醒狀態時才會執行。如果您的電腦在排程時間內進入睡眠狀態，該執行會被跳過。若要防止閒置睡眠，請在 Settings 中的 Desktop app → General 下啟用 Keep computer awake。關閉筆記型電腦蓋仍會使其進入睡眠狀態。對於需要在電腦關閉時執行或應該透過 API 呼叫或 GitHub 事件觸發的任務，請改為建立遠端 routine。

錯過的執行

當應用程式啟動或您的電腦喚醒時，Desktop 會檢查每個任務是否在過去七天內錯過了任何執行。如果有，Desktop 會為最近錯過的時間啟動恰好一次的追趕執行，並丟棄任何較舊的執行。錯過六天的每日任務在喚醒時執行一次。Desktop 會在追趕執行啟動時顯示通知。

在撰寫提示時請記住這一點。排程在上午 9 點的任務可能在晚上 11 點執行，如果您的電腦整天都在睡眠狀態。如果時間很重要，請在提示本身中新增護欄，例如：「只審查今天的提交。如果已經過下午 5 點，請跳過審查，只發佈錯過內容的摘要。」

排程任務的權限

每個任務都有其自己的權限模式，您在建立或編輯任務時設定。來自 ~/.claude/settings.json 的允許規則也適用於排程任務工作階段。如果任務在 Manual 模式下執行，並且需要執行它沒有權限的工具，執行會停滯，直到您批准它。工作階段保持在側邊欄中開啟，以便您稍後可以回答。

為了避免停滯，在建立任務後按一下 Run now，監視權限提示，並為每個提示選擇「always allow」。該任務的未來執行會自動批准相同的工具，無需提示。您可以從任務的詳細資料頁面審查和撤銷這些批准。

標記為 requiresUserInteraction 的 MCP 工具會在每次呼叫時提示，並且不提供 always-allow 選項。呼叫這些工具的執行每次都會停滯。

管理排程任務

在 Code 標籤中，按一下 Routines 清單中的任務以開啟其詳細資料頁面。從這裡您可以：

  • Run now：立即啟動任務，無需等待下一個排程時間
  • Status：在 Active 和 Paused 之間切換，以暫停或繼續排程執行，無需刪除任務
  • Edit：變更 instructions、排程、資料夾或其他設定
  • Review history：查看每次過去的執行，包括跳過的執行。將滑鼠懸停在跳過的項目上以查看原因：您的電腦在睡眠狀態、前一次執行仍在進行中，或其他排程任務已在執行。按一下 Show more 以載入較舊的項目。
  • Review allowed permissions：從 Always allowed 面板查看和撤銷此任務的已儲存工具批准
  • Delete：移除任務並封存它建立的所有工作階段。確認對話方塊中會出現 Also delete files on disk 核取方塊；勾選它也會移除任務的 SKILL.md 檔案和 ~/.claude/scheduled-tasks/ 中的相關資料。

您也可以透過在任何 Desktop 工作階段中詢問 Claude 來列出、建立、編輯和暫停任務。例如，「暫停我的 dependency-audit 任務」或「顯示我的排程任務」。若要刪除任務，請使用其詳細資料頁面上的 Delete 按鈕。

排程任務也可以使用 update_scheduled_task MCP 工具在執行中的工作階段內修改其自己的排程或提示。這可讓任務根據其發現重新排程自己，例如，當它偵測到已建立發行分支時，重新排程程式碼審查以更早執行。

若要在磁碟上編輯任務的提示，請開啟 ~/.claude/scheduled-tasks/<task-name>/SKILL.md（如果設定了 CLAUDE_CONFIG_DIR，則在其下）。該檔案使用 YAML frontmatter 作為 name 和 description，提示作為主體。變更在下一次執行時生效。Schedule、資料夾、模型和啟用狀態不在此檔案中：透過 Edit 表單變更它們或詢問 Claude。