desktop-scheduled-tasks.md +13 −13
8 8
9定期任务在您选择的时间和频率自动启动新会话。使用它们进行定期工作,如日常代码审查、依赖项更新检查或从您的日历和收件箱中提取信息的早晨简报。9定期任务在您选择的时间和频率自动启动新会话。使用它们进行定期工作,如日常代码审查、依赖项更新检查或从您的日历和收件箱中提取信息的早晨简报。
10 10
1111Desktop 应用的 **Routines** 页面让您可以创建本地定期任务和远程 [routines](/zh-CN/routines)。本地任务在您的机器上运行,可直接访问您的文件和工具,但仅在应用打开且计算机处于唤醒状态时才会触发。远程 routine 在 Anthropic 管理的云基础设施上运行,即使您的计算机关闭也可以运行,还可以通过 API 调用或 GitHub 事件触发。本页面涵盖本地定期任务;有关远程 routine 及其触发选项,请参阅 [Routines](/zh-CN/routines)。Desktop 应用的 **Routines** 页面让您可以创建本地定期任务和远程 [routines](/docs/zh-CN/routines)。本地任务在您的机器上运行,可直接访问您的文件和工具,但仅在应用打开且计算机处于唤醒状态时才会触发。远程 routine 在 Anthropic 管理的云基础设施上运行,即使您的计算机关闭也可以运行,还可以通过 API 调用或 GitHub 事件触发。本页面涵盖本地定期任务;有关远程 routine 及其触发选项,请参阅 [Routines](/docs/zh-CN/routines)。
12 12
13<h2 id="compare-scheduling-options">13<h2 id="compare-scheduling-options">
14 比较调度选项14 比较调度选项
16 16
17Claude Code offers three ways to schedule recurring or one-off work:17Claude Code offers three ways to schedule recurring or one-off work:
18 18
1919| | [Cloud](/en/routines) | [Desktop](/en/desktop-scheduled-tasks) | [`/loop`](/en/scheduled-tasks) || | [Cloud](/docs/en/routines) | [Desktop](/docs/en/desktop-scheduled-tasks) | [`/loop`](/docs/en/scheduled-tasks) |
2020| :------------------------- | :----------------------------- | :------------------------------------- | :---------------------------------- || :------------------------- | :---------------------------------- | :------------------------------------- | :---------------------------------- |
2121| Runs on | Anthropic cloud | Your machine | Your machine || Runs on | Cloud, Anthropic-managed by default | Your machine | Your machine |
22| Requires machine on | No | Yes | Yes |22| Requires machine on | No | Yes | Yes |
23| Requires open session | No | No | Yes |23| Requires open session | No | No | Yes |
24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |24| Persistent across restarts | Yes | Yes | Restored on `--resume` if unexpired |
25| Access to local files | No (fresh clone) | Yes | Yes |25| Access to local files | No (fresh clone) | Yes | Yes |
2626| MCP servers | Connectors configured per task | [Config files](/en/mcp) and connectors | Inherits from session || MCP servers | Connectors configured per task | [Config files](/docs/en/mcp) and connectors | Inherits from session |
27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |27| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |28| Customizable schedule | Via `/schedule` in the CLI | Yes | Yes |
29| Minimum interval | 1 hour | 1 minute | 1 minute |29| Minimum interval | 1 hour | 1 minute | 1 minute |
33</Tip>33</Tip>
34 34
35<Note>35<Note>
3636 默认情况下,定期任务针对您的工作目录的任何状态运行,包括未提交的更改。在创建任务时启用 worktree 切换,为每次运行提供其自己的隔离 Git worktree,与 [parallel sessions](/zh-CN/desktop#work-in-parallel-with-sessions) 的工作方式相同。 默认情况下,定期任务针对您的工作目录的任何状态运行,包括未提交的更改。在创建任务时启用 worktree 切换,为每次运行提供其自己的隔离 Git worktree,与 [parallel sessions](/docs/zh-CN/desktop#work-in-parallel-with-sessions) 的工作方式相同。
37</Note>37</Note>
38 38
39<h2 id="create-a-scheduled-task">39<h2 id="create-a-scheduled-task">
75 75
76当任务触发时,您会收到桌面通知,新会话会在侧边栏的 **Scheduled** 部分下出现。打开它以查看 Claude 做了什么、审查更改或响应权限提示。会话的工作方式与任何其他会话相同:Claude 可以编辑文件、运行命令、创建提交和打开拉取请求。76当任务触发时,您会收到桌面通知,新会话会在侧边栏的 **Scheduled** 部分下出现。打开它以查看 Claude 做了什么、审查更改或响应权限提示。会话的工作方式与任何其他会话相同:Claude 可以编辑文件、运行命令、创建提交和打开拉取请求。
77 77
7878任务仅在 desktop 应用运行且计算机处于唤醒状态时运行。如果您的计算机在计划时间内进入睡眠状态,该运行将被跳过。要防止空闲睡眠,请在 Settings 中的 **Desktop app → General** 下启用 **Keep computer awake**。关闭笔记本电脑盖仍会使其进入睡眠状态。对于需要在计算机关闭时运行或应该通过 API 调用或 GitHub 事件触发的任务,请改为创建远程 [routine](/zh-CN/routines)。任务仅在 desktop 应用运行且计算机处于唤醒状态时运行。如果您的计算机在计划时间内进入睡眠状态,该运行将被跳过。要防止空闲睡眠,请在 Settings 中的 **Desktop app → General** 下启用 **Keep computer awake**。关闭笔记本电脑盖仍会使其进入睡眠状态。对于需要在计算机关闭时运行或应该通过 API 调用或 GitHub 事件触发的任务,请改为创建远程 [routine](/docs/zh-CN/routines)。
79 79
80<h2 id="missed-runs">80<h2 id="missed-runs">
81 错过的运行81 错过的运行
93 93
94为了避免停滞,在创建任务后单击 **Run now**,查看权限提示,并为每个提示选择"always allow"。该任务的未来运行会自动批准相同的工具,无需提示。您可以从任务的详细信息页面查看和撤销这些批准。94为了避免停滞,在创建任务后单击 **Run now**,查看权限提示,并为每个提示选择"always allow"。该任务的未来运行会自动批准相同的工具,无需提示。您可以从任务的详细信息页面查看和撤销这些批准。
95 95
9696连接器工具[您的组织设置为 `ask`](/zh-CN/mcp#organization-controls-on-connector-tools)和标记为 [`requiresUserInteraction`](/zh-CN/mcp#require-approval-for-a-specific-tool) 的 MCP 工具在每次调用时都会提示,并且不提供"always allow"选项。调用这些工具的运行每次都会停滞。连接器工具[您的组织设置为 `ask`](/docs/zh-CN/mcp#organization-controls-on-connector-tools)和标记为 [`requiresUserInteraction`](/docs/zh-CN/mcp#require-approval-for-a-specific-tool) 的 MCP 工具在每次调用时都会提示,并且不提供"always allow"选项。调用这些工具的运行每次都会停滞。
97 97
98<h2 id="manage-scheduled-tasks">98<h2 id="manage-scheduled-tasks">
99 管理定期任务99 管理定期任务
112 112
113定期任务还可以使用 `update_scheduled_task` MCP 工具从运行中的会话内修改其自己的调度或提示。这让任务可以根据它发现的内容重新调度自己,例如,当它检测到发布分支已创建时,将代码审查重新调度为更早运行。113定期任务还可以使用 `update_scheduled_task` MCP 工具从运行中的会话内修改其自己的调度或提示。这让任务可以根据它发现的内容重新调度自己,例如,当它检测到发布分支已创建时,将代码审查重新调度为更早运行。
114 114
115115要在磁盘上编辑任务的提示,请打开 `~/.claude/scheduled-tasks/<task-name>/SKILL.md`(如果设置了 [`CLAUDE_CONFIG_DIR`](/zh-CN/env-vars),则在其下)。该文件使用 YAML frontmatter 表示 `name` 和 `description`,提示作为正文。更改在下一次运行时生效。Schedule、folder、model 和 enabled 状态不在此文件中:通过 Edit 表单更改它们或询问 Claude。要在磁盘上编辑任务的提示,请打开 `~/.claude/scheduled-tasks/<task-name>/SKILL.md`(如果设置了 [`CLAUDE_CONFIG_DIR`](/docs/zh-CN/env-vars),则在其下)。该文件使用 YAML frontmatter 表示 `name` 和 `description`,提示作为正文。更改在下一次运行时生效。Schedule、folder、model 和 enabled 状态不在此文件中:通过 Edit 表单更改它们或询问 Claude。
116 116
117<h2 id="related-resources">117<h2 id="related-resources">
118 相关资源118 相关资源
119</h2>119</h2>
120 120
121121* [Routines](/zh-CN/routines):在 Anthropic 管理的基础设施上按计划、通过 API 调用或响应 GitHub 事件运行任务,即使您的计算机关闭* [Routines](/docs/zh-CN/routines):在 Anthropic 管理的基础设施上按计划、通过 API 调用或响应 GitHub 事件运行任务,即使您的计算机关闭
122122* [Run prompts on a schedule](/zh-CN/scheduled-tasks):在 CLI 中使用 `/loop` 的会话范围调度* [Run prompts on a schedule](/docs/zh-CN/scheduled-tasks):在 CLI 中使用 `/loop` 的会话范围调度
123123* [Claude Code GitHub Actions](/zh-CN/github-actions):在 CI 中按计划运行 Claude,而不是在您的机器上* [Claude Code GitHub Actions](/docs/zh-CN/github-actions):在 CI 中按计划运行 Claude,而不是在您的机器上
124124* [Use Claude Code Desktop](/zh-CN/desktop):完整的 Desktop 应用指南* [Use Claude Code Desktop](/docs/zh-CN/desktop):完整的 Desktop 应用指南