Claude Codeのクラウド定期タスク(旧Routines)の作り方と起動方法

Claude Code エンジニアリング 8分で読めます

毎晩 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 にも反応する」レビュータスクも作れます。

スケジュールは必須ではありません。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)のトグルで全員分を無効にできます。

公式が挙げる使いどころ

手元のマシンで動かすスケジュール手段には、デスクトップアプリのスケジュールタスクとセッション内の /loop もあります。マシンが止まっていても確実に回したい作業がクラウド定期タスクの担当です。

なお、タスクは個人の claude.ai アカウントに属し、チームメイトとは共有されません。実行中に GitHub やコネクタを通して行った操作はすべて本人として記録されます(コミットや PR には本人の GitHub ユーザーが付きます)。

Web と CLI での作り方

Web・デスクトップアプリ・CLI のどれで作っても同じクラウドアカウントに保存され、ほかの画面にもすぐ表示されます。

Web から作る

  1. 作成ダイアログを開く: claude.ai/code/routines で New task をクリックします。アカウントによってはボタンが New routine と表示され、全ページのフォームが開きます。Create with Claude と Set up manually のメニューが出た場合、前者はチャットで内容を伝えて Claude に作らせる方法です
  2. 名前とプロンプトを書く: 無人で動くので、プロンプトはそれだけで完結し、何をすれば成功かまで明示します。ここが最も重要です
  3. トリガーを選ぶ: Trigger 行でスケジュール・GitHub イベント・API から選びます。複数付けるときは行末の + を押します
  4. リポジトリを選ぶ: Advanced settings の General タブで GitHub リポジトリを選びます。リポジトリは実行のたびに clone され、変更は claude/ で始まるブランチに作られます
  5. 環境を選ぶ: クラウド環境でネットワークアクセス、環境変数、セットアップスクリプトが決まります。Default 環境は Trusted で、パッケージレジストリなどの既定の許可リストにしか出られません
  6. モデルと effort を選ぶ: 入力欄のモデルセレクタで毎回使うモデルを選びます。effort に対応したモデルなら同じセレクタで effort も選べます
  7. コネクタを見直す: Connectors タブでは、接続済みのコネクタが既定ですべて含まれます。書き込みも含めて実行中に使えるので、不要なものは外します
  8. 作成する: 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種類のトリガーを設定する

スケジュールトリガー

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 リファレンスで確認できる要点は次のとおりです。

注意したいのは 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 requestPR が開かれた・閉じられた・アサインされた・ラベルが付いた・同期されたなど
Releaseリリースの作成・公開・編集・削除
Issueissue が開かれた・編集された・閉じられた・再開された・ラベルが付いたなど

PR には、作成者・タイトル・本文・ベースブランチ・ヘッドブランチ・ラベル・ドラフトか・マージ済みか、で絞り込むフィルタを付けられます。条件はすべて一致したときだけ起動します。演算子は equals・contains・starts with・is one of・is not one of・matches regex です。matches regex は値全体に対して判定するので、タイトルに hotfix を含むものを拾うなら .*hotfix.* と書くか、contains を使います。

イベントごとに新しいセッションが作られ、使い回しはされません。webhook イベントにはタスク単位とアカウント単位の毎時上限があり、超えた分は捨てられます。

実行の確認と権限・接続先

実行履歴を見る

詳細ページの History から各実行を開くと、通常のセッションとして中身を確認でき、変更のレビューや PR の作成、会話の続行もできます。状態は3つです。

詳細ページでは、Run now での即時実行、上部のスイッチでの一時停止・再開、メニューの Edit での編集、Delete での削除ができます。

実行中の権限確認

Anthropic のクラウドで新しいセッションを始める実行は、使える限り 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 を隠します。主な原因は次のとおりです。

「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)。リサーチプレビューの機能のため、仕様は更新される場合があります。利用前に公式ドキュメントをご確認ください。