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

> Claude routines 按计划、API 调用或 GitHub 事件在 Anthropic 云端运行，结束时不会通知任何人。本文介绍如何在运行完成、失败或发现问题时，让手机收到推送通知。

*18.10.2026*

<!-- source: https://pocketalert.app/zh/blog/claude-routines-notifications -->

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](https://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](/account/apikeys) 的 API 密钥，以及装在你的 [iPhone 或 Android](/get-app) 手机上的应用。免费套餐即可使用。
- 一个 routine，或者一个准备创建 routine 的计划。

让运行结果到达手机有两种方式：在会话中用 `curl` 调用 Pocket Alert API，或者把 [Pocket Alert MCP 服务器](/tools/mcp) 添加为连接器。建议先用 curl。它适用于所有支持 routine 的套餐，而且密钥永远不会进入会话。

## 设置：使用带网络密钥的 curl

routine 的云端环境默认采用 **Trusted** 网络访问：只允许访问包管理仓库、GitHub 和云服务商 API，其他地址一律不通。`api.pocketalert.app` 不在这个列表中，因此直接运行 `curl` 会失败，返回 `403` 和 `x-deny-reason: host_not_allowed`。

**网络密钥**可以同时解决网络和密钥两个问题。你把密钥保存在环境上，Anthropic 的代理会在请求离开会话的虚拟机之后，为你列出的主机自动添加密钥。对于绑定了网络密钥的主机，无论网络访问级别如何都可以访问，而且 Claude 永远看不到密钥本身。

1. 在 [claude.ai/code/routines](https://claude.ai/code/routines) 打开该 routine，选择 **Edit**，然后进入 **Advanced settings > General > Cloud environment**。将鼠标悬停在环境上，点击其设置图标。
2. 在 **Network secrets** 中点击 **Add secret**，类型保持为 **Bearer**。
3. **Name**：`Pocket Alert`。**Allowed websites**：`api.pocketalert.app`。
4. 在 **Custom headers** 下，把请求头名称从 `Authorization` 改为 `Token`，去掉 `Bearer` 前缀，然后把你的 API 密钥粘贴为值。
5. 点击 **Add**。密钥会立即保存，之后无法再次查看。

现在请求中完全不需要包含密钥。把以下内容添加到 routine 提示词的末尾：

```text
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** 下添加连接器）：

1. 前往 [claude.ai/customize/connectors](https://claude.ai/customize/connectors)，点击 **Add custom connector**。
2. URL 填写 `https://mcp.pocketalert.app/mcp`。Authentication 选择 **No sign-in**。
3. 在 **Request headers** 中选择 `authorization`，并填写 `Bearer YOUR_API_KEY`。

新建的 routine 默认会包含你所有的连接器，因此请检查 routine 的 **Connectors** 标签页，只保留它需要的那些。Claude Code CLI 的 `claude mcp add` 在这里没有帮助：以这种方式添加的服务器只存在于你的机器上，不会出现在 routine 中。如果你也在本地使用 Claude Code，相关设置见 [Claude Code 推送通知](/blog/claude-code-push-notifications)；其他 MCP 方案可参考 [最佳 MCP 通知服务器](/blog/best-mcp-notification-servers)。

## 第二层保障：不依赖模型的推送

上面两种方式都依赖 Claude 遵循提示词的最后一段。通常它会照做。但如果运行遇到速率限制或 API 错误，它就根本走不到那一段，而这恰恰是你最需要知道的运行。

Hook 同样可以在 routine 中运行：只包含一个仓库的云端会话会读取该仓库的 `.claude/settings.json`。`Stop` hook 会在 Claude 完成任务时触发，而如果本轮因 `StopFailure` 或 `rate_limit` 等 API 错误而结束，则会触发 `server_error`。将以下内容提交为 `.claude/settings.json`：

```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` 需要设置为可执行：

```bash
#!/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 上的具体表现，参见[优先级别](https://info.pocketalert.app/features/priority-levels.html)。

在付费套餐上，一条消息最多可以带三个[操作按钮](https://info.pocketalert.app/features/action-buttons.html)。这里最实用的是一个 `view` 按钮，指向会话 URL，在 JSON 中可以这样添加：

```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 可以满足需求；如果为每个修改过的文件都发一条，则不够用。

## 没有收到推送怎么办

1. **打开运行记录。** routine 的 **History** 中每次运行都会以完整会话的形式打开。在记录中搜索 `api.pocketalert.app`，并查看 curl 的输出。
2. **`403` 且提示 `host_not_allowed`。** 该 routine 所用的环境上没有绑定密钥，或者主机名拼写错误。检查 **Allowed websites**。
3. **`401`。** "No token provided" 表示没有密钥到达 API：密钥未绑定，或请求头名称拼写错误。"token contains an invalid number of segments" 表示请求头仍是 `Authorization`，请改为 `Token`。"Invalid token" 表示 `Bearer` 前缀仍然存在，或者密钥已被吊销。
4. **`400`。** 请求体不是合法 JSON，通常是摘要中有未转义的引号。hook 版本使用 `jq` 构建 JSON，可以避免这个问题。
5. **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 推送通知](/blog/claude-code-push-notifications)。更多智能体用法，参见 [AI 智能体告警](/use-cases/ai-agent-alerts)。

[免费注册账户](/signup)，添加网络密钥，让明天早上的 routine 告诉你它的运行情况。
