SpyBara
Go Premium

desktop-scheduled-tasks.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 85 additions and 47 deletions.

2026
Sat 3 23:57 Tue 6 23:59 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Tue 27 22:59

在 Claude Code Desktop 中排程定期任務

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

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

Desktop 應用程式的 Scheduled tasks 頁面會同時列出本機排程任務和雲端排程任務（前身為 routines）：

  • 本機任務：在您的機器上執行，可直接存取您的檔案和工具，但只有在應用程式開啟且您的電腦處於喚醒狀態時才會觸發
  • 雲端任務：即使您的電腦關閉也能執行，並且也可以透過 API 呼叫或 GitHub 事件啟動

本頁涵蓋本機排程任務；如需雲端排程任務及其觸發選項，請參閱使用排程任務自動化工作。

比較排程選項

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

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

[!TIP]

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

[!NOTE]

根據預設，本機排程任務會針對您的工作目錄的任何狀態執行，包括未提交的變更。若要改為讓每次執行使用其自己的隔離 Git worktree，請在建立任務後，於任務的Edit 表單中選取 Worktree。當任務的資料夾是 Git 儲存庫時，即可使用此核取方塊。

建立排程任務

本機排程任務需要 Claude Desktop 1.1.5368 或更新版本。

1. 開啟 Scheduled tasks 頁面

在 Code 標籤中，按一下側邊欄中或側邊欄 More 選單中的 Scheduled。

2. 開始新任務

按一下 New task。如果開啟的選單中有 Create with Claude 和 Set up manually，請選擇 Set up manually。New scheduled task 對話框隨即開啟。如果 Only on this computer 位於對話框頂端，請在輸入任何內容之前，先前往對話框頂端有 Only on this computer 時。

3. 為任務命名

在 Name 欄位中輸入名稱。Desktop 會將其轉換為小寫 kebab-case，並用作任務在磁碟上的資料夾名稱，因此該名稱在您的所有任務中必須是唯一的。

4. 撰寫指示

在名稱下方的方塊中，輸入 Claude 在任務執行時應執行的操作。

5. 開啟 Only on this computer

先跳過 Trigger 卡片，展開其下方的 Advanced settings。在 General 標籤上，開啟 Only on this computer。開啟後，任務會在您的電腦上的本機資料夾中執行，且 Trigger 卡片會提供排程選項中列出的預設選項。

如果該開關無法使用，請清除儲存庫或 GitHub 事件或 API 觸發條件，因為這些會使任務成為雲端排程任務。

6. 選擇本機資料夾

在 Local folder 列中選擇一個資料夾。在您選擇資料夾之前，Create 會保持無法使用。

7. 設定排程

回到 Trigger 卡片，選擇一個排程預設選項。

8. 選擇權限模式和模型

在指示方塊的工具列中，選擇權限模式和模型。如果保持不變，執行時會使用您的 Claude Code 設定和預設模型。

9. 建立任務

按一下 Create。如果您尚未信任該資料夾，Desktop 會在此時要求您信任它。任務的詳細資料頁面隨即開啟。

在詳細資料頁面上，按一下鉛筆圖示以開啟 Edit 表單。您可以在其中變更 Desktop 根據您的指示填入的 Description、選擇 Worktree，或將排程切換為 Manual。

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

對話框頂端有 Only on this computer 時

如果 New scheduled task 對話框開啟時 Only on this computer 位於頂端，請在輸入任何內容之前先將其開啟。開啟後，一個用於本機任務的獨立空白表單會取代原本的表單。

接著填寫本機表單的欄位：

  • Name：輸入名稱，方式與建立排程任務的步驟相同。
  • Description：輸入說明。在您輸入之前，Create 會保持無法使用。
  • 指示方塊：輸入 Claude 在任務執行時應執行的操作。從方塊中的選單選擇權限模式和模型。
  • Working folder：選擇任務執行所在的資料夾。在您選擇資料夾之前，Create 會保持無法使用。
  • Trigger：選擇排程。Custom 接受 cron 運算式。關於其他預設選項，請參閱排程選項。

按一下 Create。任務的詳細資料頁面隨即開啟。

排程選項

當您在 Advanced settings 下開啟 Only on this computer 時，Trigger 卡片會提供 Hourly、Daily、Weekdays 和 Weekly。任務的 Edit 表單還提供 Manual。

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

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

排程任務如何執行

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

任務只有在 desktop 應用程式執行且您的電腦處於喚醒狀態時才會執行。如果您的電腦在排程時間內進入睡眠狀態，該執行會被跳過。若要防止閒置睡眠，請在 Settings > This computer > System 中啟用 Keep computer awake。關閉筆記型電腦蓋仍會使其進入睡眠狀態。

[!NOTE]

對於需要在電腦關閉時執行，或應該透過 API 呼叫或 GitHub 事件觸發的任務，請改為建立雲端排程任務。

當本機任務觸發時，新的工作階段會在側邊欄的 Scheduled 部分下出現。開啟它以查看 Claude 執行的操作、審查變更或回應權限提示。Claude 可以編輯檔案、執行命令、建立提交和開啟 pull request，與您自己啟動的工作階段相同。

錯過的執行

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

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

排程任務的權限

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

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

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

管理排程任務

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

  • 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。

相關資源