Claude Code 平台集成
Claude Code 平台集成
桌面版定时任务
1 分钟阅读
在 Claude Code 桌面版中设置定时任务
在 Claude Code 桌面版中设置定时任务，让 Claude 按重复计划自动运行，用于每日代码审查、依赖项审计或早晨简报。
定时任务在你选择的时间和频率自动启动新会话。用它们来处理重复性工作，例如每日代码审查、依赖项更新检查，或从日历和收件箱拉取信息的早晨简报。
桌面版应用的 例行程序 页面允许你创建本地定时任务和远程 例行程序。本地任务在你的机器上运行，可直接访问你的文件和工具，但仅在应用打开且电脑处于唤醒状态时才会触发。远程例行程序在 Anthropic 管理的云基础设施上运行，即使你的电脑关闭也能运行，并且还可以通过 API 调用或 GitHub 事件触发。本页面涵盖本地定时任务；有关远程例行程序及其触发选项，请参阅 例行程序。
对比调度选项
Claude Code 提供三种方式来安排重复性或一次性工作：
| 云端 | 桌面版 | /loop | |
|---|---|---|---|
| 运行环境 | Anthropic 云 | 你的机器 | 你的机器 |
| 需要机器开机 | 否 | 是 | 是 |
| 需要打开会话 | 否 | 否 | 是 |
| 重启后保持 | 是 | 是 | 未过期时通过 --resume 恢复 |
| 访问本地文件 | 否（全新克隆） | 是 | 是 |
| MCP 服务器 | 按任务配置的连接器 | 配置文件 和连接器 | 继承自会话 |
| 权限提示 | 否（自主运行） | 可按任务配置 | 继承自会话 |
| 可自定义计划 | 通过 CLI 中的 /schedule | 是 | 是 |
| 最小间隔 | 1 小时 | 1 分钟 | 1 分钟 |
默认情况下，定时任务针对你工作目录的当前状态运行，包括未提交的更改。创建任务时启用工作树切换，为每次运行提供独立的隔离 Git 工作树，与 并行会话 的工作方式相同。
创建定时任务
点击侧边栏中的 例行程序，然后点击 新建例行程序 并选择 本地。配置以下字段：
| 字段 | 描述 |
|---|---|
| 名称 | 任务的标识符。转换为小写短横线命名法（kebab-case），并用作磁盘上的文件夹名称。在你的所有任务中必须唯一。 |
| 描述 | 任务列表中显示的简短摘要。 |
| 指令 | 任务运行时 Claude 应该执行的操作。按照你在提示框中编写任何消息的方式编写此内容。指令输入包含权限模式和模型的选择器，在其下方你可以选择工作文件夹以及是否在隔离的工作树中运行。 |
| 计划 | 任务运行的频率。请参阅下方的 计划选项。 |
保存任务前需要选择一个文件夹。如果你尚未信任该文件夹，桌面版会在保存前提示你信任它。
你还可以通过在任何会话中描述你想要的内容来创建任务。例如，"设置一个每天早上 9 点运行的每日代码审查"会创建一个重复任务，而"明天下午 3 点提醒我看部署情况"会创建一个在触发后自动禁用的一次性任务。
计划选项
从计划控件中选择一个预设：
- 手动：无计划，仅在点击 立即运行 时执行。适用于保存你按需触发的提示
- 每小时：每小时运行一次
- 每日：显示时间选择器，默认本地时间上午 9:00
- 工作日：与每日相同，但跳过周六和周日
- 每周：显示时间选择器和日期选择器
对于选择器未提供的间隔，例如每 15 分钟、每月第一天，或特定未来时间的单次运行，请在任何桌面版会话中让 Claude 设置计划。使用自然语言；例如，"设置一个每 6 小时运行所有测试的任务。"
定时任务的运行方式
定时任务在你的机器上运行。桌面版在应用打开时每分钟检查一次计划，并在任务到期时启动新会话，独立于你打开的任何手动会话。每个任务在计划时间后会有几分钟的小延迟，以分散 API 流量。该延迟是确定性的：同一任务始终以相同的偏移量启动。
当任务触发时，你会收到桌面通知，并且侧边栏中 定时 部分下会出现一个新会话。打开它以查看 Claude 做了什么、审查更改或响应权限提示。该会话与任何其他会话一样工作：Claude 可以编辑文件、运行命令、创建提交和打开拉取请求。
任务仅在桌面版应用运行且你的电脑处于唤醒状态时运行。如果你的电脑在计划时间处于睡眠状态，该次运行将被跳过。为防止空闲睡眠，请在设置中的 桌面版应用 → 通用 下启用 保持电脑唤醒。合上笔记本电脑盖子仍会使其进入睡眠状态。对于需要在你电脑关闭时运行，或应通过 API 调用或 GitHub 事件触发的任务，请改为创建远程 例行程序。
错过的运行
当应用启动或你的电脑唤醒时，桌面版会检查每个任务在过去七天内是否错过了任何运行。如果有，桌面版会为最近错过的时间启动一次补运行，并丢弃更早的运行。一个错过了六天的每日任务在唤醒时只会运行一次。桌面版会在补运行启动时显示通知。
编写提示时请牢记这一点。计划在上午 9 点运行的任务，如果你的电脑整天处于睡眠状态，可能会在晚上 11 点运行。如果时间很重要，请在提示本身中添加保护措施，例如："仅审查今天的提交。如果已过下午 5 点，跳过审查并仅发布错过的内容摘要。"
定时任务的权限
每个任务都有自己的权限模式，你在创建或编辑任务时进行设置。~/.claude/settings.json 中的允许规则也适用于定时任务会话。如果任务在询问模式下运行，需要运行它没有权限的工具，运行将暂停，直到你批准它。会话会保持在侧边栏中，以便你以后回答。
为避免暂停，请在创建任务后点击 立即运行，观察权限提示，并为每个提示选择"始终允许"。该任务的未来运行将自动批准相同的工具，无需提示。你可以从任务的详情页面审查和撤销这些批准。
管理定时任务
点击 例行程序 列表中的任务以打开其详情页面。在这里你可以：
- 立即运行：立即启动任务，无需等待下一次计划时间
- 状态：在活跃和暂停之间切换，以暂停或恢复计划运行，而无需删除任务
- 编辑：更改指令、计划、文件夹或其他设置
- 查看历史：查看每次过去的运行，包括跳过的运行。将鼠标悬停在跳过的条目上以查看原因：你的电脑处于睡眠状态、上一次运行仍在进行中，或其他定时任务已在运行。点击 显示更多 加载更早的条目。
- 审查允许的权限：在 始终允许 面板中查看和撤销为此任务保存的工具批准
- 删除：删除任务并归档它创建的所有会话。确认对话框中会出现 同时删除磁盘上的文件 复选框；勾选它以同时从
~/.claude/scheduled-tasks/中删除任务的SKILL.md文件和相关数据。
你还可以通过在任何桌面版会话中询问 Claude 来列出、创建、编辑和暂停任务。例如，"暂停我的 dependency-audit 任务"或"显示我的定时任务"。要删除任务，请使用其详情页面上的 删除 按钮。
定时任务还可以在运行会话中使用 update_scheduled_task MCP 工具修改自己的计划或提示。这让任务可以根据发现的内容重新安排自己，例如，当检测到已创建发布分支时，将代码审查提前运行。
要编辑磁盘上的任务提示，请打开 ~/.claude/scheduled-tasks/<task-name>/SKILL.md（如果在 CLAUDE_CONFIG_DIR 下则使用该目录）。该文件使用 YAML frontmatter 作为 name 和 description，正文为提示内容。更改将在下一次运行时生效。计划、文件夹、模型和启用状态不在此文件中：通过编辑表单或询问 Claude 进行更改。
相关资源
- 例行程序：在 Anthropic 管理的基础设施上按计划、通过 API 调用或响应 GitHub 事件运行任务，即使你的电脑关闭也能运行
- 按计划运行提示：在 CLI 中使用
/loop进行会话范围的调度 - Claude Code GitHub Actions：在 CI 中而不是在你的机器上按计划运行 Claude
- Claude Code 桌面版使用指南：完整的桌面版应用指南