教程

Claude Code 定时任务完整指南:/schedule、Routines 三种触发方式和 /loop 监控

/schedule 命令和 Routines 完整指南:/schedule 创建/查看/运行/编辑/删除定时任务;Routines 三种触发方式(Cron 定时/GitHub 事件/Webhook API /fire 端点);4 个实战 Routine 配置(每日健康检查/PR 自动质量门/每周技术债扫描/CI 失败分析);/loop 会话内定期重复(vs /schedule 的区别对比);Routines 访问权限配置(GitHub/Slack/数据库);以及 Routines + ultrareview/Hooks/Subagents 的组合用法。

2026/5/85分钟 阅读ClaudeEagle

Claude Code 的 /schedule 命令(Week 15 引入)让你从终端创建、管理和运行定时远程 Agent 任务——配合 Routines 的三种触发方式(定时/GitHub 事件/API 调用),构建完整的自动化工作流。本文是定时任务和 Routines 的完整使用指南。


/schedule 命令

/schedule 让你在 Claude Code 终端里管理定时云端 Agent:

bash
# 创建定时任务
/schedule create "每天早上 9 点检查 GitHub Issues,汇总昨天新增的 bug 报告"

# 查看所有任务
/schedule list

# 运行特定任务(立即触发一次)
/schedule run task-name

# 编辑任务
/schedule edit task-name

# 删除任务
/schedule delete task-name

Routines:三种触发方式

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 云端
bash
# 从任何地方触发 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 是另一个定时工具,在当前交互式会话内定期执行:

bash
# 每 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

相关文章推荐

教程Claude Code Routines 完全使用指南:定时 Agent、GitHub 事件触发、Webhook API 全解析Claude Code Routines 功能完整指南:三种触发方式详解(Cron 时间表/GitHub 事件/API Webhook);网页 UI 和 CLI 两种创建方式;每日健康检查/PR 自动审查/CI 失败分析/周报生成/依赖安全扫描/Issue 分类 6 个完整模板;以及运行监控和常见问题排查。2026/5/1教程Claude Code Routines 完全指南:10 个开箱即用的 AI 自动化开发任务模板Claude Code Routines 实战指南:定时触发和事件触发配置语法,10 个开箱即用模板(依赖漏洞扫描/技术债追踪/夜间重构/PR 初审/周报生成等),以及幂等性、错误处理最佳实践。2026/4/16教程Claude Code 定时任务完整指南:每天自动 review 代码、检查依赖、生成日报Claude Code 定时任务完整配置指南:Desktop 本地任务、云端任务、/loop 三种方式对比,含 5 个实用任务模板(每日代码 review、依赖漏洞扫描、技术债报告),以及权限防卡死和补跑机制详解。2026/4/13教程Claude Code Desktop 定时任务完全指南:自动化每日代码审查、依赖更新和晨报Claude Code Desktop 定时任务完整教程:支持每日代码审查、依赖更新检查、晨报生成等自动化工作流。含三种定时方案对比、配置方法和实用场景示例。2026/4/7教程Claude Code 定时任务(Scheduled Tasks)完全指南:/loop 命令、Cron 表达式与三日自动过期Claude Code 定时任务完整指南:/loop Bundled Skill(三种间隔写法:前置 token/trailing every/默认 10 分钟;对 Skill 命令循环执行)、一次性自然语言提醒(自动删除)、CronCreate/CronList/CronDelete 三个底层工具、运行机制(低优先级/两轮之间触发/本地时区)、随机延迟机制(重复任务 0~10% 偏移/单次任务 90 秒)、三日自动过期、Cron 表达式参考表、CLAUDE_CODE_DISABLE_CRON 禁用,以及会话级局限性(退出消失/无补偿/无持久化)和持久化替代方案(Desktop/GitHub Actions)。2026/3/8教程Claude Code 自定义 Agents 完整指南:创建专用 AI 编程助手Claude Code 自定义 Agents 完整指南:Agent 定义文件格式(Frontmatter 字段:name/description/tools/permissionMode/model/effort/context);4 种调用方式(/agents 界面/--agent CLI/对话提及/Print 模式自动化);4 个实战 Agent 配置(安全审查员/数据库优化顾问/无障碍合规检查/TypeScript 类型安全/CI 失败分析师);skillOverrides 控制可见性;context: fork 独立上下文;以及在 GitHub Actions 里使用 Agent 的 CI 配置示例。2026/5/7