让 Claude Code 在你睡觉时自动完成:每天早上 9 点 review 昨天的代码、每小时检查一次依赖漏洞、每周一生成技术债报告。这些通过定时任务实现,不需要你盯着终端。
三种定时方式,怎么选?
| 方式 | 运行在哪里 | 需要电脑开着? | 访问本地文件? | 最小间隔 |
|---|---|---|---|---|
| Desktop 本地任务 | 你的机器 | 是 | 是 | 1 分钟 |
| 云端任务 | Anthropic 云 | 否 | 否(克隆仓库) | 1 小时 |
/loop CLI 命令 | 你的机器 | 是(需开 session) | 是 | 1 分钟 |
选择建议:
- 需要本地文件/数据库 → Desktop 本地任务
- 电脑可能关机、不能漏任务 → 云端任务
- 临时循环任务 →
/loop
Desktop 定时任务:最常用的方式
图形界面创建
- Claude Code Desktop → 左侧「Schedule」
- 点「New task」→「New local task」
- 填写:Name、Description、Prompt、Frequency
对话创建(更自然)
在任意 Desktop 会话里说:
text
帮我设置一个每天早上 9 点运行的代码 review 任务Claude 直接帮你配置好。
5 个实用定时任务示例
任务 1:每日代码 Review
频率:工作日 9:00 AM
text
Review yesterday's git commits in this repository.
For each commit: check for bugs, flag security concerns, identify refactor opportunities.
Only review commits since yesterday (git log --since=yesterday).
If it's after 5pm, skip review and post a summary of what was missed instead.
Save findings to daily-review/YYYY-MM-DD.md and commit.关键:「5 点后跳过」防止电脑唤醒补跑时在深夜做无意义的 review。
任务 2:依赖漏洞扫描
频率:每天
text
Run npm audit (or cargo audit / pip-audit based on project type).
If vulnerabilities found:
- Critical/High: create GitHub issue with fix suggestion
- Medium/Low: append to security/audit-log.md
If none: add one-line entry to audit-log.md with today's date.任务 3:每周技术债报告
频率:周一 8:30 AM
text
Analyze codebase for technical debt:
1. Functions longer than 100 lines
2. Files with TODO/FIXME comments (count per file)
3. Files with no corresponding test file
Generate report at reports/tech-debt-YYYY-WW.md with:
- Executive summary (3 sentences)
- Top 5 priority items
- Trend vs last week任务 4:早晨工作简报
频率:工作日 8:00 AM
text
Generate morning briefing:
1. Yesterday's commits summary
2. Open PRs needing review
3. Any CI failures overnight
4. TODOs added in last 24 hours
Output to briefing/YYYY-MM-DD-morning.md任务 5:自动格式化
频率:每天
text
Run formatter and linter:
1. npx prettier --write "src/**/*.{ts,tsx,js}"
2. npx eslint --fix "src/**/*.ts"
3. If files changed, git commit: "style: auto-format"
Only commit if there are actual changes.权限模式和防卡死
核心问题:定时任务在后台跑,没人看,遇到需要确认的操作会卡住。
解决:创建任务后立刻点「Run now」手动跑一次,遇到确认时选「Always allow」。后续自动运行不再卡。
或者在任务编辑页面直接设置 auto 权限模式。
管理定时任务
对话管理(最快)
text
暂停我的 dependency-audit 任务
把每日 review 改成下午 3 点运行
帮我看看我现在有哪些定时任务直接编辑 Prompt 文件
bash
~/.claude/scheduled-tasks/<task-name>/SKILL.md直接编辑,下次运行自动生效。
补跑机制(防止漏跑)
- 电脑唤醒后检查过去 7 天是否有漏跑
- 每个任务最多补跑一次(只补最近那次)
- 加时间守卫防止补跑做出不合时宜的操作
text
# 在 Prompt 里加
If current time is between 9pm-7am, log "Skipped: off-hours" and exit.来源:Claude Code Desktop Scheduled Tasks 官方文档 | 整理:ClaudeEagle