Routines 与 /loop 调度

Claude Code 的调度能力分两层:

#/loop

/loop 是会话内循环。它每次触发都是一轮普通 prompt,继承当前 session 的上下文、权限、MCP、模型和 Passion8 配置。

/loop 5m check whether the deployment finished

/loop check CI and address any review comments

支持的间隔单位包括 s、m、h、d。底层是 cron,所以秒会向上取整到分钟;不能整除的间隔会被取到接近的 cron cadence。

#loop.md

裸 /loop 可以用自定义默认 prompt:

示例:

检查当前 PR。如果 CI 失败,拉取失败日志并修复。若有 review comments,
逐条处理并回复。若一切安静,只输出一行状态。

loop.md 应该短。官方说明过长内容会被截断,而且每轮都会进入上下文,写得太大等于固定增加成本。

#Cron tools

Claude 也可以直接创建 session-scoped scheduled tasks。常见自然语言:

in 45 minutes, check whether the integration tests passed

remind me at 3pm to push the release branch

底层工具:

限制:

#缓存策略

关键点:

1. /loop 每次触发都是普通新轮次,会刷新当前会话缓存。
2. 如果间隔超过 TTL,下一轮要重读历史。
3. 动态 /loop 如果选择长等待,5m TTL 下不应期待一直热。
4. Background session 仍是同一个 session,但停止期间不会刷新 TTL。
5. Routines 是云端独立 session,不共享本地 Passion8 prompt cache。

#Routines

Routine 是一份保存好的 Claude Code 配置:prompt、仓库、环境、connectors 和触发器。它运行在 Anthropic 托管云端,所以电脑关机也能继续。

触发器:

Routine 适合:

#/schedule

在 CLI 中,/schedule 用对话方式创建或管理 routines:

/schedule daily PR review at 9am

/schedule tomorrow at 9am, summarize yesterday's merged PRs

常用管理:

CLI 创建的主要是 schedule trigger。API 或 GitHub trigger 通常要到 claude.ai/code/routines 配置。

#Routine 权限和网络

Routine 在云端自主运行,不会像本地交互式 session 一样每个工具都等你确认。要把权限收窄:

MCP connector 流量走 Anthropic 托管连接,不等于云端 VM 可以访问同一个域名。需要本机数据库、局域网服务或本地文件时,用本地 /loop 或 Desktop task。

#API 触发

Routine API trigger 会生成一个专用 URL 和 bearer token。POST 到 /fire 会启动一个新 session,返回 session ID 和 URL。请求体可以带一个 text 字段,把告警、日志或部署信息传进去。

curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_xxx/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": "prod deploy failed, check alert SEN-4521"}'

这是 research preview 能力,header、限制和响应结构可能变。不要把 token 写进仓库。

#Passion8 下怎么选

#排错

#官方参考

• Scheduled tasks
• Routines
• Claude Code on the web
• Commands
• Prompt caching