ルーティンで作業を自動化する

Claude Code を自動操縦に設定します。スケジュールで実行するルーティンを定義したり、API 呼び出しでトリガーしたり、Anthropic が管理するクラウドインフラストラクチャから GitHub イベントに反応させたりできます。

ルーティンは保存された Claude Code 構成です。プロンプト、1 つ以上のリポジトリ、および一連の コネクタ をパッケージ化して、1 回定義し、自動的に実行します。ルーティンは Anthropic が管理するクラウドインフラストラクチャで実行されるため、ラップトップを閉じても動作し続けます。

各ルーティンには、1 つ以上のトリガーを接続できます。

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

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

ルーティンは Pro、Max、Team、Enterprise プランで利用可能です。Claude Code on the web が有効になっている必要があります。claude.ai/code/routines で作成・管理するか、CLI で /schedule を使用して管理できます。

Team および Enterprise 管理者は、claude.ai/admin-settings/claude-code の Routines トグルを使用して、すべてのメンバーのルーティンを無効にできます。無効にすると、既存のルーティンは実行を停止し、メンバーは新しいルーティンを作成できません。

このページでは、ルーティンの作成、各トリガータイプの構成、実行の管理、および使用制限の適用方法について説明します。

ユースケースの例

各例は、トリガータイプと、ルーティンが適している作業の種類をペアにしています。無人で実行でき、繰り返し可能で、明確な成果に結びついています。

バックログメンテナンス。 スケジュールトリガーは毎週夜間にコネクタ経由で問題追跡ツールに対して実行されます。ルーティンは最後の実行以降にオープンされた問題を読み取り、ラベルを適用し、参照されているコード領域に基づいて所有者を割り当て、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 の claude.ai/code/routines、Desktop アプリ、または CLI からルーティンを作成します。3 つのサーフェスすべてが同じクラウドアカウントに書き込むため、1 つで作成したルーティンは他のサーフェスに即座に表示されます。Desktop アプリで、サイドバーの Routines をクリックしてから New routine をクリックし、Remote を選択します。代わりに Local を選択すると、Desktop スケジュール済みタスク が作成されます。これはクラウドではなくマシンで実行されます。

作成フォームは、ルーティンのプロンプト、リポジトリ、環境、コネクタ、トリガーを設定します。

ルーティンは完全な Claude Code クラウドセッションとして自律的に実行されます。パーミッションモードピッカーはなく、実行中の承認プロンプトもありません。セッションはシェルコマンドを実行でき、クローンされたリポジトリにコミットされた スキル を使用でき、含めたすべてのコネクタを呼び出すことができます。ルーティンが到達できるものは、選択したリポジトリとそのブランチプッシュ設定、環境 のネットワークアクセスと変数、および含めたコネクタによって決定されます。これらのそれぞれをルーティンが実際に必要とするものにスコープします。

ルーティンは個別の claude.ai アカウントに属します。チームメイトと共有されず、アカウントの日次実行許容量に対してカウントされます。ルーティンが接続された GitHub ID またはコネクタを通じて行うことはすべて、あなたとして表示されます。コミットとプルリクエストは GitHub ユーザーを持ち、Slack メッセージ、Linear チケット、またはその他のコネクタアクションはそれらのサービスのリンクされたアカウントを使用します。

Web から作成する

CLI から作成する

任意のセッションで /schedule を実行して、スケジュール済みルーティンを会話形式で作成します。/schedule daily PR review at 9am のような定期ルーティンや /schedule clean up feature flag in one week のような 1 回限りのルーティンのように、説明を直接渡すこともできます。Claude は Web フォームが収集するのと同じ情報を通じて、ルーティンをアカウントに保存します。

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

CLI の /schedule はスケジュール済みルーティンのみを作成します。API または GitHub トリガーを追加するには、claude.ai/code/routines で Web 上のルーティンを編集します。

CLI は既存のルーティンの管理もサポートしています。/schedule list を実行してすべてのルーティンを表示し、/schedule update を実行して 1 つを変更するか、/schedule run を実行してすぐにトリガーします。

トリガーを構成する

ルーティンはトリガーの 1 つが一致したときに開始されます。同じルーティンにスケジュール、API、GitHub トリガーの任意の組み合わせを接続でき、ルーティンの編集フォームの Select a trigger セクションからいつでも追加または削除できます。

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

スケジュールトリガーは定期的なペースでルーティンを実行するか、特定の将来の時刻に 1 回実行します。Select a trigger セクションでプリセット周波数を選択します。時間ごと、毎日、平日、または毎週。時間はローカルゾーンで入力され、自動的に変換されるため、ルーティンはクラウドインフラストラクチャがどこにあるかに関係なく、その壁時計時間で実行されます。

スタガーのため、実行はスケジュール時刻の数分後に開始される可能性があります。オフセットは各ルーティンで一貫しています。

2 時間ごと、または毎月の最初など、カスタム間隔の場合は、フォームで最も近いプリセットを選択してから、CLI で /schedule update を実行して特定の cron 式を設定します。最小間隔は 1 時間です。より頻繁に実行される式は拒否されます。

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

1 回限りのスケジュールは、特定のタイムスタンプでルーティンを 1 回だけ実行します。週の後半に自分自身に通知したり、ロールアウトが完了した後にクリーンアップ PR を開いたり、アップストリームの変更がランディングしたときにフォローアップタスクをキックオフしたりするために使用します。ルーティンが実行された後、自動的に無効になり、Web UI は Ran としてマークします。再度実行するには、ルーティンを編集して新しい 1 回限りの時刻を設定します。

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 回限りの実行は日次ルーティン実行上限にカウントされません。これらは他のセッションと同様に、プランの通常のサブスクリプション使用量を消費します。詳細については、使用量と制限 を参照してください。

API トリガーを追加する

API トリガーはルーティンに専用 HTTP エンドポイントを提供します。ルーティンのベアラートークンでエンドポイントに POST すると、新しいセッションが開始され、セッション URL が返されます。これを使用して Claude Code をアラートシステム、デプロイパイプライン、内部ツール、または認証済み HTTP リクエストを実行できる任意の場所に接続します。

API トリガーは Web から既存のルーティンに追加されます。CLI は現在、トークンを作成または取り消すことができません。

各ルーティンは独自のトークンを持ち、そのルーティンのトリガーのみにスコープされています。ローテーションまたは取り消すには、同じモーダルに戻り、Regenerate または Revoke をクリックします。

ルーティンをトリガーする

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

以下の例は、シェルからルーティンをトリガーします。表示されているルーティン 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 を開いて、実行をリアルタイムで監視し、変更をレビューするか、会話を手動で続行します。

API リファレンス

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

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

GitHub トリガーを追加する

GitHub トリガーは、接続されたリポジトリで一致するイベントが発生したときに、新しいセッションを自動的に開始します。一致する各イベントは独自のセッションを開始します。

GitHub トリガーは Web UI からのみ構成されます。

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

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

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

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

各フィルタはフィールドを演算子とペアにします。等しい、含む、で始まる、の 1 つ、の 1 つではない、または正規表現に一致します。

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

いくつかのフィルタ組み合わせの例。

• 認証モジュールレビュー: ベースブランチ main、ヘッドブランチに auth-provider を含む。認証に触れる 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.ai インテグレーション です。CLI で claude mcp add を使用してローカルに追加した MCP サーバーはマシンに保存され、claude.ai アカウントには保存されないため、コネクタリストに表示されません。ルーティンでそれらのサーバーの 1 つを使用するには、claude.ai/customize/connectors でコネクタとして追加するか、コミットされた .mcp.json で宣言して、クローンされたリポジトリの一部にします。

ルーティンを作成するときに、現在接続されているすべてのコネクタがデフォルトで含まれます。実行中に Claude がアクセスできるツールを制限するために、必要でないものを削除します。ルーティンフォームから直接コネクタを追加することもできます。

ルーティンフォームの外でコネクタを管理または追加するには、claude.ai で Settings > Connectors にアクセスするか、CLI で /schedule update を使用してください。

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

各ルーティンは、ネットワークアクセス、環境変数、セットアップスクリプトを制御する クラウド環境 で実行されます。ルーティンは毎回実行時に環境のネットワークポリシーを継承します。

Default 環境は Trusted ネットワークアクセスを使用します。パッケージレジストリ、クラウドプロバイダー API、コンテナレジストリ、および一般的な開発ドメインの デフォルト許可リスト に到達可能ですが、任意のドメインには到達できません。他のホストへのアウトバウンドリクエストは 403 および x-deny-reason: host_not_allowed で失敗します。MCP コネクタトラフィックは Anthropic のサーバーを通じてルーティングされるため、ルーティンに追加するコネクタは Allowed domains にホストを追加しなくても機能します。コネクタ の下で必要でないコネクタを削除してください。

追加のドメインを許可するには：

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

使用と制限

ルーティンは対話型セッションと同じ方法でサブスクリプション使用量を削減します。標準的なサブスクリプション制限に加えて、ルーティンはアカウントごとに 1 日に開始できる実行数の上限があります。現在の消費と残りの日次ルーティン実行数は claude.ai/code/routines または claude.ai/settings/usage で確認してください。

ルーティンが日次上限またはサブスクリプション使用制限に達したとき、使用クレジットが有効な組織は、メーター付きオーバーエッジでルーティンを実行し続けることができます。使用クレジットがない場合、ウィンドウがリセットされるまで追加実行は拒否されます。claude.ai で Settings > Billing から使用クレジットを有効にします。

1 回限りの実行は日次ルーティン実行上限にはカウントされません。他のセッションと同じように通常のサブスクリプション使用量を削減しますが、アカウントごとの日次ルーティン実行許容量から除外されます。

トラブルシューティング

`/schedule` が「Unknown command」を返す

CLI は、その要件の 1 つが満たされていない場合、/schedule を非表示にします。入力中はコマンドメニューに No commands match "/schedule" が表示され、送信すると Unknown command: /schedule が返されます。原因は通常、以下のいずれかです。

• Console API キーまたは Amazon Bedrock、Google Cloud の Agent Platform、Microsoft Foundry などのクラウドプロバイダーで認証されています。/schedule には claude.ai サブスクリプションログインが必要です。ANTHROPIC_API_KEY または ANTHROPIC_AUTH_TOKEN がシェルに設定されている場合、または apiKeyHelper が settings.json に設定されている場合は、これらが claude.ai ログインより優先されるため、まず削除してください
• DISABLE_TELEMETRY、DO_NOT_TRACK、CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC、または DISABLE_GROWTHBOOK がシェル環境または settings.json ファイルの env ブロックに設定されています。これらは機能フラグの取得を無効にします。/schedule はこれに依存しています
• Claude Code のウェブセッション内にいます。代わりに ウェブ UI からルーティンを管理してください

CLI がどのように構成されているかに関わらず、claude.ai/code/routines でいつでもルーティンを作成および管理できます。

`/schedule` が認証を求める

/schedule は実行されますが、Claude が最初に claude.ai アカウントで認証する必要があると応答する場合、CLI に保存された claude.ai ログインがありません。API アカウントはルーティンではサポートされていません。/login を実行し、claude.ai アカウントでサインインしてから、/schedule を再度実行してください。

「ルーティンは組織のポリシーによって無効になっています」

Team または Enterprise 組織の Owner が claude.ai/admin-settings/claude-code の Routines トグルをオフにしている可能性があります。これはサーバー側の組織設定であるため、ローカル構成からオーバーライドすることはできません。組織のルーティンを有効にするよう Owner に依頼してください。

関連リソース

• /loop とセッション内スケジューリング: オープン CLI セッション内でローカルタスクをスケジュール
• Desktop スケジュール済みタスク: マシンで実行され、ローカルファイルへのアクセスを持つローカルスケジュール済みタスク
• クラウド環境: クラウドセッションのランタイム環境を構成
• MCP コネクタ: Slack、Linear、Google Drive などの外部サービスを接続
• GitHub Actions: リポジトリイベントで CI パイプラインで Claude を実行