排程任務會在您選擇的時間和頻率自動啟動新的工作階段。使用它們進行定期工作,例如每日程式碼審查、相依性更新檢查,或從您的日曆和收件匣提取資訊的早晨簡報。 Desktop 應用程式的 Routines 頁面可讓您建立本機排程任務和遠端 routines。本機任務在您的機器上執行,可直接存取您的檔案和工具,但只有在應用程式開啟且您的電腦處於喚醒狀態時才會觸發。遠端 routine 在 Anthropic 管理的雲端基礎設施上執行,即使您的電腦關閉也能執行,並且也可以透過 API 呼叫或 GitHub 事件觸發。本頁涵蓋本機排程任務;如需遠端 routine 及其觸發選項,請參閱 Routines。Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
比較排程選項
Claude Code offers three ways to schedule recurring or one-off work:| Cloud | Desktop | /loop | |
|---|---|---|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | Restored on --resume if unexpired |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
根據預設,排程任務會針對您的工作目錄的任何狀態執行,包括未提交的變更。在建立任務時啟用 worktree 切換,為每次執行提供其自己的隔離 Git worktree,與 parallel sessions 的工作方式相同。
建立排程任務
按一下側邊欄中的 Routines,然後按一下 New routine 並選擇 Local。設定這些欄位:| 欄位 | 說明 |
|---|---|
| Name | 任務的識別碼。轉換為小寫 kebab-case 並用作磁碟上的資料夾名稱。在您的任務中必須是唯一的。 |
| Description | 在任務清單中顯示的簡短摘要。 |
| Instructions | Claude 執行任務時應執行的操作。以您在提示框中撰寫任何訊息的相同方式撰寫此項。instructions 輸入包括權限模式和模型的選擇器,在其下方您可以選擇工作資料夾以及是否在隔離的 worktree 中執行。 |
| Schedule | 任務執行的頻率。請參閱下方的 schedule options。 |
排程選項
從 Schedule 控制項中選擇預設值:- Manual:無排程,只有在您按一下 Run now 時才執行。適用於儲存您按需觸發的提示
- Hourly:每小時執行一次
- Daily:顯示時間選擇器,預設為本機時間上午 9:00
- Weekdays:與 Daily 相同,但跳過星期六和星期日
- Weekly:顯示時間選擇器和日期選擇器
排程任務如何執行
排程任務在您的機器上執行。Desktop 在應用程式開啟時每分鐘檢查一次排程,並在任務到期時啟動新的工作階段,獨立於您開啟的任何手動工作階段。每個任務在排程時間後會有幾分鐘的小延遲,以錯開 API 流量。延遲是確定性的:同一任務始終在相同的偏移量處啟動。 當任務觸發時,您會收到桌面通知,新的工作階段會在側邊欄的 Scheduled 部分下出現。開啟它以查看 Claude 執行的操作、審查變更或回應權限提示。工作階段的工作方式與任何其他工作階段相同:Claude 可以編輯檔案、執行命令、建立提交和開啟提取請求。 任務只有在 desktop 應用程式執行且您的電腦處於喚醒狀態時才會執行。如果您的電腦在排程時間內進入睡眠狀態,該執行會被跳過。若要防止閒置睡眠,請在 Settings 中的 Desktop app → General 下啟用 Keep computer awake。關閉筆記型電腦蓋仍會使其進入睡眠狀態。對於需要在電腦關閉時執行或應該透過 API 呼叫或 GitHub 事件觸發的任務,請改為建立遠端 routine。錯過的執行
當應用程式啟動或您的電腦喚醒時,Desktop 會檢查每個任務是否在過去七天內錯過了任何執行。如果有,Desktop 會為最近錯過的時間啟動恰好一次的追趕執行,並丟棄任何較舊的執行。錯過六天的每日任務在喚醒時執行一次。Desktop 會在追趕執行啟動時顯示通知。 在撰寫提示時請記住這一點。排程在上午 9 點的任務可能在晚上 11 點執行,如果您的電腦整天都在睡眠狀態。如果時間很重要,請在提示本身中新增護欄,例如:「只審查今天的提交。如果已經過下午 5 點,請跳過審查,只發佈錯過內容的摘要。」排程任務的權限
每個任務都有其自己的權限模式,您在建立或編輯任務時設定。來自~/.claude/settings.json 的允許規則也適用於排程任務工作階段。如果任務在 Ask 模式下執行,並且需要執行它沒有權限的工具,執行會停滯,直到您批准它。工作階段保持在側邊欄中開啟,以便您稍後可以回答。
為了避免停滯,在建立任務後按一下 Run now,監視權限提示,並為每個提示選擇「always allow」。該任務的未來執行會自動批准相同的工具,無需提示。您可以從任務的詳細資料頁面審查和撤銷這些批准。
管理排程任務
按一下 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/中的相關資料。
update_scheduled_task MCP 工具在執行中的工作階段內修改其自己的排程或提示。這可讓任務根據其發現重新排程自己,例如,當它偵測到已建立發行分支時,重新排程程式碼審查以更早執行。
若要在磁碟上編輯任務的提示,請開啟 ~/.claude/scheduled-tasks/<task-name>/SKILL.md(如果設定了 CLAUDE_CONFIG_DIR,則在其下)。該檔案使用 YAML frontmatter 作為 name 和 description,提示作為主體。變更在下一次執行時生效。Schedule、資料夾、模型和啟用狀態不在此檔案中:透過 Edit 表單變更它們或詢問 Claude。
相關資源
- Routines:在 Anthropic 管理的基礎設施上按排程、透過 API 呼叫或回應 GitHub 事件執行任務,即使您的電腦關閉也能執行
- Run prompts on a schedule:在 CLI 中使用
/loop的工作階段範圍排程 - Claude Code GitHub Actions:在 CI 中按排程執行 Claude,而不是在您的機器上執行
- Use Claude Code Desktop:完整的 Desktop 應用程式指南