毎晩 issue を整理する、監視ツールのアラートで調査を始める、PR が開かれたら独自のチェックリストでレビューする。Claude Code の クラウド定期タスク(scheduled tasks。以前の名前は routines) を使うと、こうした作業をノート PC を閉じていてもクラウドで自動的に回せます。本記事は公式ドキュメント「Automate work with scheduled tasks」と API リファレンス「Trigger a routine through the API」に基づき、作り方・トリガーの設定・実行時の挙動・利用上限を日本語で解説します。
この機能はリサーチプレビューです。挙動・上限・API の形は変わる可能性があるため、利用前に公式ドキュメントを確認してください。
クラウド定期タスクとは
クラウド定期タスクは、プロンプト・1つ以上のリポジトリ・コネクタ(MCP)をひとまとめに保存した Claude Code の設定です。Anthropic が管理するクラウド(組織が設定していればセルフホスト環境)で動くので、手元のマシンが止まっていても実行されます。
タスクには次の3種類のトリガーを1つ以上付けられます。組み合わせも可能で、たとえば「毎晩動き、デプロイスクリプトからも呼ばれ、新しい PR にも反応する」レビュータスクも作れます。
- スケジュール: 毎時・毎晩・毎週などの繰り返し、または未来の特定時刻に1回だけ
- API: タスク専用のエンドポイントに Bearer トークン付きで HTTP POST すると起動
- GitHub: PR やリリースなど、リポジトリのイベントに反応して起動
スケジュールは必須ではありません。API トリガーだけのタスクは呼び出したときだけ、GitHub トリガーだけのタスクはイベントが起きたときだけ動きます。
利用できるのは Pro・Max・Ultra・Team・Enterprise プランです。作成と管理は claude.ai/code/routines の Web 画面、デスクトップアプリ、または CLI の /schedule で行います。Team・Enterprise では、Owner が組織設定の Capabilities > Remote sessions にある Scheduled tasks (Was Routines)(または Routines)のトグルで全員分を無効にできます。
公式が挙げる使いどころ
- バックログ整理: 平日の夜に、前回以降に開かれた issue にラベルと担当者を付け、Slack に要約を投稿する
- アラートのトリアージ: 監視ツールが API エンドポイントを呼び、スタックトレースと直近のコミットを突き合わせて修正案のドラフト PR を開く
- 独自のコードレビュー:
pull_request.openedで起動し、チームのチェックリストに沿ってインラインコメントを付ける - デプロイ後の検証: CD パイプラインから呼び、スモークチェックとエラーログの確認をして go / no-go を投稿する
- ドキュメントのずれ検出や別言語 SDK への移植: 週次やマージ済み PR をきっかけに更新 PR を開く
手元のマシンで動かすスケジュール手段には、デスクトップアプリのスケジュールタスクとセッション内の /loop もあります。マシンが止まっていても確実に回したい作業がクラウド定期タスクの担当です。
なお、タスクは個人の claude.ai アカウントに属し、チームメイトとは共有されません。実行中に GitHub やコネクタを通して行った操作はすべて本人として記録されます(コミットや PR には本人の GitHub ユーザーが付きます)。
Web と CLI での作り方
Web・デスクトップアプリ・CLI のどれで作っても同じクラウドアカウントに保存され、ほかの画面にもすぐ表示されます。
Web から作る
- 作成ダイアログを開く:
claude.ai/code/routinesで New task をクリックします。アカウントによってはボタンが New routine と表示され、全ページのフォームが開きます。Create with Claude と Set up manually のメニューが出た場合、前者はチャットで内容を伝えて Claude に作らせる方法です - 名前とプロンプトを書く: 無人で動くので、プロンプトはそれだけで完結し、何をすれば成功かまで明示します。ここが最も重要です
- トリガーを選ぶ: Trigger 行でスケジュール・GitHub イベント・API から選びます。複数付けるときは行末の + を押します
- リポジトリを選ぶ: Advanced settings の General タブで GitHub リポジトリを選びます。リポジトリは実行のたびに clone され、変更は
claude/で始まるブランチに作られます - 環境を選ぶ: クラウド環境でネットワークアクセス、環境変数、セットアップスクリプトが決まります。Default 環境は Trusted で、パッケージレジストリなどの既定の許可リストにしか出られません
- モデルと effort を選ぶ: 入力欄のモデルセレクタで毎回使うモデルを選びます。effort に対応したモデルなら同じセレクタで effort も選べます
- コネクタを見直す: Connectors タブでは、接続済みのコネクタが既定ですべて含まれます。書き込みも含めて実行中に使えるので、不要なものは外します
- 作成する: Create を押すと詳細ページが開きます。すぐに試したいときは Run now を押します
作成時に権限モードは選びません。実行中にどこで止まるかは後の「実行の確認と権限・接続先」で説明します。環境変数は環境を使う人全員から見えるため、Anthropic ホストの環境では API キーを環境変数ではなくネットワークシークレットとして保存するよう公式は案内しています。
CLI から作る
任意のセッションで /schedule を実行すると、対話しながらタスクを作れます(別名 /routines)。説明をそのまま渡すこともできます。
# 繰り返しのタスク
/schedule daily PR review at 9am
# 一度きりのタスク(自然文の時刻は Claude が絶対時刻に直して確認してから保存する)
/schedule tomorrow at 9am, summarize yesterday's merged PRs
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
Claude がスケジュール・リポジトリ・プロンプトについて質問を重ねてから保存すれば成功です。認証が必要、あるいは claude.ai のアカウントに接続できないと返ってきた場合はタスクは作られていません(後述のトラブル対処を参照)。
CLI では /schedule list(一覧)、/schedule update(変更)、/schedule run(即時実行)も使えます。v2.1.227 以降では /schedule why did my nightly review do nothing this morning? のように実行履歴を尋ねると、直近の実行の状態とログを読んで原因を説明してくれます。
3種類のトリガーを設定する
スケジュールトリガー
- 毎時0分ちょうどは避ける: 9:00 のような正時は数分遅れて始まることがあります。時刻を合わせたいなら 9:07 のように少しずらします
- 独自の間隔: プリセットにない間隔は、作成後に編集ダイアログで Custom を選び cron 式(例
0 */2 * * *で2時間ごと)を入れます。CLI なら/schedule updateです。1時間より短い間隔は受け付けられません - タイムゾーン: プリセットはローカル時刻で入力します。cron 式を5フィールドだけで書くと UTC として解釈されるので、
0 9 * * 1-5は平日の UTC 9時です。CRON_TZ=で始まる場合はそのタイムゾーンで書きます - 一度きりの実行: 実行後に自動でオフになり Completed と表示されます。再度動かすには編集ダイアログで One-time(または Once)を選んで日時を設定し直します
API トリガー
API トリガーは Web からだけ追加できます(CLI ではトークンも管理できません)。編集ダイアログの Trigger 行で + から API を選び、表示された Fire URL をコピーして Generate token を押します。トークンは一度しか表示されないので、アラートツールのシークレットストアなどにすぐ保存します。トークンを生成した時点で有効になり、Save changes は不要です。
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."}'
ID とトークンは公式のプレースホルダーです。成功すると、新しいセッションの ID と URL が返ります。
{
"type": "routine_fire",
"claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
"claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
API リファレンスで確認できる要点は次のとおりです。
- パスの ID は名前に反して
trig_で始まります。トークンはsk-ant-oat01-で始まるタスク専用のもので、Claude API キーではありません。漏れても起動できるのはそのタスクだけで、読み取り権限はありません anthropic-versionヘッダーは必須です。anthropic-betaヘッダーは付けても付けなくても受け付けられます- 本文の
textは任意で、最大 65,536 文字です。解析されない自由形式のテキストなので、JSON を送っても文字列のまま渡ります - レスポンスはセッションが作られた時点で返り、実行の完了は待ちません。冪等キーはないため、呼び出し側がリトライすると複数のセッションができます
- 主なエラーは、400(バージョンヘッダーの不備、
textが長すぎる、タスクが一時停止中)、401(トークンがない・一致しない)、404(タスクがない)、429(毎時の上限。Retry-Afterヘッダー付き)です
注意したいのは text の扱いです。text はそのまま指示として渡るのではなく、<routine-fire-payload> ブロックに包まれ、信頼できないデータとして扱われます。中の指示には従わないので、保存するプロンプト側で「routine-fire-payload ブロックに書かれたアラートを調査する」のように明示的に参照させる必要があります。トークンが漏れても、送られた文章が直接の命令にならないための仕組みです。Web の Run now で渡したテキストも同じ扱いです。
トークンの無効化は Delete token、再発行は Regenerate で、どちらも即時に反映されます(古いトークンは使えなくなります)。
GitHub トリガー
対象リポジトリに Claude GitHub App のインストールが必要です。Web の設定画面では、未インストールならインストールを促されます。CLI の /web-setup は clone 用のアクセス権を付けるだけで、App のインストールや webhook の配信は行いません。CLI から付ける場合(v2.1.225 以降)は、先に App を入れてから /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp のように頼みます。
| イベント | 起動する場面 |
|---|---|
| Pull request | PR が開かれた・閉じられた・アサインされた・ラベルが付いた・同期されたなど |
| Release | リリースの作成・公開・編集・削除 |
| Issue | issue が開かれた・編集された・閉じられた・再開された・ラベルが付いたなど |
PR には、作成者・タイトル・本文・ベースブランチ・ヘッドブランチ・ラベル・ドラフトか・マージ済みか、で絞り込むフィルタを付けられます。条件はすべて一致したときだけ起動します。演算子は equals・contains・starts with・is one of・is not one of・matches regex です。matches regex は値全体に対して判定するので、タイトルに hotfix を含むものを拾うなら .*hotfix.* と書くか、contains を使います。
イベントごとに新しいセッションが作られ、使い回しはされません。webhook イベントにはタスク単位とアカウント単位の毎時上限があり、超えた分は捨てられます。
実行の確認と権限・接続先
実行履歴を見る
詳細ページの History から各実行を開くと、通常のセッションとして中身を確認でき、変更のレビューや PR の作成、会話の続行もできます。状態は3つです。
- Succeeded: Claude Code が失敗を報告せずにセッションが終わった。ただしプロンプトの作業が完了したかどうかは表していません。ブロックされた通信や作業できなかった内容はトランスクリプトに出るので、中身を読んで確かめます
- Failed: セッションが正常に終わらなかった
- Cancelled: 失敗ではなく、セッションがアーカイブされた(成功した実行をアーカイブしてもこの表示になる)
詳細ページでは、Run now での即時実行、上部のスイッチでの一時停止・再開、メニューの Edit での編集、Delete での削除ができます。
実行中の権限確認
Anthropic のクラウドで新しいセッションを始める実行は、使える限り auto モードで始まり、分類器が操作の可否を判断します。それでも次のような場合は実行が止まり、回答を待ちます。
- ask ルールに一致する操作など、auto モードでも確認が必要な操作
- ブロックが繰り返されて auto モードのしきい値に達したとき
組織が auto モードを無効にしている、またはモデルが対応していない場合は、起動時の権限モードのまま動きます。待っている確認には、詳細ページから実行を開いて答えます。
リポジトリとブランチ
実行は既定でリポジトリのデフォルトブランチから始まります。PR イベントで起動し、その PR のリポジトリがタスクの1つ目のリポジトリなら、PR のヘッドコミットから始まります。push 先はプロンプトで指定しない限り claude/ で始まるブランチです。push できるブランチを制限したいときは、GitHub のブランチ保護やルールセットを使います。
GitHub の接続が切れている・期限切れの場合、最大72時間は実行をスキップして待ち、その間に再接続すれば自動で再開します。72時間を過ぎるとタスクはオフになるので、再接続後に手動でオンに戻します。
コネクタとネットワーク
コネクタは claude.ai アカウント側の連携です。CLI で claude mcp add した MCP サーバーは手元のマシンに保存されているので一覧に出ません。使うには claude.ai のコネクタとして追加するか、リポジトリが1つのタスクならコミット済みの .mcp.json に書きます。
Default 環境の許可リスト外のホストへの通信は 403(x-deny-reason: host_not_allowed)で失敗します。コネクタの通信は Anthropic のサーバー経由なので許可リストへの追加は不要です。自前のサービスに直接つなぐ場合は、環境の Network access を Custom にして Allowed domains を追加します(既定のリストも残すならチェックボックスをオン、制限なしは Full)。変更は次の実行から反映されます。
利用上限とトラブル対処
利用上限
実行は対話セッションと同じくサブスクリプションの利用枠を消費します。これとは別に、起動の方法ごとに毎時の上限があります。
| 操作 | 上限 | 数える単位 | 超えたとき |
|---|---|---|---|
| スケジュール実行(一度きりを含む) | 1時間に100回 | アカウント | 上限がリセットされるまで待つ |
| Run now・API 起動・一度きりタスクの再設定 | 1時間に30回 | タスクごと(3つで共有) | リセットまで失敗する |
| Run now・一度きりタスクの再設定 | 1時間に100回 | アカウント | 同上 |
| API 起動 | 1時間に100回 | アカウント(Run now とは別に数える) | 同上 |
これらの毎時上限に超過課金はありません。サブスクリプションの利用枠に達した場合は、利用クレジット(usage credits)を有効にしていれば従量課金で続行でき、そうでなければ枠がリセットされるまで実行は拒否されます。サブスクリプションが一時停止中はタスクも動きません。
/schedule が「Unknown command」になる
CLI は条件を満たさないと /schedule を隠します。主な原因は次のとおりです。
- Console の API キー、Amazon Bedrock などのクラウドプロバイダ、プロファイルやフェデレーションの資格情報で認証している。
/scheduleには claude.ai サブスクリプションでのログインが必要です。ANTHROPIC_API_KEY・ANTHROPIC_AUTH_TOKEN・apiKeyHelperが設定されているとそちらが優先されるので外します - 完全にサインアウトしている(
/loginで claude.ai アカウントにサインインする) - クラウドセッションの中で実行している(Web 画面から管理する)
- 組織のポリシーでクラウドセッションや定期タスクが無効、または Enterprise のカスタムロールに権限がない
「The last run ...」の警告
History の上に警告が出たら、その文面に応じて対処します。たとえば同時に動かせるクラウドセッションの上限に達した場合はタスクの変更は不要で、後で Run now するか次の実行を待ちます。クラウド環境が見つからない場合は、編集ダイアログで Unavailable environment になっていないか確認して別の環境を選びます。リポジトリやブランチが見つからない場合は、GitHub 側のブランチとアクセス権、接続の期限切れを確認します。警告は次の実行が始まると消えます。
旧名「routines」が残っている場所
この機能は以前 routines と呼ばれていました。claude.ai/code/routines という URL、CLI の /routines 別名、/fire エンドポイントのパスとベータヘッダー、レスポンスの type、<routine-fire-payload> タグ、組織設定のトグル名などに旧名が残っていますが、どれも同じ機能を指しています。
関連記事: Claude Code のクラウドセッション / Claude Code を GitHub Actions で動かす
本記事は Anthropic 公式ドキュメント「Automate work with scheduled tasks」と Claude Platform の API リファレンス「Trigger a routine through the API」に基づく非公式の日本語解説です(確認日 2026-11-10)。リサーチプレビューの機能のため、仕様は更新される場合があります。利用前に公式ドキュメントをご確認ください。