每天早上 9 点自动审查代码、每周一检查依赖更新、每天下午生成工作日报——这些重复性工作现在都可以交给 Claude Code Desktop 的定时任务功能自动完成。
三种定时方案对比
Claude Code 提供三种方式安排定期任务:
| 特性 | Cloud 云端 | Desktop 本地 | /loop 会话内 |
|---|---|---|---|
| 运行位置 | Anthropic 云端 | 你的机器 | 你的机器 |
| 需要机器开启 | 否 | 是 | 是 |
| 需要打开会话 | 否 | 否 | 是 |
| 重启后持续 | 是 | 是 | 否 |
| 访问本地文件 | 否(新 clone) | 是 | 是 |
| 最小间隔 | 1 小时 | 1 分钟 | 1 分钟 |
选择建议:
- Cloud 云端:任务必须可靠运行(即使电脑关机)
- Desktop 本地:需要访问本地文件和工具
- /loop:当前会话内的快速轮询
创建定时任务
图形界面方式
- 点击侧边栏 Schedule
- 点击 New task → New local task
- 配置字段:
| 字段 | 说明 |
|---|---|
| Name | 任务标识,自动转为小写短横线格式 |
| Description | 简短描述 |
| Prompt | 发送给 Claude 的指令 |
| Frequency | 执行频率 |
自然语言方式
在任何 Desktop 会话中直接描述:
text
设置一个每天早上 9 点运行的代码审查任务Claude 会自动创建和配置。
频率选项
| 选项 | 说明 |
|---|---|
| Manual | 手动触发 |
| Hourly | 每小时(自动错开最多 10 分钟) |
| Daily | 每天(可选时间,默认 9:00 AM) |
| Weekdays | 工作日(跳过周六日) |
| Weekly | 每周(可选时间和星期几) |
超出预设的频率?用自然语言告诉 Claude:
text
设置一个每 6 小时运行所有测试的任务任务执行机制
运行方式
Desktop 每分钟检查一次调度,到时间就启动新会话。每个任务有固定的最多 10 分钟延迟来错开 API 流量。任务运行时你会收到桌面通知。
错过的任务
如果电脑休眠导致错过了任务,Desktop 启动后会检查过去 7 天内错过的运行:
- 只补跑最近一次错过的时间点
- 更早的错过运行被丢弃
- 比如每天任务错过了 6 天,唤醒后只运行 1 次
💡 如果时机很重要,在 Prompt 中加入防护条件:"如果已经过了下午 5 点,跳过审查,只发个摘要说明遗漏了什么。"
防止休眠
设置 → Desktop app → General → Keep computer awake。注意合上笔记本盖仍会休眠。
权限管理
每个任务有独立的权限模式。避免任务卡住的方法:
- 创建任务后点击 Run now
- 观察权限提示,选择 "always allow"
- 以后该任务自动批准相同工具
实用场景示例
每日代码审查
text
Name: daily-code-review
Frequency: Weekdays 9:00 AM
Prompt: 审查昨天的所有 commits,检查代码质量、安全漏洞和
最佳实践。生成报告并提交为 PR comment。依赖更新检查
text
Name: dependency-audit
Frequency: Weekly Monday 10:00 AM
Prompt: 检查所有 npm 依赖是否有安全漏洞或重大更新。
如果有高危漏洞,创建修复 PR。晨报生成
text
Name: morning-briefing
Frequency: Weekdays 8:30 AM
Prompt: 拉取日历和邮件摘要,整理今天的待办事项和
即将到来的会议,发送到 Slack。管理任务
在 Schedule 列表中可以:
- Run now:立即运行
- Toggle repeats:暂停/恢复
- Edit:修改配置
- Review history:查看历史运行
- Delete:删除任务
或者用自然语言管理:"暂停我的依赖审查任务"、"删除 standup-prep 任务"。
高级:磁盘编辑
任务的 Prompt 存储在 ~/.claude/scheduled-tasks/<name>/SKILL.md,使用 YAML frontmatter。手动编辑后下次运行生效。
原文来源:Claude Code Desktop 定时任务文档 | 来源:Claude Code 官方文档