Claude Code のルーチン: クラウドでスケジュール実行してコーディングエージェントを動かす

3 つの構成要素はそれぞれ役割が決まっています。

• プロンプト。各ステップで承認を求めずに動くため、最重要です。タスク全体と完了条件をプロンプトに持たせる必要があります。
• リポジトリ。Claude は毎回の実行開始時にこれらをクローンし、その中で作業します。
• コネクタ。アカウントに紐づく claude.ai の連携機能（Slack や Linear など）。ルーチンはこれらから読み取り、実行中に書き込みも行えます。たとえばサポートをトリアージするルーチンは、Slack チャンネルを読み取り、Linear に課題を作成できます。

ルーチン用のコネクタは claude.ai プラットフォーム側で追加します。MCP サーバーも同様です。ローカルの設定は引き継がれません。

ルーチンは 3 通りで起動できます。スケジュール、API コール、GitHub イベントです。1 つのルーチンに 3 つすべてを組み合わせられます。

ルーチンと /loop の違い

両者は解決する課題が異なるため、/loop と /scheduleには違いがあります。

/loop タスクは現在のセッション内に存在します。あなたのマシンで Claude Code が稼働中かつアイドルの間だけ起動し、ターミナルを閉じると停止します。そのため、今まさに監視しているビルドのポーリングに向いています。

/loop など重要なコマンドの詳細は、Claude Code ターミナルのチュートリアルをご覧ください。

ルーチンはクラウドで動作し、任意のセッションから独立して存続します。

さらに 3 つ目のローカルな選択肢として、デスクトップのスケジュールタスクがあります。ローカルのファイルやツールが必要な作業向けに自分のコンピュータ上で実行します。マシンがスリープだと動きませんが、Claude アプリを開く必要はありません。

これから作るルーチン

考え方は固まりました。次はルーチンに取り組ませる対象が必要です。このチュートリアル用に、私たちは pr-review-demo を作成しました。オープンなプルリクエストが 1 つある小さな Python プロジェクトです。

このプロジェクトには cartlib パッケージがあり、ショッピングカートを扱います。価格は整数セントで保持し、会員割引やまとめ買い割引を適用し、州の売上税を加算して最終請求額を算出します。メインブランチ上のパッケージは正しい状態です。

オープンなプルリクエストでは、無料配送クーポンを追加していますが、意図的に仕込んだ実際のバグも含んでいます。ファイルをまたぐ単位の不一致で、単一ファイルだけでは見えず、2 つのファイル間で値を追って初めて分かります。これにより、以降のチュートリアルでルーチンが取り組む実のある課題が生まれます。

フォークして自身のコピーで一緒に進めてください。使い捨て用で、ここで示すパターンはルーチンを向ける任意のリポジトリに適用できます。

事前準備

Pro、Max、Team、または Enterprise プランの claude.ai アカウントが必要で、Web 上で Claude Code が有効になっている必要があります。ルーチンは claude.ai/code/routines にあります。

また、/schedule コマンドは Anthropic API キーや Bedrock・Vertex・Foundry の認証ではなく、claude.ai のサブスクリプションのログインで認証します。最新の CLI も必要なので、古い場合は claude update を実行してください。

GitHub に関する前提条件も 2 つあります。まず /web-setup がクローン権限を付与します。これはスケジュール実行のルーチンに必要です。次に、別途インストールする Claude GitHub アプリが、後述の GitHub トリガーを有効にします。

/schedule で Claude Code ルーチンを構築する

対象のリポジトリが用意できたら、CLI からルーチンを作ります。任意のセッションで /schedule を実行してください。説明を直接渡すこともできます。

/schedule daily PR review at 9 am

その後、Claude が Web フォームと同じ項目（名前、プロンプト、リポジトリ、環境、コネクタ、スケジュール）を順に確認します。ローカルタイムゾーンでスケジュールを確認し、適切な cron 式に自動変換してくれるので、9 am と入力すれば自分で cron を書く必要はありません。

アカウントにまだ GitHub 連携がない場合、Claude は /web-setup の実行を促します。実行後、/schedule を再度実行して続きに戻ってください。

不在でも動くプロンプトの書き方

このルーチンの成否を分けるのはプロンプトです。

通常のセッションは対話形式なので、進行中に Claude を修正できます。ルーチンにはそれができません。コールドスタートで最後まで走り、確認の質問はできません。タスク名、リポジトリ、完了の定義をプロンプトで明示する必要があります。

次の 2 つを比べてみましょう。最初の例は情報が足りません。

Review the open PR.

どのリポジトリか、レビュー基準は何か、コメントを残す場所はどこか、完了の定義は何か——いずれも不明です。コールドランではその欠落を埋められません。2 つ目のプロンプトはすべてに答えています。

Review the open pull request in pr-review-demo. The cartlib package works entirely in integer cents. Read the checkout flow and the values it pulls from config.py, and check that every amount stays in cents end to end. If any value is mixed in using the wrong unit, leave an inline comment on that line explaining the error and its effect on the customer's total. Then, post a summary comment stating whether the PR is safe to merge.

このプロンプトはリポジトリを特定し、コードが満たすべき不変条件（すべての金額がセント単位）を示しています。重要な 2 ファイルを指示し、完了を「インラインコメント＋マージ可否」と定義。これで単独でも狙い通りに実行できます。/schedule がエージェントの指示を尋ねたら貼り付けてください。

コネクタはデフォルトですべて含まれるため、新規のルーチンでもアカウントが接続するすべてに到達できます。現時点ではそれで十分です。後ほど必要最小限に絞ります。

フローを完了すると、Claude がルーチンを保存し、リポジトリ、スケジュール、モデル、次回実行時刻とともに稼働開始を通知します。

ルーチンは 一覧にも表れます： claude.ai/code/routines。詳細ページを開くと、ステータス、リポジトリ、スケジュール、コネクタ、完全なプロンプト、そして今すぐ実行ボタンまで、すべてを 1 か所で確認できます。

待たずに 9 時前に実行したい場合は、今すぐ実行をクリックしてください。

実行結果の読み方

実行は、デフォルトブランチからリポジトリを新たにクローンするところから始まります。コミット済みのものはすべて含まれますが、あなたのマシンにのみ設定したものは含まれません。つまり、チームメイトが見るのと同じ状態でリポジトリを読みます。

完了すると、実行一覧に緑のステータスが表示されます。緑は、インフラエラーなくセッションが実行・終了したことを意味します。ただし、プロンプトのタスクが成功したとは限りません。緑のチェックの裏には、トランスクリプトを見ないと分からない 3 種の失敗が隠れています。

• 環境によってブロックされたネットワークリクエスト。
• ルーチンが想定していたが到達できなかったコネクタツール。
• タスクレベルの失敗（実行は正常終了したが、内容が誤っている）。

そのため、実行内容を開いて確認してください。任意の実行をクリックすると、完全なセッションとして読めます。Claude が何をしたか、差分の確認、プルリクエストの作成、会話の継続まで可能です。

デモのリポジトリでは、トランスクリプトが不具合の発見を示します。Claude は checkout.py を読み、クーポンが 500 ではなく 5 に設定されていることを見つけます。これは 5 ドルを 5 セントとして適用し、1 注文あたり 4.95 ドルの過剰請求になると説明し、1 行の修正案を提示します。続けて GitHub コネクタ経由で PR にレビューを投稿します。

CLI から Claude Code ルーチンを管理する

ルーチンは作成後も同じコマンドから管理します。すべてを確認するには /schedule list、変更するには /schedule update、すぐに起動するには /schedule run を実行します。

スケジュールのプリセットは、毎時、毎日、平日、毎週です。2 時間おきや毎月 1 日などカスタム間隔にするには、まず最も近いプリセットを選び、続けて /schedule update で cron 式を直接設定します。最小間隔は 1 時間で、それより短い間隔は拒否されます。

ルーチンはアカウントの 1 日あたりの実行上限にもカウントされます。リサーチプレビュー中は GitHub イベントに時間あたりの上限もあります。上限を超えたイベントはキューに入らず破棄されます。現在の値はプランによって異なり、 claude.ai/code/routines に表示されます。

CLI で作成できるのはスケジュール実行のルーチンのみです。GitHub や API トリガーの追加は Web アプリで編集してください。

GitHub と HTTP から Claude Code ルーチンを起動する

スケジュールは時計仕掛けでルーチンを起動します。ほかに 2 つのトリガーを使えば、GitHub や自社システムから同じルーチンを起動できます。PR レビュールーチンを、毎晩の実行、新規 PR への反応、デプロイスクリプトからの起動を同時に行うことができます。

両方とも、ルーチンの編集画面（ claude.ai/code/routines）で追加します。

GitHub トリガーでプルリクエストに反応する

GitHub トリガーには、購読対象のリポジトリに Claude GitHub アプリがインストールされている必要があります。アプリが未導入の場合は、トリガー設定でインストールを促されます。なお、先ほどの /web-setup はクローン権限を付与するだけです。アプリのインストールや Webhook の配信は行わないため、このステップの代替にはなりません。

アプリのインストール後、トリガーを追加してイベントを選びます。イベントは プルリクエスト と リリースの 2 系統に分かれ、その中で具体的なアクションを選択します。UI には一般的なもの（PR 作成、PR マージ、リリース公開）がプリセットとして表示され、その他はカスタムで指定できます。

続けてフィルタで絞り込みます。プルリクエストでは、作成者、タイトル、本文、ベースブランチ、ヘッドブランチ、ラベル、下書き状態、マージ済みかどうかでフィルタできます。すべての条件が一致したときにルーチンが起動します。

演算子 matches regex はフィールド全体に対してマッチングします。タイトルに hotfix を含むものにマッチさせるには、.*hotfix.* と書きます。単なる hotfix は、タイトルが完全一致する場合にのみマッチします。

GitHub トリガーを新規プルリクエストで起動するように設定し、メインブランチと特定の作成者でフィルタ。

デモのリポジトリでは、イベントを「プルリクエスト作成」に設定し、フィルタは空のままにします。これで新しい PR ごとに、先ほど書いたレビューがターミナルなしで走ります。ファイルをまたいでクーポンの単位を追跡し、バグの行にインラインコメントを残し、マージ可否を投稿します。 

一致した各イベントは独立したセッションを開始するため、PR が連続しても別々の実行になります。

HTTP 経由でルーチンを起動する

API トリガーを使うと、自社ツールからルーチンを起動できます。トリガーセレクタでAPI を選び、トークンを生成をクリックします。トークンは一度しか表示されず、後から取得できません。すぐにアラートツールのシークレットストアに保存してください。

次に、トークンと text 本文を付けて、ルーチンの fire エンドポイントに POST します。

curl -X POST https://api.anthropic.com/v1/claude_code/routines/$ROUTINE_ID/fire \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

text の値は文字列としてそのまま渡され、パースされません。JSON ではなく平易な文章で記述してください。構造化入力は生テキストとして届き、ルーチンはそれを逐語的に読みます。 

また anthropic-beta ヘッダーは必須です。API は実験的なため、CI に組み込む前に API リファレンスを確認してください。モニタリングツールからこのエンドポイントをアラート時に呼び出し、ルーチンにドラフトの修正 PR を自動で開かせることができます。

Claude Code ルーチンのアクセス範囲を絞る

ルーチンは自律的に動くため、実運用のリポジトリに向ける前に到達範囲を制限してください。ドキュメントでは、4 つのコントロールとして整理されています。

• GitHub のアイデンティティやコネクタを通じて、ルーチンが誰として振る舞うか。
• プッシュ可能なブランチ。
• 使用可能なコネクタ。
• 環境がネットワーク越しに到達を許すホスト。

各項目を、そのルーチンに本当に必要な範囲に絞り込みましょう。

ルーチンのアイデンティティ

アイデンティティはまず最初に検討します。共有リポジトリでは、チームメイトが真っ先に気づく点だからです。ルーチンが GitHub やコネクタ経由で行うすべては、あなたの名義で表示されます。

コミットやプルリクエストにはあなたの GitHub ユーザーが付き、Slack メッセージや Linear のチケットもリンク済みアカウントを用います。チームメイトはコミットや PR であなたの名前を見るため、ブランチ名やタイトルはルーチン作成であることが分かるようにしましょう。

プッシュ可能なブランチ

ブランチも重要です。実行は権限確認のプロンプトがない完全なクラウドセッションで行われるため、ファイル編集やプルリクエスト作成の前に確認は行いません。

抑止策は、書き込み可能なブランチの制限です。デフォルトでは、Claude は claude/ 接頭辞のブランチにのみプッシュします。これにより、main のような保護・長寿命ブランチへの書き込みを防げます。

リポジトリごとの設定である Allow unrestricted branch pushes を有効にすると、この制限は解除されます。必要なリポジトリにのみ、意図的に有効化してください。

使用可能なコネクタ

コネクタは 4 つの中で最もリスクが高い領域です。claude.ai のコネクタはデフォルトですべて含まれ、含まれるコネクタのツールは書き込みを含め実行中に確認なく使用できます。

したがって、ルーチンに必要なものだけに絞り込んでください。PR レビュールーチンには GitHub だけで十分なことが多いでしょう。メールやカレンダーのコネクタなど不要なアクセスは外し、PR に潜むプロンプトインジェクションが悪用する余地を減らします。

ネットワークアクセス

ネットワークアクセスは最後のコントロールです。既定の環境は信頼済みネットワークアクセスを使用し、パッケージレジストリ、クラウドプロバイダ API、コンテナレジストリ、一般的な開発用ドメインなどの組み込み許可リストに到達できますが、それ以外はブロックします。

ブロックされたリクエストは 403 と x-deny-reason: host_not_allowed を返します。自社サービスに到達させる必要がある場合のみ範囲を広げてください。そうでないと失敗は静かに発生し、目立つエラーではなくトランスクリプト内に現れます。

次に作りたい Claude Code ルーチンのアイデア

ルーチンの作成・起動・範囲設定ができるようになりました。公式ドキュメントの以下の例は、ジョブと適切なトリガーの組み合わせです。

• カスタムコードレビュー。PR 作成の GitHub トリガー。チームのレビュー基準を適用し、セキュリティ・パフォーマンス・スタイルについてインラインコメントを残し、要約を追加します。デモを実基準に一般化した形です。
• バックログ整備。平日のスケジュールトリガー。前回以降に作成された Issue を読み、ラベル付与、コード領域に応じた担当者の自動割当、Slack へのサマリ投稿を行います。
• デプロイ検証。本番デプロイ後に CD パイプラインからの API トリガー。新ビルドに対するスモークチェック、エラーログの回帰スキャン、リリースチャンネルへの go/no-go 投稿を行います。
• ドキュメントのドリフト検知。毎週のスケジュールトリガー。前回以降にマージされた PR を走査し、変更された API を参照するドキュメントを検知し、ドキュメントリポジトリに更新 PR を作成します。

ルーチンは、無人・反復可能・明確な成果に結びつく作業に向いています。PR レビューのように成功基準をプロンプトに書けるタスクは候補です。リアルタイムの人間の判断が必要な作業は不向きです。

まとめ

ルーチンは、繰り返し作業に費やす時間の使い方を変えます。各タスクをターミナルで実行する代わりに、一度書けば後は結果を確認するだけです。作成した PR レビューはノートPCを閉じていても起動し、都合の良いときに判定を読めます。

Claude Code をさらに深めるには、次のチュートリアルが相性良く併読できます。

• Claude Code のベストプラクティス：各セッションからより多くを引き出すために。
• CLAUDE.md の書き方：ルーチンとセッションに共有コンテキストを与える。
• 仕様駆動開発：自動化前に仕様化する価値のあるタスクのために。
• 自動モードとチャンネル：より少ない監督で Claude Code を動かす。