ルーティンはリサーチプレビュー段階です。動作、制限、API サーフェスは変更される可能性があります。
- スケジュール: 時間ごと、毎晩、毎週など、定期的なペースで実行
- API: ベアラートークン付きで HTTP POST をルーティン固有のエンドポイントに送信してオンデマンドでトリガー
- GitHub: プルリクエストやリリースなどのリポジトリイベントに自動的に反応して実行
/schedule を使用して管理できます。
このページでは、ルーティンの作成、各トリガータイプの構成、実行の管理、および使用制限の適用方法について説明します。
ユースケースの例
各例は、トリガータイプと、ルーティンが適している作業の種類をペアにしています。無人で実行でき、繰り返し可能で、明確な成果に結びついています。 バックログメンテナンス。 スケジュールトリガーは毎週夜間にコネクタ経由で問題追跡ツールに対して実行されます。ルーティンは最後の実行以降にオープンされた問題を読み取り、ラベルを適用し、参照されているコード領域に基づいて所有者を割り当て、Slack に概要を投稿して、チームが 1 日を整理されたキューで開始できるようにします。 アラートトリアージ。 監視ツールがエラー閾値を超えたときにルーティンの API エンドポイントを呼び出し、アラート本文をtext として渡します。ルーティンはスタックトレースを取得し、リポジトリの最近のコミットと相関させ、提案された修正とアラートへのリンク付きのドラフトプルリクエストを開きます。オンコール担当者は空のターミナルから始めるのではなく PR をレビューします。
カスタムコードレビュー。 GitHub トリガーは pull_request.opened で実行されます。ルーティンはチームの独自のレビューチェックリストを適用し、セキュリティ、パフォーマンス、スタイルの問題についてインラインコメントを残し、概要コメントを追加して、人間のレビュアーが機械的なチェックではなく設計に焦点を当てられるようにします。
デプロイ検証。 CD パイプラインは各本番デプロイ後にルーティンの API エンドポイントを呼び出します。ルーティンは新しいビルドに対してスモークテストを実行し、エラーログをスキャンして回帰を検出し、デプロイウィンドウが閉じる前にリリースチャネルに go または no-go を投稿します。
ドキュメントドリフト。 スケジュールトリガーは毎週実行されます。ルーティンは最後の実行以降にマージされた PR をスキャンし、変更された API を参照するドキュメントにフラグを立て、エディターがレビューするためにドキュメントリポジトリに対して更新 PR を開きます。
ライブラリポート。 GitHub トリガーは pull_request.closed で実行され、1 つの SDK リポジトリのマージされた PR にフィルタリングされます。ルーティンは別の言語の並列 SDK に変更をポートし、マッチング PR を開き、人間が各変更を再実装することなく 2 つのライブラリを同期させます。
以下のセクションでは、ルーティンの作成と各トリガータイプの構成について説明します。
ルーティンを作成する
Web、Desktop アプリ、または CLI からルーティンを作成します。3 つのサーフェスすべてが同じクラウドアカウントに書き込むため、CLI で作成したルーティンは claude.ai/code/routines に即座に表示されます。Desktop アプリで、New task をクリックして New remote task を選択します。代わりに New local task を選択すると、ローカル Desktop スケジュール済みタスク が作成されます。これはマシンで実行され、ルーティンではありません。 作成フォームは、ルーティンのプロンプト、リポジトリ、環境、コネクタ、トリガーを設定します。 ルーティンは完全な Claude Code クラウドセッションとして自律的に実行されます。パーミッションモードピッカーはなく、実行中の承認プロンプトもありません。セッションはシェルコマンドを実行でき、クローンされたリポジトリにコミットされた スキル を使用でき、含めたすべてのコネクタを呼び出すことができます。ルーティンが到達できるものは、選択したリポジトリとそのブランチプッシュ設定、環境 のネットワークアクセスと変数、および含めたコネクタによって決定されます。これらのそれぞれをルーティンが実際に必要とするものにスコープします。 ルーティンは個別の claude.ai アカウントに属します。チームメイトと共有されず、アカウントの日次実行許容量に対してカウントされます。ルーティンが接続された GitHub ID またはコネクタを通じて行うことはすべて、あなたとして表示されます。コミットとプルリクエストは GitHub ユーザーを持ち、Slack メッセージ、Linear チケット、またはその他のコネクタアクションはそれらのサービスのリンクされたアカウントを使用します。Web から作成する
作成フォームを開く
claude.ai/code/routines にアクセスして、New routine をクリックします。
ルーティンに名前を付けてプロンプトを書く
ルーティンに説明的な名前を付け、Claude が毎回実行するプロンプトを書きます。プロンプトが最も重要な部分です。ルーティンは自律的に実行されるため、プロンプトは自己完結型で、何をするか、成功がどのように見えるかについて明示的である必要があります。プロンプト入力にはモデルセレクタが含まれます。Claude は毎回実行時に選択されたモデルを使用します。
リポジトリを選択する
Claude が作業する 1 つ以上の GitHub リポジトリを追加します。各リポジトリは実行の開始時にクローンされ、デフォルトブランチから開始されます。Claude は変更用に
claude/ プレフィックス付きブランチを作成します。任意のブランチへのプッシュを許可するには、そのリポジトリに対して Allow unrestricted branch pushes を有効にします。トリガーを選択する
Select a trigger で、ルーティンの開始方法を選択します。1 つのトリガータイプを選択することも、複数を組み合わせることもできます。
- Schedule
- GitHub event
- API
プリセット周波数を選択します。時間ごと、毎日、平日、または毎週。タイムゾーン処理、スタガー、カスタム cron 間隔については、スケジュールトリガーを追加 を参照してください。
コネクタをレビューする
接続されたすべての MCP コネクタ はデフォルトで含まれます。ルーティンが必要としないものを削除します。コネクタは Claude に各実行中に Slack、Linear、Google Drive などの外部サービスへのアクセスを提供します。
CLI から作成する
任意のセッションで/schedule を実行して、スケジュール済みルーティンを会話形式で作成します。/schedule daily PR review at 9am のように、説明を直接渡すこともできます。Claude は Web フォームが収集するのと同じ情報を通じて、ルーティンをアカウントに保存します。
CLI の /schedule はスケジュール済みルーティンのみを作成します。API または GitHub トリガーを追加するには、claude.ai/code/routines で Web 上のルーティンを編集します。
CLI は既存のルーティンの管理もサポートしています。/schedule list を実行してすべてのルーティンを表示し、/schedule update を実行して 1 つを変更するか、/schedule run を実行してすぐにトリガーします。
Desktop アプリから作成する
Desktop アプリで Schedule ページを開き、New task をクリックして、New remote task を選択します。Desktop アプリは同じグリッドにローカルスケジュール済みタスクとルーティンの両方を表示します。ローカルオプションの詳細については、Desktop スケジュール済みタスク を参照してください。トリガーを構成する
ルーティンはトリガーの 1 つが一致したときに開始されます。同じルーティンにスケジュール、API、GitHub トリガーの任意の組み合わせを接続でき、ルーティンの編集フォームの Select a trigger セクションからいつでも追加または削除できます。スケジュールトリガーを追加する
スケジュールトリガーは定期的なペースでルーティンを実行します。Select a trigger セクションでプリセット周波数を選択します。時間ごと、毎日、平日、または毎週。時間はローカルゾーンで入力され、自動的に変換されるため、ルーティンはクラウドインフラストラクチャがどこにあるかに関係なく、その壁時計時間で実行されます。 スタガーのため、実行はスケジュール時刻の数分後に開始される可能性があります。オフセットは各ルーティンで一貫しています。 2 時間ごと、または毎月の最初など、カスタム間隔の場合は、フォームで最も近いプリセットを選択してから、CLI で/schedule update を実行して特定の cron 式を設定します。最小間隔は 1 時間です。より頻繁に実行される式は拒否されます。
API トリガーを追加する
API トリガーはルーティンに専用 HTTP エンドポイントを提供します。ルーティンのベアラートークンでエンドポイントに POST すると、新しいセッションが開始され、セッション URL が返されます。これを使用して Claude Code をアラートシステム、デプロイパイプライン、内部ツール、または認証済み HTTP リクエストを実行できる任意の場所に接続します。 API トリガーは Web から既存のルーティンに追加されます。CLI は現在、トークンを作成または取り消すことができません。ルーティンを編集用に開く
claude.ai/code/routines に移動し、API 経由でトリガーするルーティンをクリックしてから、鉛筆アイコンをクリックして Edit routine を開きます。
URL をコピーしてトークンを生成する
モーダルはこのルーティンの URL とサンプル curl コマンドを表示します。URL をコピーしてから、Generate token をクリックしてトークンをすぐにコピーします。トークンは 1 回表示され、後で取得できないため、アラートツールのシークレットストアなどの安全な場所に保存してください。
エンドポイントを呼び出す
URL に POST するときに
Authorization: Bearer ヘッダーでトークンを送信します。以下の ルーティンをトリガーする セクションに完全な例が示されています。ルーティンをトリガーする
Authorization ヘッダーのベアラートークンで /fire エンドポイントに POST リクエストを送信します。リクエスト本文は、アラート本文またはログの失敗など、実行固有のコンテキスト用のオプションの text フィールドを受け入れます。保存されたプロンプトと共にルーティンに渡されます。値はフリーフォームテキストで、解析されません。JSON または別の構造化ペイロードを送信する場合、ルーティンはリテラル文字列として受け取ります。
以下の例は、シェルからルーティンをトリガーします。
API リファレンス
すべてのエラー応答、検証ルール、フィールド制限を含む完全な API リファレンスについては、Claude Platform ドキュメントの API 経由でルーティンをトリガーする を参照してください。/fire エンドポイントは claude.ai ユーザーのみが利用でき、Claude Platform API サーフェスの一部ではありません。
GitHub トリガーを追加する
GitHub トリガーは、接続されたリポジトリで一致するイベントが発生したときに、新しいセッションを自動的に開始します。一致する各イベントは独自のセッションを開始します。リサーチプレビュー中、GitHub webhook イベントはルーティンごとおよびアカウントごとの時間単位の上限の対象です。制限を超えるイベントはウィンドウがリセットされるまでドロップされます。現在の制限は claude.ai/code/routines で確認してください。
ルーティンを編集用に開く
claude.ai/code/routines に移動し、ルーティンをクリックしてから、鉛筆アイコンをクリックして Edit routine を開きます。
GitHub イベントトリガーを追加する
Select a trigger セクションまでスクロールし、Add another trigger をクリックして、GitHub event を選択します。
Claude GitHub App をインストールする
Claude GitHub App は、サブスクライブするリポジトリにインストールする必要があります。トリガーセットアップは、まだインストールされていない場合はインストールするよう促します。
CLI で
/web-setup を実行するとリポジトリアクセスがクローン用に付与されますが、Claude GitHub App はインストールされず、webhook 配信は有効になりません。GitHub トリガーは Claude GitHub App をインストールする必要があり、トリガーセットアップはそれを行うよう促します。トリガーを構成する
リポジトリを選択し、サポートされているイベント リストからイベントを選択し、オプションでフィルタを追加します。トリガーを保存します。
サポートされているイベント
GitHub トリガーは、次のいずれかのイベントカテゴリにサブスクライブできます。各カテゴリ内で、pull_request.opened などの特定のアクションを選択するか、カテゴリ内のすべてのアクションに反応することができます。
| イベント | トリガーのタイミング |
|---|---|
| プルリクエスト | PR がオープン、クローズ、割り当て、ラベル付け、同期、またはその他の方法で更新されたとき |
| リリース | リリースが作成、公開、編集、または削除されたとき |
プルリクエストをフィルタリングする
フィルタを使用して、新しいセッションを開始するプルリクエストを絞り込みます。すべてのフィルタ条件がルーティンをトリガーするために一致する必要があります。利用可能なフィルタフィールドは次のとおりです。| フィルタ | マッチ |
|---|---|
| 作成者 | PR 作成者の GitHub ユーザー名 |
| タイトル | PR タイトルテキスト |
| 本文 | PR 説明テキスト |
| ベースブランチ | PR がターゲットするブランチ |
| ヘッドブランチ | PR が由来するブランチ |
| ラベル | PR に適用されたラベル |
| ドラフト | PR がドラフト状態かどうか |
| マージ済み | PR がマージされたかどうか |
| フォークから | PR がフォークから由来するかどうか |
matches regex 演算子はフィールド値全体をテストし、その中の部分文字列ではありません。hotfix を含むタイトルに一致させるには、.*hotfix.* を記述します。周囲の .* がない場合、フィルタは前後に何もない正確に hotfix であるタイトルのみに一致します。正規表現構文なしのリテラル部分文字列マッチングの場合は、代わりに contains 演算子を使用してください。
いくつかのフィルタ組み合わせの例。
- 認証モジュールレビュー: ベースブランチ
main、ヘッドブランチにauth-providerを含む。認証に触れる PR を焦点を絞ったレビュアーに送信します。 - 外部貢献者トリアージ: フォークから
true。フォークベースの PR をすべて、人間がそれを見る前に追加のセキュリティとスタイルレビューを通じてルーティングします。 - レビュー準備完了のみ: ドラフト
false。ドラフトをスキップして、ルーティンが PR がレビュー準備完了のときのみ実行されるようにします。 - ラベルゲート付きバックポート: ラベルに
needs-backportを含む。メンテナーが PR にタグを付けたときのみ、別のブランチへのポートルーティンをトリガーします。
セッションがイベントにマップされる方法
一致する各 GitHub イベントは新しいセッションを開始します。GitHub トリガー付きルーティンではイベント間のセッション再利用は利用できないため、2 つの PR 更新は 2 つの独立したセッションを生成します。ルーティンを管理する
リストのルーティンをクリックして、詳細ページを開きます。詳細ページには、ルーティンのリポジトリ、コネクタ、プロンプト、スケジュール、API トークン、GitHub トリガー、および過去の実行のリストが表示されます。実行を表示して操作する
任意の実行をクリックして、完全なセッションとして開きます。そこから Claude が何をしたかを確認し、変更をレビューし、プルリクエストを作成するか、会話を続行できます。各実行セッションは他のセッションと同じように機能します。セッションタイトルの横のドロップダウンメニューを使用して、名前変更、アーカイブ、または削除します。ルーティンを編集して制御する
ルーティン詳細ページから、以下を実行できます。- Run now をクリックして、次のスケジュール時刻を待たずにすぐに実行を開始します。
- Repeats セクションのトグルを使用して、スケジュールを一時停止または再開します。一時停止されたルーティンは構成を保持しますが、再度有効にするまで実行されません。
- 鉛筆アイコンをクリックして Edit routine を開き、名前、プロンプト、リポジトリ、環境、コネクタ、またはルーティンのトリガーを変更します。Select a trigger セクションは、スケジュール、API トークン、GitHub イベントトリガーを追加または削除する場所です。
- 削除アイコンをクリックしてルーティンを削除します。ルーティンによって作成された過去のセッションはセッションリストに残ります。
リポジトリとブランチパーミッション
ルーティンはリポジトリをクローンするために GitHub アクセスが必要です。CLI で/schedule を使用してルーティンを作成する場合、Claude はアカウントに GitHub が接続されているかどうかを確認し、接続されていない場合は /web-setup を実行するよう促します。GitHub 認証オプション を参照して、アクセスを付与する 2 つの方法を確認してください。
追加する各リポジトリは毎回実行時にクローンされます。Claude は、プロンプトで別の指定がない限り、リポジトリのデフォルトブランチから開始されます。
デフォルトでは、Claude は claude/ プレフィックス付きブランチにのみプッシュできます。これにより、ルーティンが保護されたまたは長期的なブランチを誤って変更するのを防ぎます。特定のリポジトリのこの制限を削除するには、ルーティンを作成または編集するときにそのリポジトリに対して Allow unrestricted branch pushes を有効にします。
コネクタ
ルーティンは接続された MCP コネクタを使用して、各実行中に外部サービスから読み取り、外部サービスに書き込むことができます。たとえば、サポートリクエストをトリアージするルーティンは Slack チャネルから読み取り、Linear で問題を作成する可能性があります。 ルーティンを作成するときに、現在接続されているすべてのコネクタがデフォルトで含まれます。実行中に Claude がアクセスできるツールを制限するために、必要でないものを削除します。ルーティンフォームの外からコネクタを管理または追加することもできます。 ルーティンフォームの外でコネクタを管理または追加するには、claude.ai で Settings > Connectors にアクセスするか、CLI で/schedule update を使用してください。
環境
各ルーティンは、ネットワークアクセス、環境変数、セットアップスクリプトを制御する クラウド環境 で実行されます。ルーティンを作成する前に環境を構成して、Claude に API へのアクセス、依存関係のインストール、またはネットワークスコープの制限を提供します。完全なセットアップガイドについては、クラウド環境 を参照してください。使用と制限
ルーティンは対話型セッションと同じ方法でサブスクリプション使用量を削減します。標準的なサブスクリプション制限に加えて、ルーティンはアカウントごとに 1 日に開始できる実行数の上限があります。現在の消費と残りの日次ルーティン実行数は claude.ai/code/routines または claude.ai/settings/usage で確認してください。 ルーティンが日次上限またはサブスクリプション使用制限に達したとき、追加使用が有効な組織は、メーター付きオーバーエッジでルーティンを実行し続けることができます。追加使用がない場合、ウィンドウがリセットされるまで追加実行は拒否されます。claude.ai で Settings > Billing から追加使用を有効にします。関連リソース
/loopとセッション内スケジューリング: オープン CLI セッション内でローカルタスクをスケジュール- Desktop スケジュール済みタスク: マシンで実行され、ローカルファイルへのアクセスを持つローカルスケジュール済みタスク
- クラウド環境: クラウドセッションのランタイム環境を構成
- MCP コネクタ: Slack、Linear、Google Drive などの外部サービスを接続
- GitHub Actions: リポジトリイベントで CI パイプラインで Claude を実行