跳轉到主要內容

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.

排程任務會在您選擇的時間和頻率自動啟動新的工作階段。使用它們進行定期工作,例如每日程式碼審查、相依性更新檢查,或從您的日曆和收件匣提取資訊的早晨簡報。 Desktop 應用程式的 Routines 頁面可讓您建立本機排程任務和遠端 routines。本機任務在您的機器上執行,可直接存取您的檔案和工具,但只有在應用程式開啟且您的電腦處於喚醒狀態時才會觸發。遠端 routine 在 Anthropic 管理的雲端基礎設施上執行,即使您的電腦關閉也能執行,並且也可以透過 API 呼叫或 GitHub 事件觸發。本頁涵蓋本機排程任務;如需遠端 routine 及其觸發選項,請參閱 Routines

比較排程選項

Claude Code offers three ways to schedule recurring or one-off work:
CloudDesktop/loop
Runs onAnthropic cloudYour machineYour machine
Requires machine onNoYesYes
Requires open sessionNoNoYes
Persistent across restartsYesYesRestored on --resume if unexpired
Access to local filesNo (fresh clone)YesYes
MCP serversConnectors configured per taskConfig files and connectorsInherits from session
Permission promptsNo (runs autonomously)Configurable per taskInherits from session
Customizable scheduleVia /schedule in the CLIYesYes
Minimum interval1 hour1 minute1 minute
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
根據預設,排程任務會針對您的工作目錄的任何狀態執行,包括未提交的變更。在建立任務時啟用 worktree 切換,為每次執行提供其自己的隔離 Git worktree,與 parallel sessions 的工作方式相同。

建立排程任務

按一下側邊欄中的 Routines,然後按一下 New routine 並選擇 Local。設定這些欄位:
欄位說明
Name任務的識別碼。轉換為小寫 kebab-case 並用作磁碟上的資料夾名稱。在您的任務中必須是唯一的。
Description在任務清單中顯示的簡短摘要。
InstructionsClaude 執行任務時應執行的操作。以您在提示框中撰寫任何訊息的相同方式撰寫此項。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 應用程式執行且您的電腦處於喚醒狀態時才會執行。如果您的電腦在排程時間內進入睡眠狀態,該執行會被跳過。若要防止閒置睡眠,請在 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/ 中的相關資料。
您也可以透過在任何 Desktop 工作階段中詢問 Claude 來列出、建立、編輯和暫停任務。例如,「暫停我的 dependency-audit 任務」或「顯示我的排程任務」。若要刪除任務,請使用其詳細資料頁面上的 Delete 按鈕。 排程任務也可以使用 update_scheduled_task MCP 工具在執行中的工作階段內修改其自己的排程或提示。這可讓任務根據其發現重新排程自己,例如,當它偵測到已建立發行分支時,重新排程程式碼審查以更早執行。 若要在磁碟上編輯任務的提示,請開啟 ~/.claude/scheduled-tasks/<task-name>/SKILL.md(如果設定了 CLAUDE_CONFIG_DIR,則在其下)。該檔案使用 YAML frontmatter 作為 namedescription,提示作為主體。變更在下一次執行時生效。Schedule、資料夾、模型和啟用狀態不在此檔案中:透過 Edit 表單變更它們或詢問 Claude。

相關資源