
很多开发者每天早上的头半小时都花在同几件事上:看昨天新开的 PR、查 CI 有没有挂、扫一遍依赖有没有新漏洞。这些事不难,但天天要做,而且 Claude Code 默认要你开着终端守着,笔记本一合盖,会话就断了。
Claude Code 的 Routines(早期叫云端定时任务)就是为这类重复工作准备的:把 prompt、仓库和连接器保存成一个 Routine,交给 Anthropic 管理的云端环境按时运行,电脑关机也照常执行。除了定时,它还能由 API 请求或 GitHub 事件触发。
这篇适合已经在用 Claude Code、想把日常巡检和代码审查自动化的开发者。下面依次讲:Claude Code 定时任务的三种方式怎么选、创建 Routine 的六个步骤、三种触发器、常见场景,以及用量、权限和安全上的注意事项。
Claude Code 定时任务有三种,先选对方式

| 方式 | 运行位置 | 电脑关机还能跑吗 | 能读本地文件吗 | 最小间隔 | 适合 |
|---|---|---|---|---|---|
| Routines(云端) | Anthropic 管理的云端环境 | 能 | 不能,每次重新 clone 仓库 | 1 小时 | 不依赖本地环境的定期任务 |
| Desktop 定时任务 | 你自己的电脑 | 不能 | 能,也能用本地 MCP 服务 | 1 分钟 | 需要本地工具链的任务 |
/loop | 当前 CLI 会话内 | 会话关掉就停 | 能 | 1 分钟 | 临时轮询,比如等一次 CI 跑完 |
简单判断:不需要本地文件的定期任务用 Routines;要访问本地环境的用 Desktop 定时任务;临时盯一件事用 /loop。
创建 Routine 的三个入口
三个入口写入的是同一个 claude.ai 账号,在 CLI 创建的 Routine 会立刻出现在网页上:
- 网页端:打开 claude.ai/code/routines,点 New routine。
- 桌面端:在 Code 标签页侧边栏点 Routines → New routine,选 Cloud(选 Local 创建的是本机运行的 Desktop 定时任务)。
- 命令行:在任意 Claude Code 会话里输入
/schedule(别名/routines),Claude 会追问时间、仓库和 prompt,也可以直接带上描述:
/schedule daily PR review at 9am
/schedule 需要用 claude.ai 订阅账号登录。如果终端里设置了 ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 或用的是云厂商的接入方式,CLI 会提示命令不可用,这时直接去网页端创建即可。Routines 目前对 Pro、Max、Team、Enterprise 订阅开放,仍处于 research preview 阶段。
用网页端创建:六个步骤

第一步:写清楚 prompt
任务名随意,关键是 prompt。Routine 运行时没有人在旁边回答问题,prompt 就是它的全部指令,所以要写清楚做什么、怎样算完成、遇到异常怎么处理。每天审 PR 的 prompt 可以这样写:
检查仓库所有 open 状态的 PR。对每个 PR:
1. 阅读改动的代码
2. 检查是否有明显的 bug、性能问题或风格问题
3. 如果发现问题,在 PR 下留 comment 指出具体行号和建议
4. 如果没有问题,留一个 approve comment
跳过标记了 WIP 或 draft 的 PR。
prompt 输入框旁边可以选模型,每次运行都用这个模型。日常审 PR 用 Sonnet 一般够用,复杂的代码分析可以换 Opus。
第二步:选仓库
添加一个或多个 GitHub 仓库,每次运行开始时都会重新 clone,默认从默认分支开始。Claude 的改动默认推到 claude/ 前缀的分支,避免定时任务直接改 main。想限制它能推送哪些分支,用 GitHub 的分支保护规则或 rulesets 来控制。
第三步:配置环境
每个 Routine 跑在一个云端环境里,可以设置三样东西:
- 网络权限:默认环境是 Trusted 级别,只放行常见包管理源、云服务 API 等默认白名单;要访问自己的服务,需要在环境里加 Allowed domains。
- 环境变量:运行时可用的配置。官方提醒环境变量对所有使用该环境的人可见,API 密钥更适合存成 network secrets。
- Setup 脚本:安装依赖,比如
pip install -r requirements.txt。脚本结果会缓存,不会每次运行都重装。
第四步:设触发器
定时触发有 Hourly、Daily、Weekdays、Weekly 四种预设,时间按你的本地时区填写,会自动换算。需要「每 2 小时」「每月 1 号」这类频率时,先选最接近的预设,再用 CLI 的 /schedule update 改成具体的 cron 表达式,最小间隔 1 小时。
整点(如 9:00)触发可能晚几分钟才开始,想准时一些可以设成 9:07 这类非整点时间。还可以设置只运行一次的任务,比如:
/schedule tomorrow at 9am, summarize yesterday's merged PRs
第五步:检查连接器
你在 claude.ai 上连接的 Slack、Linear、Google Drive 等 MCP 连接器,创建时会默认全部带上。Routine 运行中可以调用这些连接器的所有工具(包括写操作)且不会再弹确认,所以用不到的要移掉。纯代码审查任务就不需要 Slack 权限。
第六步:创建并查看运行结果
点 Create 后,Routine 出现在列表里,到点自动运行;不想等可以在详情页点 Run now 立即触发。每次运行都会生成一个新会话,可以点进去看 Claude 做了什么、改了哪些代码,也能继续对话或创建 PR。
注意,运行列表里的绿色状态只表示会话正常启动和结束,不代表任务本身成功,要打开记录确认实际结果。
三种触发方式:定时、API、GitHub 事件

- 定时触发:上面讲的预设频率、自定义 cron 和一次性运行。
- API 触发:每个 Routine 有专属的 HTTP 端点,带 bearer token 发 POST 请求就能启动,请求体里的
text字段可以附上告警内容或报错日志。API 触发器只能在网页端添加,token 只显示一次,要及时存进密钥管理工具。 - GitHub 事件触发:可以订阅 Pull request 和 Release 两类事件,并按作者、标题、目标分支、标签、是否草稿等条件过滤。需要先在仓库上安装 Claude GitHub App。
一个 Routine 可以同时挂多个触发器。比如一个代码审查 Routine,每晚定时跑一遍,每个新 PR 创建时自动触发,部署脚本里也能通过 API 调用。
API 触发的请求示例如下(URL 和 token 换成你自己生成的):
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
-H "Authorization: Bearer sk-ant-oat01-xxxxx" \
-H "anthropic-beta: experimental-cc-routine-2026-04-01" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
text 里的内容会被标记为不可信数据,Routine 默认不会照着里面的指令做。如果希望它处理这段内容,要在保存的 prompt 里明确写上,比如「排查请求附带的告警内容」。
常见使用场景

- 每天早上审 PR:Weekdays 9:07 定时运行,扫所有 open PR 并留 review 意见,上班后直接看结论。
- CI 失败分析:每天检查 CI 状态,有失败的构建就分析原因,在对应 PR 下留言。
- 依赖审计:每周一检查
package.json或requirements.txt里的依赖有没有已知漏洞,有的话开一个升级 PR。 - Backlog 整理:工作日晚上通过连接器读取新 issue,按代码区域打标签、分配负责人,把摘要发到 Slack。
- 告警分级:监控系统超过阈值时调用 API,Routine 拉取堆栈、关联最近的 commit,开一个带修复建议的 draft PR。
- 部署验证:CD 流水线部署完成后调用 API,跑冒烟检查、扫错误日志,再发 go / no-go。
- 文档漂移检测:每周扫一遍合并的 PR,找出引用了已变更 API 的文档,开更新 PR。
如果你的自动化更偏向脚本和 CI,也可以参考 Codex 的做法:codex exec,把 Codex 接进 CI、脚本和定时任务。
管理与调试
CLI 管理最方便:
/schedule list # 查看所有 Routine
/schedule update # 修改配置
/schedule run # 立即触发一次
较新版本的 CLI 还能直接问运行记录,比如 /schedule why did my nightly review do nothing this morning?,Claude 会列出最近几次运行并读日志解释原因。网页端详情页可以暂停 / 恢复、编辑和删除 Routine。
任务表现不对时,点进某次运行的会话看完整记录,大多数问题出在 prompt 写得不够具体。
限制与注意事项

- 仍是 research preview:行为、限制和 API 都可能变化,不建议让关键生产流程硬依赖它。
- 没有审批环节:Routine 全自主运行,没有权限确认弹窗。它能做什么取决于你给的仓库、环境网络、变量和连接器,给多了就是安全风险。
- 以你的身份操作:开的 PR 显示你的 GitHub 用户名,Slack 消息和 Linear 工单也用你绑定的账号。
- 消耗订阅用量:每次运行和交互式会话一样计入你的订阅用量。每小时触发的 Routine 一天就是 24 次会话,频率要按需要设。另外,定时运行每个账号每小时上限 100 次,Run now 与 API 触发也各有小时上限。
- GitHub 连接失效会暂停:运行时 GitHub 授权失效,Routine 会跳过运行,72 小时内重连可自动恢复,超过则会关闭。
- 平台绑定:自动化流程深度绑定 Anthropic 云端后,迁移成本会上升。在意可移植性的话,可以只用 API 触发,把编排逻辑留在自己的系统里。
总结
Routines 本质上是「cron + Claude Code 会话 + 云端执行环境」,再加上 API 和 GitHub 事件触发。它适合那些每天都在做、又不值得专门写自动化脚本的重复工作:审 PR、分析 CI 失败、依赖审计、文档同步。
建议从低风险的任务开始,比如每天早上只读不写地审一遍 PR,跑几天确认效果后,再逐步放开写权限或接入更多连接器。审查类任务也可以对比 Codex 接入 GitHub 后的高信号 Review 流程,按团队习惯选择。
想先用一个简单的审查任务试试 Routines,可以在 AIGoCode 上直接使用 Claude Code。
参考链接
- Claude Code 官方文档:Automate work with routines:https://code.claude.com/docs/en/routines
- 创建入口:https://claude.ai/code/routines