Claude Code 的 /schedule 命令(Week 15 引入)让你从终端创建、管理和运行定时远程 Agent 任务——配合 Routines 的三种触发方式(定时/GitHub 事件/API 调用),构建完整的自动化工作流。本文是定时任务和 Routines 的完整使用指南。
/schedule 命令
/schedule 让你在 Claude Code 终端里管理定时云端 Agent:
# 创建定时任务
/schedule create "每天早上 9 点检查 GitHub Issues,汇总昨天新增的 bug 报告"
# 查看所有任务
/schedule list
# 运行特定任务(立即触发一次)
/schedule run task-name
# 编辑任务
/schedule edit task-name
# 删除任务
/schedule delete task-nameRoutines:三种触发方式
Routines 是 Claude Code on the web 里的云端定时 Agent 框架(Week 16 引入),支持三种触发方式:
1. 定时触发(Schedule)
触发条件:Cron 表达式或自然语言时间描述
执行位置:Anthropic 云端
示例 Routine:
名称:Daily PR Review
触发:每天 9:00 AM
任务:
- 获取过去 24 小时的所有 PR
- 检查是否有超过 48 小时未被审查的 PR
- 给仍然开着的 PR 的作者发 Slack 通知
- 生成当天的 PR 摘要,发到 #engineering 频道
2. GitHub 事件触发
触发条件:Push、PR 创建/更新、Issue 创建、CI 失败等
执行位置:Anthropic 云端
示例 Routine:
名称:CI Failure Analyzer
触发:GitHub Actions 工作流失败
任务:
- 分析失败日志,找出根本原因
- 判断是临时性失败(网络问题等)还是代码问题
- 如果是代码问题,在失败的 PR 上添加评论,描述问题和修复建议
- 如果是临时性失败,自动重试
3. Webhook/API 触发(/fire 端点)
触发条件:HTTP POST 请求到 Routine 的 /fire 端点
执行位置:Anthropic 云端
# 从任何地方触发 Routine
curl -X POST https://claude.ai/api/routines/{routine-id}/fire \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"context": "来自部署流程的触发"}'适合:集成到现有 CI/CD 流程、作为 Webhook 端点、从其他自动化系统触发。
实战 Routine 配置示例
每日健康检查
名称:Daily Health Check
触发:每天 8:30 AM(工作日)
任务:
1. 检查生产环境的错误率(最近 24 小时)
2. 检查 API 响应时间 P95
3. 检查数据库连接池使用率
4. 检查磁盘使用量
如果任何指标超出阈值:
- 在 #alerts 频道发送告警
- 创建一个优先级为 High 的 GitHub Issue
- @mention 值班的 on-call 工程师
输出日报到 #daily-health 频道,包含所有指标的趋势图
PR 自动检查
名称:PR Quality Gate
触发:GitHub PR 创建或更新
任务:
1. 运行 /ultrareview 对 PR 做并行多 Agent 审查
2. 检查测试覆盖率是否满足 80% 阈值
3. 检查 PR 描述是否包含必要字段(Why/What/Testing)
4. 如果所有检查通过,添加 ✅ 标签
5. 如果有问题,在 PR 上添加详细的审查评论,并请求修改
阈值配置:
- 测试覆盖率下降 > 5%:阻断
- 安全漏洞(Critical/High):阻断
- 其他问题:评论但不阻断
每周技术债清理
名称:Weekly Tech Debt Scan
触发:每周一 7:00 AM
任务:
1. 扫描所有 TODO/FIXME/HACK 注释,分类统计
2. 识别超过 90 天的 TODO 注释(可能已经腐烂)
3. 检查 package.json 是否有主要版本升级可用
4. 生成技术债报告
输出:
- 更新 TECH_DEBT.md 文件
- 在 #engineering 频道发周报
- 对超过 90 天的 TODO,创建对应的 GitHub Issue
/loop 命令:会话内定期重复
/loop 是另一个定时工具,在当前交互式会话内定期执行:
# 每 30 分钟检查一次
/loop 30m 运行 lint 检查,有错误就报告
# 每小时运行一次
/loop 1h 运行完整测试套件
# 省略间隔,Claude 自动决定频率
/loop 监控 logs/error.log,有新错误就分析原因/loop vs /schedule 的区别:
| /loop | /schedule | |
|---|---|---|
| 执行位置 | 当前本地会话 | Anthropic 云端 |
| 需要终端开着 | 是 | 否 |
| 适合 | 监控长任务、等待外部服务 | 后台定时任务、跨天运行 |
| 持久性 | 关闭终端后停止 | 持续运行直到删除 |
Routines 的访问权限
Routines 在云端运行,需要配置访问权限:
访问 GitHub:需要授权 Claude Code 访问你的 GitHub 账户
访问 Slack:需要安装 Claude Code 的 Slack App
访问数据库:通过 MCP 服务器配置(在 Routine 设置里)
访问代码库:通过 GitHub 集成自动获取
与其他功能的配合
Routines + /ultrareview:
触发:PR 创建时
自动运行 claude ultrareview --json 输出审查结果
如果发现 Critical 问题,阻断 PR 合并
Routines + Hooks:
Routine 执行完成后,通过 Webhook 触发下一个 Routine
实现多步骤自动化流水线
Routines + Subagents:
Routine 内部启动多个 Subagent 并行工作
主 Routine 汇总所有 Subagent 的结果
来源:Claude Code 官方文档 - Run prompts on a schedule | What's New Week 15 | What's New Week 16 | 整理:ClaudeEagle