ブログに戻る

Claude routines のプッシュ通知:クラウド実行で対応が必要なときにすぐ気づく

Claude routines のプッシュ通知:クラウド実行で対応が必要なときにすぐ気づく

Claude routines は、あなたがいなくても動く Claude Code の機能です。プロンプトとリポジトリを一度保存しておけば、Anthropic のクラウドが毎晩、新しいプルリクエストのたびに、あるいは監視ツールがエンドポイントを呼び出すたびに、新しい Claude Code セッションを起動します。ノート PC は閉じていても構いません。

問題は、routine が結果を誰にも報告しないことです。結果は claude.ai 上のセッションに残るだけで、見に行かなければ分かりません。実行一覧も十分ではありません。緑のステータスが示すのは、セッションがインフラのエラーなしで開始・終了したことだけで、作業が成功したことではありません。壊れたビルドを見つけた夜間の依存関係チェックも、何も見つからなかった場合も、見た目は同じです。

このガイドでは、routine が Pocket Alert 経由でスマホにプッシュ通知を送るように設定します。問題がないときは静かな通知、対応が必要なときは目立つ通知を送ります。

Claude routines の概要

Anthropic は現在、これをスケジュールタスクと呼んでいます。「Routines」は以前の名前で、Web アドレス(claude.ai/code/routines)、CLI のエイリアス /routines、API には今も残っています。同じ機能で、現在はリサーチプレビュー段階です。

routine とは、保存された Claude Code の設定のことです。プロンプト、1 つ以上の GitHub リポジトリ、クラウド環境、コネクタのセットで構成されます。実行のたびに、シェルコマンドの実行、コードの編集、claude/ ブランチへのプッシュ、コネクタの呼び出しができる完全なクラウドセッションが立ち上がります。実行のきっかけ(トリガー)は複数設定できます。

  • スケジュール:毎時、毎日、毎週のプリセット、任意の cron 式(最短で 1 時間間隔)、または指定時刻の 1 回だけの実行。
  • API:routine 専用の /fire エンドポイントへ、ベアラートークン付きの POST を送信。アラート本文などの text フィールドを渡すと、実行時にコンテキストとして受け取ります。
  • GitHub:Claude GitHub App をインストールしたリポジトリでのプルリクエスト、リリース、Issue のイベント。プルリクエストは作成者、ブランチ、ラベル、ドラフト状態などでフィルタできます。

routine は claude.ai/code/routines で New task をクリックするか、デスクトップアプリ、または Claude Code CLI の /schedule で作成します(例:/schedule daily PR review at 9am)。Pro、Max、Team、Enterprise のいずれかのプランが必要で、実行は対話型セッションと同じようにサブスクリプションの利用量を消費します。

必要なもの

  • Pocket Alert のアカウント、APIキー、そして iPhone または Android のアプリ。無料プランでも利用できます。
  • routine、またはその計画。

実行結果をスマホに届ける方法は 2 つあります。セッションから Pocket Alert API へ curl を送る方法と、コネクタとして Pocket Alert MCP サーバー を追加する方法です。まずは curl から始めるのがおすすめです。routine が使えるすべてのプランで動作し、APIキーがセッション内に入ることもありません。

設定:ネットワークシークレットを使った curl

routine のクラウド環境は、デフォルトで Trusted のネットワークアクセスになっています。これはパッケージレジストリ、GitHub、クラウドプロバイダーの API だけを許可する設定です。api.pocketalert.app はこの一覧に含まれていないため、そのままの curl は 403 と x-deny-reason: host_not_allowed で失敗します。

ネットワークシークレットを使えば、ネットワークの問題と APIキーの問題を同時に解決できます。環境にキーを保存すると、セッションの VM から出たリクエストに対して、指定したホストへのリクエストに Anthropic のプロキシがキーを付加します。ネットワークシークレットに登録されたホストは、アクセスレベルに関係なく到達可能で、Claude がキーを目にすることはありません。

  1. 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 のプロンプトの末尾に次を追加してください。

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 に変換します。これをメッセージに含めておくと、通知から 1 タップで実行内容を開けます。

初回のスケジュール実行の前にテストするには、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 サーバーは APIキーを Authorization: Bearer KEY の形で受け取りますが、claude.ai のカスタムコネクタが送れる固定キーは、Add custom connector ダイアログの Request headers セクションに限られます。Anthropic はこのセクションを、限られた組織だけが使えるベータ機能として扱っています。そのセクションが表示される場合(Team と Enterprise プランでは、オーナーが Organization settings > Connectors からコネクタを追加します)は、次の手順で設定します。

  1. claude.ai/customize/connectors を開き、Add custom connector をクリックします。
  2. URL:https://mcp.pocketalert.app/mcp。認証: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 のプッシュ通知 にあります。その他の MCP の選択肢については おすすめの MCP 通知サーバー を参照してください。

第 2 段階:モデルに依存しないプッシュ通知

上の 2 つの方法はどちらも、プロンプトの最後の段落に従って Claude が通知を送ることを前提にしています。通常はそれで問題ありません。しかし、レート制限や API エラーに当たった実行は、その段落までたどり着けません。そして、そういう実行こそ知っておきたいものです。

フックは routine でも動作します。1 つのリポジトリを持つクラウドセッションは、そのリポジトリの .claude/settings.json を読み込みます。Stop フックは 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 のチェックにより、この変数が決して true にならないノート PC では、フックは何も送信しません。jq はクラウドセッションにプリインストールされており、最初のセクションで設定したネットワークシークレットがキーを供給します。内容についてはプロンプトによるプッシュ通知を使い(「古いパッケージが 3 件、PR を作成」など)、フックは「終わった」ことを必ず知らせる信号として使うか、どちらか一方だけを使ってください。

フックは、routine の実行だけでなく、そのリポジトリのすべてのクラウドセッションで発火します。そのリポジトリで Web 上の Claude Code を使った場合にも通知が届く点に注意してください。

重要度とボタン

上のプロンプトでは、最も重要な要素である重要度レベルがすでに使われています。low は静かに届き、履歴に残ります。high は iPhone では時間的に緊急な通知として届き、集中モードも突破します。「問題があるときだけ high」というルールは、1 週間もたたないうちに通知を全部ミュートしてしまうのを防ぎます。critical もあり、有料プランではおやすみモードを突破しますが、夜間の routine にはめったに必要ありません。各レベルが iOS と Android でどう動作するかは 優先度レベル を参照してください。

有料プランでは、1 件のメッセージに最大 3 つのアクションボタンを付けられます。ここで便利なのは、セッションの URL を指定した view ボタンです。JSON には次のように追加します。

"actions": [{"type": "view", "label": "Open run", "value": "https://claude.ai/code/session_..."}]

すべての通知はアプリの履歴とWeb ダッシュボードにも残るため、サーバーや CI からのアラートと並べて確認できます。1 週間分の夜間実行も、1 画面でスクロールして見返せます。

正直な制限事項

  • プロンプトは依頼であり、保証ではありません。 Claude は通常は通知を送りますが、送信を省略したり、2 回送ったり、JSON を誤って書いたりすることがあります。確実性が必要ならフックを使ってください。
  • 実行が止まって待機することがあります。 routine は自動モードで始まりますが、確認ルールに一致する操作や繰り返しのブロックが発生すると、実行はセッション内で回答を待ちます。プロンプトも Stop もこの待機は検知できません。いつもなら 7 時 10 分に通知が来る routine が来なかった場合は、実際に見に行ってください。
  • 利用上限が適用されます。 実行はサブスクリプションの利用量に計上されます。利用クレジットがなければ、上限に達した後の追加実行は拒否され、開始されなかった実行は何も送信しません。毎時の上限もあり、アカウントごとのスケジュール実行は 100 回、routine ごとの Run now または API による起動は 30 回までです。
  • リサーチプレビュー段階です。 Anthropic は、動作、制限、API が変更される可能性があると説明しています。
  • 無料プラン。 1 台のデバイスに 1 日 50 件までです。毎時実行の routine で、実行ごとに 1 件送るなら収まりますが、変更したファイルごとに 1 件送るような運用では収まりません。

通知が届かない場合

  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 ではありません。多くの場合、要約内のエスケープされていない引用符が原因です。フック版は jq で JSON を組み立てるため、この問題を避けられます。
  5. フックが実行されない。 .claude/settings.json がデフォルトブランチにコミットされているか、スクリプトに実行権限があるか、routine のリポジトリが 1 つだけかを確認してください。

FAQ

Claude routines とスケジュールタスクは同じものですか?

はい。Anthropic は routines をスケジュールタスクに改称しました。Web アドレス、/routines のエイリアス、API は旧名のまま残っています。

routine は私の Pocket Alert APIキーを見られますか?

ネットワークシークレットを使う場合は見られません。プロキシはリクエストがセッションを出た後にヘッダーを付加するため、キーは Claude が読めるどの環境変数やファイルにも存在しません。環境変数を使う場合は、セッション内から読めてしまいます。

routine で夜中に起こしてもらえますか?

有料プランで "level": "critical" を指定すれば可能です。ただし、これは本番環境を監視する routine にだけ使ってください。例えば、監視ツールがエラーの急増時に API で起動する routine などです。

/loop やデスクトップのスケジュールタスクによるローカル実行の場合は?

それらはローカルマシン上で動くため、ローカルの Claude Code のフックと MCP サーバーは通常どおり機能します。設定方法は Claude Code のプッシュ通知 にあります。その他のエージェントのパターンについては、AI エージェントのアラート を参照してください。

無料アカウントを作成して、シークレットを追加し、明日の朝の routine に結果を知らせてもらいましょう。

この記事をシェア