SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 260 additions and 277 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Thu 15 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

スケジュールタスクで作業を自動化する

Claude Code を自動操縦に設定します。スケジュール、API 呼び出し、または GitHub イベントに応じてクラウドで実行されるスケジュールタスク（旧称ルーティン）を作成します。

[!NOTE]

スケジュールタスクはリサーチプレビュー段階です。動作、制限、API サーフェスは変更される可能性があります。

クラウドスケジュールタスク（旧称ルーティン）は、保存された Claude Code の設定です。プロンプト、1 つ以上のリポジトリ、一連のコネクタを一度パッケージ化し、自動的に実行します。スケジュールタスクは Anthropic が管理するクラウドインフラストラクチャ上で実行されるか、ルーティングされた場合は組織のセルフホスト環境で実行されるため、ラップトップを閉じても動作し続けます。

各スケジュールタスクには、1 つ以上のトリガーを設定できます。

  • スケジュール: 1 時間ごと、毎晩、毎週など定期的なペースで実行するか、将来の特定の時刻に 1 回実行
  • API: ベアラートークンを付けてタスク固有のエンドポイントに HTTP POST を送信し、オンデマンドでトリガー
  • GitHub: プルリクエストやリリースなどのリポジトリイベントに応じて自動的に実行

1 つのスケジュールタスクで複数のトリガーを組み合わせることができます。たとえば、PR レビュータスクを毎晩実行し、デプロイスクリプトからトリガーし、さらに新しい PR すべてに反応させることもできます。

スケジュールタスクにスケジュールは必須ではありません。

  • API トリガーのみを持つタスクは、そのエンドポイントを呼び出したときに実行されます。
  • GitHub トリガーのみを持つタスクは、一致するリポジトリイベントが発生したときに実行されます。

スケジュールタスクは Pro、Max、Team、Enterprise プランで利用できます。claude.ai/code/routines で作成・管理するか、CLI で /schedule を使用します。以前の名前であるルーティンは、Web アドレス、CLI、API に引き続き表示されます。

[!NOTE]

クラウドではなくマシン上で作業をスケジュールする機能が他に 2 つあります。Desktop スケジュールタスクと /loop です。3 つの中から選ぶには、スケジューリングオプションを比較するを参照してください。

Team および Enterprise の Owner は、Organization settings > Capabilities > Remote sessions の Scheduled tasks (Was Routines) トグルを使用して、すべてのメンバーのスケジュールタスクをオフにできます。トグルがオフの場合、既存のスケジュールタスクは実行を停止し、メンバーは新しいスケジュールタスクを作成できません。

ユースケースの例

各例は、トリガータイプと、スケジュールタスクに適した作業の種類を組み合わせたものです。いずれも無人で実行でき、繰り返し可能で、明確な成果に結びついています。

  • バックログメンテナンス: スケジュールトリガーが平日の毎晩リポジトリで実行され、課題トラッカーがコネクタとして追加されています。スケジュールタスクは前回の実行以降にオープンされた課題を読み取り、ラベルを付け、参照されているコード領域に基づいて担当者を割り当てます。その後 Slack に概要を投稿するため、チームは整理されたキューで 1 日を始められます。
  • アラートトリアージ: エラーのしきい値を超えたときに監視ツールがスケジュールタスクの API エンドポイントを呼び出し、アラート本文を text として渡します。タスクのプロンプトは fire ペイロード内のアラートを調査するよう Claude に指示しているため、Claude はスタックトレースを取得し、リポジトリの最近のコミットと照合します。その後、修正案とアラートへのリンクを含むドラフトプルリクエストを作成します。オンコール担当者は空のターミナルから始めるのではなく、PR をレビューします。
  • 独自のコードレビュー: GitHub トリガーが pull_request.opened で実行されます。スケジュールタスクはチーム独自のレビューチェックリストを適用し、セキュリティ、パフォーマンス、スタイルの問題についてインラインコメントを残します。また概要コメントも追加するため、人間のレビュアーは機械的なチェックではなく設計に集中できます。
  • デプロイ検証: CD パイプラインが本番デプロイのたびにスケジュールタスクの API エンドポイントを呼び出します。タスクは新しいビルドに対してスモークチェックを実行し、エラーログをスキャンしてリグレッションを探し、デプロイウィンドウが閉じる前にリリースチャンネルに go または no-go を投稿します。
  • ドキュメントのずれ: スケジュールトリガーが毎週実行されます。スケジュールタスクは前回の実行以降にマージされた PR をスキャンし、変更された API を参照しているドキュメントを指摘して、編集者がレビューできるようドキュメントリポジトリに更新 PR を作成します。
  • ライブラリの移植: GitHub トリガーが pull_request.closed で実行され、1 つの SDK リポジトリのマージ済み PR に絞り込まれています。スケジュールタスクは変更を別の言語の対応する SDK に移植して対応する PR を作成するため、人間が各変更を再実装しなくても 2 つのライブラリの歩調がそろいます。

スケジュールタスクを作成する

スケジュールタスクは、claude.ai/code/routines の Web、Desktop アプリ、または CLI から作成できます。3 つのサーフェスはすべて同じクラウドアカウントに書き込むため、どれかで作成したスケジュールタスクは他のサーフェスにもすぐに表示されます。Desktop アプリの Code タブで、サイドバーまたはサイドバーの More メニューにある Scheduled をクリックしてから New task をクリックし、Web から作成するの手順に進みます。

スケジュールタスクは完全な Claude Code クラウドセッションとして自律的に実行されます。権限モードは選択しません。セッションはシェルコマンドを実行し、クローンされたリポジトリにコミットされたスキルを使用し、含めたコネクタを呼び出します。一部のアーティファクトアクションを除き、すべて承認を求めずに実行されます。

スケジュールタスクがアクセスできる範囲は、次によって決まります。

  • 選択したリポジトリ
  • 環境のネットワークアクセスと変数
  • 含めたコネクタ

それぞれを、タスクが必要とするものに限定してください。

スケジュールタスクは個人の claude.ai アカウントに属します。チームメイトとは共有されず、その実行はアカウントの使用量と制限にカウントされます。スケジュールタスクが接続された GitHub ID やコネクタを通じて行うことは、すべてユーザー本人によるものとして表示されます。コミットとプルリクエストにはユーザーの GitHub ユーザーが記録され、Slack メッセージ、Linear チケット、その他のコネクタアクションでは、それぞれのサービスにリンクされたユーザーのアカウントが使用されます。

Web から作成する

1. 作成ダイアログを開く

claude.ai/code/routines にアクセスし、New task をクリックします。先にメニューが開いた場合は、Set up manually を選択します。New scheduled task ダイアログが開きます。メニューのもう 1 つのオプションである Create with Claude を選ぶと、チャットでタスクを説明し、Claude に作成させることができます。

ダイアログを開いた時点で Repositories と Environment がすでに表示されている場合は、そのダイアログの違いを参照してください。それ以外の場合、このダイアログは claude.ai チャット用のスケジュールタスクも作成します。ダイアログで Claude Code タスクと呼ばれるものにするには、以降の手順でリポジトリを選択するか、GitHub イベントまたは API トリガーを追加します。この種類のタスクは、クラウドセッションで Claude Code を実行します。

2. タスクに名前を付けてプロンプトを書く

スケジュールタスクにわかりやすい名前を付け、Claude が毎回実行するプロンプトを書きます。プロンプトが最も重要な部分です。タスクは自律的に実行されるため、プロンプトは自己完結しており、何をすべきか、何をもって成功とするかを明確に示す必要があります。プロンプト入力のモデルセレクタでモデルを選択します。Claude は毎回の実行でそのモデルを使用します。

トリガーが発火すると、セッションは保存されたプロンプトを割り当てられたタスクとして受け取り、実行します。会話の途中で届いた信頼できないコンテンツとしては扱いません。トリガーが証明するのは、そのプロンプトがアカウント上の認可されたセッションによって事前に保存されたことだけです。したがって、発火したプロンプトはライブのユーザー入力ではなく、実行中のアクションに対する承認や同意として機能することはできません。セッションが実行中に取得するコンテンツは、通常どおりに扱われます。

3. トリガーを選択する

Trigger 行で、タスクの開始方法を選択します。複数のトリガーを組み合わせるには、行の末尾にある + をクリックします。

Schedule

定期実行のプリセット頻度を選択します。タイムゾーンの扱い、遅延開始、カスタム cron 間隔、1 回限りの実行については、スケジュールトリガーを追加するを参照してください。

GitHub event

リポジトリ、反応するイベント、およびオプションのフィルタを選択します。サポートされているイベントとフィルタフィールドの完全なリストについては、GitHub トリガーを追加するを参照してください。

API

ここで API を選択します。Create をクリックすると、API token ダイアログにトークンが 1 回だけ表示されるため、ダイアログを閉じる前にコピーしてください。URL をコピーしたり新しいトークンを生成したりするには、API トリガーを追加するを参照してください。

4. リポジトリを選択する

Advanced settings を展開します。General タブの Repository で、Claude が作業する 1 つ以上の GitHub リポジトリを選択します。

各リポジトリは実行の開始時にクローンされます。Claude は変更用に claude/ プレフィックス付きのブランチを作成します。

5. 環境を選択する

リポジトリを選択すると、その下に Cloud environment が表示されます。タスク用のクラウド環境を選択します。環境は、クラウドセッションがアクセスできるものを制御します。

  • Network access: 各実行中に利用可能なインターネットアクセスのレベルを設定します
  • Environment variables: Claude が各実行中に使用できる値を提供します。これらは環境を使用するすべてのユーザーに表示されるため、Anthropic がホストする環境では、Claude が実行中に呼び出す API のキーは代わりにネットワークシークレットとして保存してください。そのセクションには、シークレットが付与されないリクエストも記載されています
  • Setup script: タスクが必要とする依存関係とツールをインストールします。結果はキャッシュされるため、スクリプトはセッションごとに再実行されません

Default 環境は Trusted ネットワークアクセスで提供されます。これにより、パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、一般的な開発ドメインからなるデフォルト許可リストのみがセッションのネットワークを通じて許可されます。タスクに追加するコネクタは Anthropic のサーバーを通じてサービスにアクセスするため、許可リストを変更する必要はありません。

タスクが独自のサービスや、そのリストにないドメインに直接アクセスする必要がある場合は、実行前に環境のネットワークアクセスを編集してください。別の環境を使用するには、先に環境を作成してください。

6. コネクタを確認する

Advanced settings の Connectors タブに切り替えます。接続済みのすべての MCP コネクタがデフォルトで含まれています。タスクに不要なものは削除してください。Claude は、含まれているコネクタのすべてのツールを、書き込みも含め、実行中に権限を求めることなく使用できます。

7. タスクを作成する

Create をクリックします。ダイアログが閉じ、新しいタスクの詳細ページが開きます。タスクは、トリガーのいずれかが次に一致したときに実行されます。すぐに実行を開始するには、詳細ページで Run now をクリックします。

各実行では他のセッションと並んで新しいセッションが作成され、そこで Claude が行ったことの確認、変更のレビュー、プルリクエストの作成ができます。

メインビューに Repositories と Environment があるダイアログ

Web から作成する手順に従い、各フィールドは Advanced settings ではなくダイアログのメインビューで入力します。このダイアログでは Claude Code タスクのみが作成されます。

GitHub イベントトリガーを追加する前にリポジトリを選択してください。リポジトリを選択するまで、そのトリガーは使用できません。

CLI から作成する

任意のセッションで /schedule を実行すると、会話形式でスケジュールタスクを作成できます。説明を直接渡すこともできます。定期タスクなら /schedule daily PR review at 9am、1 回限りなら /schedule clean up feature flag in one week のように指定します。Claude は Web ダイアログが収集するのと同じ情報を順に確認し、タスクをアカウントに保存します。このコマンドは /routines というエイリアスでも利用できます。

正常に開始されると、会話のように進みます。Claude は保存する前に、スケジュール、リポジトリ、プロンプトについて追加の質問をします。代わりに、認証が必要である、またはリモートの claude.ai アカウントに接続できないと Claude が返答した場合、スケジュールタスクは作成されていません。トラブルシューティングを参照してください。

/schedule で作成したタスクにはスケジュールトリガーがあります。他のトリガータイプを追加することもできます。

  • API トリガー: claude.ai/code/routines の Web でタスクを編集します
  • GitHub トリガー: Web でタスクを編集するか、CLI で Claude に依頼します。CLI から追加するには Claude Code v2.1.225 以降が必要です

API 呼び出しや GitHub イベントによってのみ開始されるものなど、スケジュールトリガーのないスケジュールタスクには次回の実行時刻がありません。Claude がそれを保存または更新するとき、CLI は何も表示しません。v2.1.211 より前は、CLI はこれらのタスクについて西暦 1 年の次回実行時刻を報告していました。

トリガーを設定する

スケジュールタスクは、トリガーのいずれかが一致したときに開始されます。タスクのトリガーは、タスクの編集ダイアログの Trigger 行でいつでも追加または削除できます。

タスクに 2 つ以上のトリガーがある場合、そのダイアログでは各トリガーにゴミ箱アイコンが表示されます。スケジュールトリガーまたは GitHub イベントトリガーを削除するには、そのゴミ箱アイコンをクリックしてから Save changes をクリックします。API トリガーを削除するには、代わりにそのトークンを削除します。

スケジュールトリガーを追加する

スケジュールトリガーは、定期的なペースで、または将来の特定の時刻に 1 回、タスクを実行します。Web のタスク作成ダイアログまたは編集ダイアログで、1 時間ごと、毎日、毎週などのプリセット頻度を選択します。

  • タイムゾーン: 時刻はローカルのタイムゾーンで入力され、自動的に変換されるため、クラウドインフラストラクチャの所在地に関係なく、タスクはその現地時刻に実行されます。
  • 正時の実行: 9:00 のように正時ちょうどに実行をスケジュールすると、数分遅れて開始される場合があります。スケジュールした時刻に近いタイミングで開始するには、9:07 のように正時から数分ずらした時刻を選択してください。
  • カスタム間隔: 2 時間ごとなどのカスタム間隔の場合は、ダイアログで最も近いプリセットを選択してから、CLI で /schedule update を実行して特定の cron 式を設定します。最小間隔は 1 時間で、それより頻繁に実行される式は拒否されます。

1 回限りの実行をスケジュールする

1 回限りのスケジュールは、特定のタイムスタンプでタスクを 1 回だけ実行します。たとえば、次のような用途に使用します。

  • 週の後半に自分へリマインドする
  • ロールアウト完了後にクリーンアップ PR を作成する
  • アップストリームの変更がリリースされた後にフォローアップ作業を開始する

タスクは実行後に自動的にオフになり、Web UI では Completed と表示されます。再度実行するには、Web でタスクの編集ダイアログを開き（1 回限りのタスクでは One-time が表示されます）、新しい時刻を設定します。

CLI から 1 回限りの実行を作成するには、時刻を自然言語で記述します。Claude は現在時刻を基準にその表現を解釈し、保存する前に絶対タイムスタンプを確認します。

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

定期スケジュールと同じローカル時刻から UTC への変換が、1 回限りのタイムスタンプにも適用されます。

1 回限りの実行は、他のスケジュール実行と同じ 1 時間あたりの制限にカウントされます。詳細については、使用量と制限を参照してください。

API トリガーを追加する

API トリガーは、スケジュールタスクに専用の HTTP エンドポイントを提供します。タスクのベアラートークンを付けてエンドポイントに POST すると、新しいセッションが開始され、セッション URL が返されます。これを使用して、Claude Code をアラートシステム、デプロイパイプライン、社内ツールなど、認証済み HTTP リクエストを送信できるあらゆる場所に接続できます。

API トリガーは、タスクの作成時、または後から以下の手順で、Web から追加します。CLI から API トリガーを追加したり、そのトークンを管理したりすることはできません。

1. タスクを編集用に開く

claude.ai/code/routines にアクセスし、API 経由でトリガーするスケジュールタスクをクリックしてから、名前の横にあるメニューを開いて Edit を選択します。Edit scheduled task ダイアログが開きます。

2. API トリガーを追加する

Trigger 行で + をクリックし、開いたメニューから API を選択します。このタスクの Fire URL と Token を含むパネルが表示されます。

3. URL をコピーしてトークンを生成する

Fire URL をコピーします。Generate token をクリックし、Token generated ダイアログからすぐにトークンをコピーします。トークンは 1 回だけ表示され、後から取得することはできないため、アラートツールのシークレットストアなどの安全な場所に保存してください。

API トリガーはトークンを生成した時点で有効になります。Save changes をクリックする必要はないため、完了したらダイアログを閉じてください。

4. エンドポイントを呼び出す

URL に POST するときに、Authorization: Bearer ヘッダーでトークンを送信します。完全な例はスケジュールタスクをトリガーするに示されています。

各スケジュールタスクには独自のトークンがあり、そのタスクのトリガーのみにスコープされています。API アクセスをオフにする、またはトークンをローテーションするには、タスクの Edit scheduled task ダイアログを再度開きます。どちらのコントロールも API トリガーのパネル内のトークンの横にあり、すぐに反映されます。

  • API アクセスをオフにする: Regenerate の横にあるゴミ箱アイコン、Delete token をクリックします。これにより API トリガーが削除されます
  • トークンをローテーションする: Regenerate をクリックします。以前のトークンは使用できなくなり、Token generated ダイアログに新しいトークンが 1 回だけ表示されます

スケジュールタスクをトリガーする

Authorization ヘッダーにベアラートークンを指定して、/fire エンドポイントに POST リクエストを送信します。リクエスト本文では、アラート本文や失敗したログなど、実行固有のコンテキストのためのオプションの text フィールドを指定でき、保存されたプロンプトとともにタスクに渡されます。値は自由形式のテキストで、解析されません。JSON などの構造化ペイロードを送信した場合、タスクはそれをリテラル文字列として受け取ります。

text の値は、そのままのメッセージとしてルーティンに届くわけではありません。<routine-fire-payload> ブロックで囲まれて届き、このブロックはそれを信頼できないデータとしてラベル付けし、ルーティン自身のプロンプトが指示しない限り、その中の指示に従わないよう Claude に伝えます。Web UI の Run now で指定したテキストにも、同じラッピングが適用されます。

つまり、ルーティンの保存されたプロンプトで、fire テキストに基づいて行動することを明示的に許可する必要があります。たとえば「routine-fire-payload ブロックで説明されているアラートを調査する」のように、ペイロードを明示的に参照するプロンプトを書いてください。そうしないと、ルーティンはそのテキストを単なるコンテキストとして扱います。ベアラートークンを持っている人は誰でも text を送信できるため、このラッパーにより、漏洩したトークンからの fire テキストは、ルーティンへの直接の指示ではなく、信頼できないデータとしてラベル付けされて届きます。

以下の例は、シェルからスケジュールタスクをトリガーします。示されているタスク ID とトークンはプレースホルダーです。API トリガーを追加したときにコピーした URL とトークンに置き換えてください。置き換えないと、リクエストは 401 認証エラーで失敗します。

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 と URL を含む JSON 本文が返されます。

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

ブラウザでセッション URL を開くと、実行をリアルタイムで確認したり、変更をレビューしたり、会話を手動で続けたりできます。

[!WARNING]

/fire エンドポイントは experimental-cc-routine-2026-04-01 ベータヘッダーで提供されています。リクエストとレスポンスの形式、レート制限、トークンの仕様は、機能がリサーチプレビュー段階にある間に変更される可能性があります。破壊的変更は日付付きの新しいベータヘッダーバージョンで提供され、直前の 2 つのヘッダーバージョンは引き続き動作するため、呼び出し元には移行する時間があります。

API リファレンス

すべてのエラーレスポンス、検証ルール、フィールド制限を含む完全な API リファレンスについては、Claude Platform ドキュメントの API 経由でルーティンをトリガーするを参照してください。

/fire エンドポイントは claude.ai ユーザーのみが利用でき、Claude Platform API サーフェスの一部ではありません。

GitHub トリガーを追加する

GitHub トリガーは、接続されたリポジトリで一致するイベントが発生したときに、新しいセッションを自動的に開始します。Claude Code はイベント間でセッションを再利用しないため、2 つの PR 更新からは 2 つの独立したセッションが生成されます。

[!NOTE]

GitHub webhook イベントには、タスクごとおよびアカウントごとの 1 時間あたりの上限があります。上限を超えたイベントは、ウィンドウがリセットされるまで破棄されます。

どのサーフェスからトリガーを設定する場合でも、サブスクライブするリポジトリに Claude GitHub App がインストールされている必要があります。

  • GitHub トリガーは Web UI から設定します。アプリがない場合は、インストールするよう求められます。Web で設定するには、以下の手順に従ってください。
  • CLI からは、まず GitHub App ページからアプリをインストールし、次に既存のスケジュールタスクに GitHub トリガーを追加するよう Claude に依頼します。たとえば /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp のようにします。CLI からの設定には Claude Code v2.1.225 以降が必要です。Claude はトリガーを追加すると、そのトリガーが起動するタスクへのリンクを返信します。

1. タスクを編集用に開く

claude.ai/code/routines にアクセスし、スケジュールタスクをクリックしてから、名前の横にあるメニューを開いて Edit を選択します。Edit scheduled task ダイアログが開きます。

2. GitHub イベントトリガーを追加する

Trigger 行で + をクリックし、開いたメニューから GitHub event を選択します。

[!NOTE]

CLI で /web-setup を実行すると、クローン用のリポジトリアクセスが付与されますが、Claude GitHub App はインストールされず、webhook 配信も有効になりません。

3. トリガーを設定する

必要に応じてリポジトリを変更し、サポートされているイベントのリストからイベントを選択し、必要に応じてフィルタを追加します。その後、ダイアログ下部の Save changes をクリックしてトリガーを適用します。

サポートされているイベント

GitHub トリガーは、次のいずれかのイベントカテゴリにサブスクライブできます。各カテゴリ内で、pull_request.opened などの特定のアクションを選択するか、カテゴリ内のすべてのアクションに反応させることができます。

イベント トリガーのタイミング
プルリクエスト PR がオープン、クローズ、割り当て、ラベル付け、同期、またはその他の方法で更新されたとき
リリース リリースが作成、公開、編集、または削除されたとき

プルリクエストをフィルタリングする

フィルタを使用して、新しいセッションを開始するプルリクエストを絞り込みます。スケジュールタスクがトリガーされるには、すべてのフィルタ条件が一致する必要があります。利用可能なフィルタフィールドは次のとおりです。

フィルタ マッチ
作成者 PR 作成者の GitHub ユーザー名
タイトル PR タイトルテキスト
本文 PR 説明テキスト
ベースブランチ PR がターゲットするブランチ
ヘッドブランチ PR が由来するブランチ
ラベル PR に適用されたラベル
ドラフト PR がドラフト状態かどうか
マージ済み PR がマージされたかどうか

各フィルタは、フィールドと演算子を組み合わせます。演算子は、等しい、含む、で始まる、いずれかである、いずれでもない、正規表現に一致する、のいずれかです。

matches regex 演算子は、フィールド値の一部ではなく、フィールド値全体をテストします。hotfix を含むタイトルに一致させるには、.*hotfix.* と記述します。前後の .* がない場合、フィルタは前後に何もない、正確に hotfix であるタイトルにのみ一致します。正規表現構文を使わずにリテラルの部分文字列で一致させるには、代わりに contains 演算子を使用してください。

フィルタの組み合わせの例をいくつか示します。

  • 認証モジュールのレビュー: ベースブランチが main、ヘッドブランチに auth-provider を含む。認証に関わる PR を専門のレビュアーに送ります。
  • レビュー準備完了のみ: ドラフトが false。ドラフトをスキップし、PR がレビュー可能になったときにのみタスクが実行されるようにします。
  • ラベルによるバックポート: ラベルに needs-backport を含む。メンテナーが PR にタグを付けたときにのみ、別ブランチへの移植タスクをトリガーします。

スケジュールタスクを管理する

リスト内のスケジュールタスクをクリックすると、その詳細ページが開きます。詳細ページには、タスクのリポジトリ、コネクタ、プロンプト、スケジュール、API トークン、GitHub トリガー、過去の実行のリストが表示されます。

実行を表示して操作する

任意の実行をクリックして、フルセッションとして開きます。そこから Claude が何をしたかを確認し、変更をレビューし、プルリクエストを作成するか、会話を続けることができます。各実行セッションは他のセッションと同じように機能します。セッションタイトルの横のドロップダウンメニューを使用して、名前変更、アーカイブ、または削除を行います。

[!NOTE]

実行リストの緑色のステータスは、セッションが開始され、インフラストラクチャエラーなしで終了したことを意味します。プロンプトに記述された作業が成功したことを意味するものではありません。実行を開いてトランスクリプトを読み、Claude が実際に何をしたかを確認してください。ブロックされたネットワークリクエスト、不足しているコネクタツール、作業自体の失敗は、いずれもステータスインジケーターではなくそこに表示されます。

スケジュールタスクを編集して制御する

詳細ページから、以下を実行できます。

  • Run now をクリックして、次のスケジュール時刻を待たずにすぐに実行を開始します。
  • ページ上部のオン/オフスイッチを使用して、スケジュールを一時停止または再開します。一時停止したタスクは設定を保持しますが、再びオンにするまで実行されません。
  • タスク名の横にあるメニューを開いて Edit を選択し、名前、プロンプト、リポジトリ、環境、コネクタ、またはタスクのいずれかのトリガーを変更します。Edit scheduled task ダイアログが、作成ダイアログと同じレイアウトで開きます。トリガーを追加するには、Trigger 行の + をクリックします。編集を適用するには Save changes をクリックします。API トークンの操作は Save changes なしですぐに反映されます。
  • 同じメニューを開いて Delete を選択し、タスクを削除します。

CLI からスケジュールタスクを管理する

/schedule list を実行するとスケジュールタスクを表示でき、/schedule update で変更、/schedule run ですぐに開始できます。

スケジュールタスクの実行履歴について質問することもできます。たとえば /schedule why did my nightly review do nothing this morning? のようにします。Claude はタスクの最近の実行をステータスと各実行を Web で開くためのリンクとともに一覧表示します。また、実行のログを読み、ツールエラー、権限拒否、最終結果を含めて何が起こったかを説明します。Claude Code v2.1.227 以降が必要です。

リポジトリとブランチの権限

スケジュールタスクには、リポジトリをクローンするための GitHub アクセスが必要です。CLI で /schedule を使用してスケジュールタスクを作成すると、Claude は実行元のリポジトリに対してアカウントが GitHub アクセスを持っているかどうかを確認します。持っていない場合、Claude はアクセスを付与する方法を示すセットアップノートを追加します。

[!NOTE]

アクセスを付与する 2 つの方法については、GitHub 認証オプションを参照してください。Team プランと Enterprise プランでは、各方法を使用する前に Claude 組織の Owner がその方法をオンにする必要があります。GitHub を接続するを参照してください。

実行予定時に GitHub 接続が存在しないか期限切れの場合、スケジュールタスクは再接続されるまで、最大 72 時間、実行をスキップします。その期間内に GitHub を再接続すると、タスクは自動的に再開されます。接続がないまま 72 時間が経過するとタスクはオフになり、GitHub を再接続した後に再度オンにする必要があります。

追加した各リポジトリは、実行のたびにクローンされます。プロンプトで別途指定しない限り、Claude はリポジトリのデフォルトブランチから開始します。GitHub プルリクエストイベントが実行をトリガーし、そのプルリクエストのリポジトリがタスクの最初のリポジトリである場合、そのリポジトリは代わりにプルリクエストの head コミットから開始します。

Claude は、プロンプトで別のブランチへのプッシュを指示しない限り、claude/ で始まるブランチに作業をプッシュします。実行がプッシュできるブランチを制御するには、GitHub のブランチ保護ルールまたはルールセットを使用します。Anthropic 管理のインフラストラクチャ上の実行、および Anthropic の git プロキシを通じてプッシュするセルフホスト実行の場合、GitHub はこれらのルールを接続した GitHub アクセスに適用するため、そのアクセスがバイパスできるルールは実行のプッシュをブロックしません。デプロイが提供する git 認証情報でプッシュするセルフホスト実行は、代わりにその認証情報に対してチェックされます。git を設定するを参照してください。

コネクタ

スケジュールタスクは、接続済みの MCP コネクタを使用して、各実行中に外部サービスの読み取りと書き込みを行えます。たとえば、サポートリクエストをトリアージするタスクは、Slack チャンネルから読み取り、Linear に課題を作成することがあります。

コネクタは、アカウント上の claude.ai インテグレーションです。CLI で claude mcp add を使用してローカルに追加した MCP サーバーは claude.ai アカウントではなくマシンに保存されるため、コネクタリストには表示されません。これらのサーバーのいずれかをスケジュールタスクで使用するには、次のいずれかを行います。

  • コネクタとして: claude.ai/customize/connectors でコネクタとして追加します
  • リポジトリ内で: リポジトリが 1 つのスケジュールタスクの場合は、代わりにコミットされた .mcp.json でサーバーを宣言し、クローンされるリポジトリの一部にすることもできます

スケジュールタスクを作成すると、現在接続されているすべてのコネクタがデフォルトで含まれます。実行中に Claude がアクセスできるツールを制限するため、不要なものは削除してください。タスクの作成ダイアログまたは編集ダイアログから直接コネクタを追加することもできます。

そのダイアログ以外でコネクタを管理または追加するには、claude.ai/customize/connectors にアクセスするか、CLI で /schedule update を使用します。

実行が確認なしでアーティファクトを公開する場合

スケジュールタスクのスケジュールまたは Run now によって実行が開始された場合、Claude は確認を求めずに新しいアーティファクトを公開できます。新しいアーティファクトは、共有するまではユーザー本人にのみ表示されます。公開時にページのランタイム機能（コネクタ呼び出しやファイルのダウンロードなど）を宣言する場合、Claude は事前に確認を求めます。

これらの実行では、Claude は以下のすべてが満たされる場合にのみ、確認を求めずに既存のアーティファクトを再公開します。

  • アーティファクトを編集でき、かつ自分の組織に属している
  • 公開内容にページ以外のもの（サポートファイルなど）が含まれる場合、そのアーティファクトを所有している
  • アーティファクトが一般公開で共有されていない
  • アーティファクトが特定のユーザーまたは組織と共有されている場合、その閲覧者に新しいバージョンが自動的に表示されない
  • 公開によって新しいバージョンを強制的に上書きしない
  • 公開でページのランタイム機能を宣言しない
  • 既存のページに、ページの範囲を超える権限付与（コネクタ呼び出しなど）がない

API トリガーや GitHub トリガーによって開始された実行を含め、それ以外のすべての場合、Claude は事前に確認を求めます。

スケジュールタスクの役割がページを最新の状態に保つことである場合は、すでに公開済みのアーティファクトを渡してください。

環境とネットワークアクセス

各スケジュールタスクは、ネットワークアクセス、環境変数、セットアップスクリプトを制御するクラウド環境を使用します。タスクは、すべての実行でその環境のネットワークポリシーを継承します。

Default 環境は Trusted ネットワークアクセスを使用します。これにより、セッションのネットワークを通じてデフォルト許可リストのみが許可されます。そのパス上で許可リスト外のホストへのリクエストは 403 と x-deny-reason: host_not_allowed で失敗します。MCP コネクタのトラフィックはそのパスではなく Anthropic のサーバーを通じてルーティングされるため、タスクに追加するコネクタは Allowed domains にホストを追加しなくても機能します。不要なコネクタはコネクタで削除してください。

独自の環境のいずれかで追加のドメインを許可するには、以下の手順に従います。組織共有環境はここでは読み取り専用で開くため、その場合は Owner が管理設定の Cloud environments ページからネットワークアクセスを変更します。

1. タスクを編集用に開く

claude.ai/code/routines にアクセスし、スケジュールタスクをクリックしてから、名前の横にあるメニューを開いて Edit を選択します。Edit scheduled task ダイアログが開きます。

2. 環境セレクタを開く

Advanced settings > General > Cloud environment に移動します。Advanced settings が折りたたまれている場合は、先に展開してください。Default など、環境の名前が表示されているクラウドアイコンをクリックします。

3. 環境設定を開く

リスト内の環境にマウスを置き、右側に表示される設定アイコンをクリックします。

4. ネットワークアクセスレベルを変更する

Edit cloud environment ダイアログで、Network access を Custom に変更し、Allowed domains にドメインを入力します。Also include default list of common package managers をチェックすると、カスタムドメインとともにデフォルト許可リストも維持されます。制限のないアクセスにするには、代わりに Full を選択します。

5. 保存

Edit cloud environment ダイアログで Save changes をクリックしてから、その背後にある Edit scheduled task ダイアログを閉じます。新しいポリシーは次の実行から適用されます。

アクセスレベルとデフォルト許可リストの詳細については、ネットワークアクセスを参照してください。

使用量と制限

スケジュールタスクは、対話型セッションと同じようにサブスクリプションの使用量を消費します。現在の消費量は claude.ai/settings/usage で確認してください。

サブスクリプションの使用量とは別に、実行を開始する各方法には 1 時間あたりの制限があります。

アクション 制限 カウント対象 制限超過時
スケジュール実行（1 回限りの実行を含む） 1 時間あたり 100 回 アカウント 制限がリセットされるまで実行は待機します
Run now、API の fire、1 回限りのタスクの再実行設定 1 時間あたり 30 回 各スケジュールタスク（3 つすべてで 1 つのカウントを共有） 制限がリセットされるまでアクションは失敗します
Run now と 1 回限りのタスクの再実行設定 1 時間あたり 100 回 アカウント 同上
API の fire 1 時間あたり 100 回 アカウント（Run now とは別にカウント） 同上
GitHub イベント GitHub トリガーを追加するを参照

これらの 1 時間あたりの制限には超過利用がありません。

スケジュールタスクがサブスクリプションの使用制限に達した場合、使用クレジットを有効にしている組織は、従量制の超過利用でスケジュールタスクの実行を続けられます。使用クレジットがない場合、使用量のウィンドウがリセットされるまで追加の実行は拒否されます。使用クレジットは claude.ai/settings/usage で有効にしてください。Team プランと Enterprise プランでは、管理者が claude.ai/admin-settings/usage で組織の使用クレジットを有効にします。

サブスクリプションが一時停止されている間、スケジュールタスクは保留状態になり、実行されません。サブスクリプションが再びアクティブになったら、タスクを再度オンにしてください。

ルーティンという名前が残っている場所

スケジュールタスクは以前ルーティンと呼ばれており、以下の場所では以前の名前が残っています。いずれも同じ機能を指します。

  • Web アドレス: claude.ai/code/routines
  • CLI: /schedule のエイリアス /routines、コマンドの説明、タスクのセットアップ中の Claude の返答
  • API: /fire エンドポイントのパス、そのベータヘッダー、レスポンスの type、<routine-fire-payload> タグ、および API 経由でルーティンをトリガーするリファレンスページ
  • 組織設定: Scheduled tasks (Was Routines) トグル

トラブルシューティング

/schedule returns "Unknown command"

CLI は /schedule の要件の 1 つが満たされていない場合、このコマンドを非表示にします。入力中、コマンドメニューには No commands match "/schedule" と表示されます。送信すると Unknown command: /schedule が返されます。ただし、以下のケースのうち異なる応答を示すものは除きます。

原因は通常、以下のいずれかです。

  • Console API キー、Anthropic プロフィールまたはフェデレーション認証情報、または Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などのクラウドプロバイダーで認証されている。/schedule には claude.ai サブスクリプションでのログインが必要です。Console API キーまたはプロフィールを使用していて、フィーチャーフラグの取得が有効な場合、/schedule を送信すると代わりに /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access と表示されます。クラウドプロバイダーでログインしている場合は、引き続き Unknown command: /schedule が表示されます。シェルで ANTHROPIC_API_KEY または ANTHROPIC_AUTH_TOKEN が設定されている場合、または settings.json で apiKeyHelper が設定されている場合は、これらが claude.ai ログインより優先されるため、まず削除してください。プロフィールまたはフェデレーション認証情報も優先されるため、それもオフにしてください
  • 完全にサインアウトしており、API キーやその他の認証情報がない。フィーチャーフラグの取得が有効な場合、/schedule を送信すると /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. と表示されます。v2.1.268 より前は、サインアウトしたセッションでは Console API キーの場合と同じ Claude for Enterprise のメッセージが表示されていました
  • クラウドセッション内にいる。この場合、/schedule を送信すると、その環境ではコマンドを使用できないという応答が返されます。代わりに Web UI からスケジュールタスクを管理してください
  • 組織のポリシーが、スケジュールタスクに必要なクラウドセッションを無効にしている。この場合、/schedule を送信すると代わりに Cloud sessions are disabled by your organization's policy と応答されます。v2.1.268 より前は、Unknown command: /schedule が返されていました
  • Owner が Team または Enterprise 組織のスケジュールタスクをオフにした。v2.1.227 より前は、このケースでもコマンドが表示されており、Claude がタスクを作成または実行しようとしたときに claude.ai がそれを拒否していました

組織のポリシーでスケジュールタスクまたはクラウドセッションが無効になっていない限り、CLI の設定に関係なく、claude.ai/code/routines でスケジュールタスクを作成・管理できます。

"Routines are disabled by your organization's policy"

Team または Enterprise 組織の Owner が、Organization settings > Capabilities > Remote sessions の Scheduled tasks (Was Routines) トグルをオフにしている可能性があります。Claude Code v2.1.227 以降では、同じトグルで CLI の /schedule も非表示になります。これはサーバー側の組織設定であるため、ローカルの設定から上書きすることはできません。組織のスケジュールタスクを再びオンにするよう Owner に依頼してください。

関連リソース

  • /loop とセッション内スケジューリング: 開いている CLI セッション内でローカルタスクをスケジュール
  • Desktop スケジュールタスク: マシン上で実行され、ローカルファイルにアクセスできるローカルのスケジュールタスク
  • クラウド環境: クラウドセッションのネットワークアクセス、環境変数、セットアップスクリプトを設定
  • Projects: Claude が複数のクラウドセッションにわたって並行して調整する継続的な作業。プロジェクトから作成されたスケジュールタスクは、その Scheduled tasks タブに表示されます
  • MCP コネクタ: Slack、Linear、Google Drive などの外部サービスを接続
  • GitHub Actions: リポジトリイベントに応じて CI パイプラインで Claude を実行