Claude routines 推送通知:云端任务需要你时立即知道

Claude routines 是 Claude Code 中无需你值守就能运行的部分。你只需保存一次提示词和代码仓库,Anthropic 的云端就会每晚、每当有新的 pull request,或者监控系统调用某个端点时,启动一个全新的 Claude Code 会话。你的笔记本电脑可以合上。
问题在于,routine 不会通知任何人。运行结果留在 claude.ai 的会话里,等你亲自去看。运行列表也帮不上太多忙:绿色状态只表示会话已启动并正常退出,没有基础设施错误,并不代表任务成功。一次发现构建已损坏的夜间依赖检查,和一次什么都没发现的检查,看起来完全一样。
本指南让 routine 通过 Pocket Alert 向你的手机发送推送通知:一切正常时发一条安静的通知,需要你处理时发一条醒目的通知。
Claude routines 简介
Anthropic 现在把它们称为定时任务(scheduled tasks)。"Routines" 是更早的名称,在网址(claude.ai/code/routines)、/routines CLI 别名和 API 中仍然可以看到。这是同一个功能,目前处于研究预览阶段。
一个 routine 是一份保存好的 Claude Code 配置,包括提示词、一个或多个 GitHub 代码仓库、云端环境以及一组连接器。每次运行都是一个完整的云端会话,可以执行 shell 命令、编辑代码、推送到 claude/ 分支并调用连接器。运行由触发器启动,一个 routine 可以配置多个触发器:
- 计划任务:每小时、每天、每周的预设,自定义 cron 表达式(频率不超过每小时一次),或在指定时间运行一次。
- API:向 routine 专属的
/fire端点发送 POST 请求,并携带 bearer token。你可以传入text字段,比如告警内容,运行时会将其作为上下文接收。 - GitHub:在安装了 Claude GitHub App 的仓库上响应 pull request、release 或 issue 事件,并可按作者、分支、标签、草稿状态等过滤 pull request。
你可以在 claude.ai/code/routines 点击 New task 创建 routine,也可以在 Desktop 应用中创建,或者在 Claude Code CLI 中使用 /schedule,例如 /schedule daily PR review at 9am。使用 routine 需要 Pro、Max、Team 或 Enterprise 套餐,运行时会和交互式会话一样消耗你的订阅用量。
准备工作
- 一个 Pocket Alert 账户,一个来自 API Keys 的 API 密钥,以及装在你的 iPhone 或 Android 手机上的应用。免费套餐即可使用。
- 一个 routine,或者一个准备创建 routine 的计划。
让运行结果到达手机有两种方式:在会话中用 curl 调用 Pocket Alert API,或者把 Pocket Alert MCP 服务器 添加为连接器。建议先用 curl。它适用于所有支持 routine 的套餐,而且密钥永远不会进入会话。
设置:使用带网络密钥的 curl
routine 的云端环境默认采用 Trusted 网络访问:只允许访问包管理仓库、GitHub 和云服务商 API,其他地址一律不通。api.pocketalert.app 不在这个列表中,因此直接运行 curl 会失败,返回 403 和 x-deny-reason: host_not_allowed。
网络密钥可以同时解决网络和密钥两个问题。你把密钥保存在环境上,Anthropic 的代理会在请求离开会话的虚拟机之后,为你列出的主机自动添加密钥。对于绑定了网络密钥的主机,无论网络访问级别如何都可以访问,而且 Claude 永远看不到密钥本身。
- 在 claude.ai/code/routines 打开该 routine,选择 Edit,然后进入 Advanced settings > General > Cloud environment。将鼠标悬停在环境上,点击其设置图标。
- 在 Network secrets 中点击 Add secret,类型保持为 Bearer。
- Name:
Pocket Alert。Allowed websites:api.pocketalert.app。 - 在 Custom headers 下,把请求头名称从
Authorization改为Token,去掉Bearer前缀,然后把你的 API 密钥粘贴为值。 - 点击 Add。密钥会立即保存,之后无法再次查看。
现在请求中完全不需要包含密钥。把以下内容添加到 routine 提示词的末尾:
When you are done, send exactly one push notification with curl:
curl -sS https://api.pocketalert.app/v1/messages \
-H 'Content-Type: application/json' \
--data-binary @- <<'EOF'
{"title": "<routine name>: <one-line result>", "message": "<2-3 sentence summary>", "level": "<level>"}
EOF
Do not add any auth header; the environment adds it. Build valid JSON.
Pick the level:
- "low" if the run finished and nothing needs my attention.
- "default" if you opened a pull request or found something worth reading today.
- "high" only if the work failed, tests are broken, or you found a real problem.
Include the session link from:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
最后一行来自 Anthropic 的文档:每个云端会话都可以从 CLAUDE_CODE_REMOTE_SESSION_ID 中读取自己的 ID,这条命令会把它转换为会话记录的 URL。消息中带上这个链接后,你只需点一下,就能从推送直接跳到对应的运行记录。
在第一次计划运行之前,点击 routine 页面上的 Run now 进行测试。
如果你的环境对话框中没有 Custom headers 一行(在没有管理员角色的 Team 套餐上,表单只要求填写主机和值),请把 Network access 设为 Custom,在 Allowed domains 中添加 api.pocketalert.app 并保留默认列表,然后把密钥放进一个环境变量,例如 POCKETALERT_KEY,并以 -H "Token: $POCKETALERT_KEY" 的方式发送。需要注意,环境变量对任何使用该环境的人都是可读的,因此网络密钥是更好的选择。
或者将 MCP 服务器添加为连接器
routine 可以使用你在 claude.ai 上的连接器,而连接器流量经过 Anthropic 的服务器,因此完全不需要修改白名单。这样,提示词只需写明"调用 pocketalert 的 create_message 工具",并提供标题、消息内容和级别即可。
限制在于身份验证。Pocket Alert 的 MCP 服务器通过 Authorization: Bearer KEY 接收 API 密钥,而在 claude.ai 上,自定义连接器只能通过 Add custom connector 对话框中的 Request headers 部分发送固定密钥。Anthropic 将该部分标注为面向有限组织开放的测试功能。如果你看到它(在 Team 和 Enterprise 套餐中,由 Owner 在 Organization settings > Connectors 下添加连接器):
- 前往 claude.ai/customize/connectors,点击 Add custom connector。
- URL 填写
https://mcp.pocketalert.app/mcp。Authentication 选择 No sign-in。 - 在 Request headers 中选择
authorization,并填写Bearer YOUR_API_KEY。
新建的 routine 默认会包含你所有的连接器,因此请检查 routine 的 Connectors 标签页,只保留它需要的那些。Claude Code CLI 的 claude mcp add 在这里没有帮助:以这种方式添加的服务器只存在于你的机器上,不会出现在 routine 中。如果你也在本地使用 Claude Code,相关设置见 Claude Code 推送通知;其他 MCP 方案可参考 最佳 MCP 通知服务器。
第二层保障:不依赖模型的推送
上面两种方式都依赖 Claude 遵循提示词的最后一段。通常它会照做。但如果运行遇到速率限制或 API 错误,它就根本走不到那一段,而这恰恰是你最需要知道的运行。
Hook 同样可以在 routine 中运行:只包含一个仓库的云端会话会读取该仓库的 .claude/settings.json。Stop hook 会在 Claude 完成任务时触发,而如果本轮因 StopFailure 或 rate_limit 等 API 错误而结束,则会触发 server_error。将以下内容提交为 .claude/settings.json:
{
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh done" }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/notify.sh failed" }] }
]
}
}
脚本 .claude/hooks/notify.sh 需要设置为可执行:
#!/usr/bin/env bash
[ "$CLAUDE_CODE_REMOTE" = "true" ] || exit 0
payload=$(cat)
last=$(jq -r '.last_assistant_message // ""' <<<"$payload")
link="https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"
if [ "$1" = "failed" ]; then
title="Claude run failed: $(jq -r '.error // "unknown"' <<<"$payload")"
level=high
else
title="Claude run finished · $(basename "$CLAUDE_PROJECT_DIR")"
level=low
fi
jq -n --arg t "$title" --arg m "${last:0:300}
$link" --arg l "$level" '{title: $t, message: $m, level: $l}' |
curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
-H 'Content-Type: application/json' --data-binary @- >/dev/null 2>&1 || true
CLAUDE_CODE_REMOTE 检查可以让 hook 在你的笔记本电脑上保持静默,因为那里该变量永远不会是 true。云端会话中预装了 jq,而第一节中的网络密钥会提供 API 密钥。建议由基于提示词的推送负责具体内容(例如"3 个过期依赖,已开 PR"),由 hook 负责保证送达的"已结束"信号;也可以只保留其中一种。
该 hook 会对这个仓库上的每一个云端会话触发,而不仅仅是 routine 运行。因此,当你在该仓库中使用 Claude Code on the web 时,同样会收到推送。
通知级别与操作按钮
上面的提示词已经用到了最关键的部分:通知级别。low 会安静地送达并保留在历史记录中,high 则会在 iPhone 上以时效性通知的形式送达,并能突破专注模式。"只有出现问题时才用 high"这一规则,可以防止你用了一周之后把整个通知都静音。critical 也存在,在付费套餐上可以突破勿扰模式,但夜间的 routine 很少值得使用它。各级别在 iOS 和 Android 上的具体表现,参见优先级别。
在付费套餐上,一条消息最多可以带三个操作按钮。这里最实用的是一个 view 按钮,指向会话 URL,在 JSON 中可以这样添加:
"actions": [{"type": "view", "label": "Open run", "value": "https://claude.ai/code/session_..."}]
每条推送都会同时出现在应用的历史记录和网页控制台中,与来自你的服务器和 CI 的告警并列显示,因此一周的夜间运行记录只需一次滚动即可浏览。
诚实的局限
- 提示词只是请求,不是保证。 Claude 通常会发送推送,但它可能跳过、发送两次,或者 JSON 写错。如果你需要确定性,请使用 hook。
- 运行可能停下来等待。 Routine 以自动模式启动,但如果某个操作命中了需要确认的规则,或者被反复拦截,运行就会在会话中等待回应。提示词和
Stop都不会告诉你它在等待。如果某个 routine 平时 7:10 会提醒你,而今天没有,就去看一看。 - 用量限制同样适用。 运行会计入你的订阅用量。如果没有用量额度,达到上限后,额外的运行会被拒绝,而一次从未启动的运行也不会发出任何推送。此外还有每小时上限:每个账户 100 次计划运行,每个 routine 30 次 Run now 或 API 触发。
- 研究预览。 Anthropic 表示,行为、限制和 API 仍可能变更。
- 免费套餐。 每台设备每天 50 条消息。一个每小时运行一次、每次运行发送一条推送的 routine 可以满足需求;如果为每个修改过的文件都发一条,则不够用。
没有收到推送怎么办
- 打开运行记录。 routine 的 History 中每次运行都会以完整会话的形式打开。在记录中搜索
api.pocketalert.app,并查看 curl 的输出。 403且提示host_not_allowed。 该 routine 所用的环境上没有绑定密钥,或者主机名拼写错误。检查 Allowed websites。401。 "No token provided" 表示没有密钥到达 API:密钥未绑定,或请求头名称拼写错误。"token contains an invalid number of segments" 表示请求头仍是Authorization,请改为Token。"Invalid token" 表示Bearer前缀仍然存在,或者密钥已被吊销。400。 请求体不是合法 JSON,通常是摘要中有未转义的引号。hook 版本使用jq构建 JSON,可以避免这个问题。- Hook 从未运行。 检查
.claude/settings.json是否已提交到默认分支,脚本是否具有可执行权限,以及该 routine 是否只包含一个仓库。
常见问题
Claude routines 和定时任务是同一回事吗?
是的。Anthropic 已将 routines 更名为定时任务;网址、/routines 别名和 API 仍保留旧名称。
routine 能看到我的 Pocket Alert API 密钥吗?
使用网络密钥时不能。代理会在请求离开会话之后才添加请求头,因此密钥不会出现在 Claude 能读取的任何环境变量或文件中。如果使用环境变量,则会话内部可以读取到它。
routine 能在夜间把我叫醒吗?
在付费套餐上使用 "level": "critical" 可以做到。请把它留给监控生产环境的 routine,例如由监控系统在错误激增时通过 API 触发的 routine。
使用 /loop 或 Desktop 定时任务进行本地调度怎么样?
它们在你的机器上运行,因此本地 Claude Code 的 hook 和 MCP 服务器会照常工作。具体设置见 Claude Code 推送通知。更多智能体用法,参见 AI 智能体告警。
免费注册账户,添加网络密钥,让明天早上的 routine 告诉你它的运行情况。