Claude Code Routines 使い方｜料金・GitHub連携完全ガイド

Claude Codeで定期実行や自動レビューを組みたいけれど、マシンを24時間起動しておけない、GitHub Actionsまでは大げさ、/loopはセッション張りっぱなしになる――こうした悩みを抱えるエンジニアの方は多いのではないでしょうか。

Claude Code Routinesは、Anthropicクラウドで定義済みセッションを自律起動できる2026年4月公開のResearch Preview機能です。本記事では使い方を、料金・3トリガー仕様・実装観点の落とし穴・チーム導入の判断軸まで、中〜上級エンジニア向けに整理しました。

Claude Code Routinesとは｜クラウド実行の新機能

Claude Code Routines は、Anthropic管理のクラウド環境でClaude Codeセッションを自律実行する機能です。2026年4月にResearch Previewとして公開されました。従来は自マシン上でセッションを開く前提だったため、マシン稼働状態に依存しないタスク自動化が新たに可能になりました。

保存済みセッション設定をトリガーで起動する仕組み

事前にプロンプト・対象リポジトリ・MCPコネクタを定義しておくと、トリガー発火のたびに新規fresh sessionが立ち上がりタスクを自律実行します。完了後はトランスクリプトが残り、後からセッションとして開いて差分確認・PR作成・対話継続まで可能です。

Research Preview段階の提供プラン

2026年5月時点でResearch Preview段階のため、仕様・API・上限値はGA時に変更されます。実装前に Claude Code公式Docs で最新仕様を確認してください。

類似機能との使い分け｜Routines・/loop・Actions比較

Claude Codeには「定期実行」「ループ実行」の選択肢が複数あり、Routinesが本当に必要かは事前に判断したいところです。/loop・Desktop scheduled tasks・GitHub Actionsとの違いを4軸でまとめます。

【判断のコツ】

• 監査ログ・コミット名義・退職耐性が要件に入った瞬間にGitHub Actions
• 個人の朝の定型タスクをローカル独立で回したいならRoutines
• Actionsから/fireでRoutinesを呼ぶハイブリッド構成も選択肢

Claude Code Routines 使い方｜3つのトリガー仕様

Routinesの起動方法はSchedule（cron）・API（webhook）・GitHub（PR/Release）の3種類です。1つのRoutineに複数トリガーを組み合わせ、「毎朝9時に走らせつつPRオープン時にも発火」のハイブリッド構成も可能です。

Scheduleトリガー｜cron式で定期実行

cron式で実行タイミングを指定するトリガー。「毎朝9時にPRレビュー」「毎週月曜に依存関係チェック」などの定期処理に使います。

0 9 * * *     # 毎日9:00
0 9 * * 1     # 毎週月曜9:00
0 */6 * * *   # 6時間ごと

最小実行間隔は1時間。*/30 * * * * など1時間未満の指定はrejected。一回限り実行（one-off run）は実行後に自動でdisableされ日次キャップにもカウントされませんが、通常のサブスクトークン枠は消費します。

APIトリガー｜外部システムから/fireで起動

外部システムから明示的にRoutineを起動するwebhookエンドポイントを発行できます。Sentryアラート・Slackイベント・独自CIからの呼び出しに向きます。

POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire

{routine_id} は 公式リファレンス 通り、trig_ プレフィックスで始まるトリガーIDが入ります。Routine作成後にWeb UIで Generate token をクリックするとURLとトークンが表示されます。トークンは1回しか表示されないため必ず保管してください。

curl -X POST "https://api.anthropic.com/v1/claude_code/routines/trig_01abc.../fire" 
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" 
  -H "anthropic-version: 2023-06-01" 
  -H "Authorization: Bearer ${ANTHROPIC_ROUTINE_TOKEN}" 
  -H "Content-Type: application/json" 
  -d '{"text": "Sentry alert: NullPointerException at user_service.py:42"}'

bodyはoptionalで、text フィールド（最大65,536文字）にアラート本文や失敗ログを渡すと、保存済みプロンプトの末尾に追記される形でRoutineに渡されます。プロンプト本体を上書きするわけではないため、Routine側プロンプトに「以降のテキストは外部イベントの本文。優先して参照」と明示すると挙動が安定します。

GitHubトリガー｜PR・Releaseイベントで自動実行

GitHubリポジトリのPull request・Releaseイベントに連動して自動起動します。「PRオープン時の自動コードレビュー」「リリース時のchangelog整形」などに向きます。

# 他人のPRのみレビュー
Author is not one of: ["your-github-handle"]

# WIPラベル・ドラフトPRは除外

Is draft equals false

AND Labels is not one of: ["wip", "do-not-review"]

PR頻発リポジトリでは per-routine / per-account の hourly cap を超えたイベントは破棄されリトライもされません。現状この上限の具体数値は公開されておらず、Web UI（claude.ai/code/routines）で残量を確認する仕様です。本番投入前はフィルタで発火条件を狭めるか、ステージング環境で実イベント量を試算してください。

料金とプラン別実行上限｜サブスク枠共有の注意

Routines自体に追加課金はなく既存サブスクリプション枠内で動きますが、日次実行回数の制限とトークン枠共有の2点に注意が必要です。最新料金は Claude公式pricing で確認してください。

Routinesの実行は通常のClaude Codeセッションと同じトークン枠を消費するため、大量に走らせるとインタラクティブ作業で「Token limit reached」に到達しやすくなります。Settings > Billing から usage credits を有効化すれば超過分をメーター課金で続行できます。重要Routineは usage credits 有効化前提で運用設計するのが安全です。

設定手順｜3ステップで完了するセットアップ

ここからは実際のセットアップ手順。Routine作成からPRレビュー自動化レシピまで整理します。

Step1｜Web UI / /schedule / Desktopから作成

Routineは3つのサーフェスから作成でき、保存先は同じクラウドアカウントに統合されます。

1. Web UI：claude.ai/code/routines からブラウザで作成
2. CLI：Claude Code内で /schedule 実行（一覧 list、編集 update、即時実行 run）
3. Desktopアプリ：サイドバーの Routines → New routine → Remote を選択（LocalはDesktop scheduled task扱い）

CLIの /schedule はScheduleトリガーのみ作成可能。API・GitHubトリガーを追加するときはWeb UIで編集します。

Step2｜トリガー・プロンプト・環境・コネクタの設定

作成フォームで設定する主要項目。

Step3｜実行ログ確認・一時停止・即時実行

実行履歴からセッションを開きトランスクリプトを確認できます。ステータスは緑（成功）／黄（警告）／赤（失敗）の3種類。

管理画面では Run now（即時実行）、Pause/Resume（トグル）、削除アイコンが操作可能です。

実例レシピ｜毎朝PRレビューを自動化

PRレビューを平日朝9時（JST）に自動実行する設定例。

トリガー: Schedule
cron: 0 0 * * 1-5  (UTC 0:00 = JST 9:00、平日のみ)
リポジトリ: your-org/your-repo
環境: Default（Trusted）
コネクタ: GitHub（読み取り権限のみ）
プロンプト:
  open状態のPRを全部チェックして、以下を実施：
  1. 最新mainに対するconflictがあれば指摘
  2. テスト未追加の差分があれば指摘
  3. レビュー観点をPRコメントとして投稿

初回は Run now で手動fireして挙動・コネクタ権限・ネットワーク到達性を確認してから定期運用へ切り替えてください。

実装前に押さえる5つの落とし穴

Research Preview段階のため、本番組み込み前に押さえておくべき仕様を5つに整理します。

コミット・PRが個人GitHubアカウント名義になる

Routineのコミット・PR作成は、作成者のclaude.aiアカウントに紐づく個人GitHubアカウント名義で行われます。botアカウント名義にはならないため、退職と同時にコミット権限が外れて止まるリスクがあります。チーム共有用途ではGitHub Actionsへの切り替えが安全です。

MCPコネクタが書き込み権限までデフォルトON

接続済みMCPコネクタは作成時にデフォルト全部ON・書き込みまで通ります。Linear・Slack・GitHub等への書き込みが全部Routineの判断で実行されるため、読み取り完結タスクは権限を明示的にOFFにし、本番運用前に必ず1回手動fireして挙動確認してください。

緑ステータス＝タスク成功ではない

実行ステータスはインフラレベルでのプロセス終了状態を示すもので、タスクが期待通りに完了したかは別問題です。緑表示でもClaudeが「対象データが見つからなかったので何もしませんでした」と終わっているケースもあるため、初回数日はトランスクリプトを目視確認してください。

Research PreviewでAPI仕様変更リスク

APIエンドポイント・ベータヘッダー・実行上限・コネクタ仕様は変更されます。公式は「破壊的変更は新しい日付ヘッダーで提供し、直近2世代の旧ヘッダーは引き続き動作する」と明記。実装側は現行ヘッダー experimental-cc-routine-2026-04-01 をsecretsに切り出し、4xx応答を記録してヘッダー失効を検知できる設計にしておきます。

サブスク枠共有でトークンを圧迫する

Routineの実行は通常のClaude Codeセッションと同じトークン枠を消費するため、大量に走らせるとインタラクティブ作業が止まりやすくなります。usage credits 有効化でメーター課金続行は可能ですが、コスト上振れリスクは事前に試算してください。

チーム導入と管理者設定｜Actionsとの使い分け

Routinesは「個人アカウント紐付け」「コミット名義が個人」「コネクタ権限が個人セッション継承」の設計のため、チーム共有CI/CD用途には向きません。用途別の推奨ツールを整理します。

Claude Code Routinesに関するよくある質問

まとめ｜Claude Code Routinesは個人定型業務の自動化に最適

最後にこの記事の内容をまとめます。

• 料金体系：Pro 5回/Max 15回/Team・Enterprise 25回/日（追加課金なしだがサブスク枠を共有）
• トリガー仕様：Schedule（UTC固定・最小1時間）／API（/fire webhook）／GitHub（PR・Release・フィルタ可）
• 設計制約：コミット名義が個人GitHub・MCPコネクタは書き込み権限デフォルトON・緑ステータス≠タスク成功
• チーム判断軸：監査ログ・bot名義・退職耐性が要件ならGitHub Actions、個人定型業務ならRoutines

Research Preview段階のためベータヘッダーやAPIパスは変更されますが、2世代の互換維持仕様を活用すればCI/CDからの本番利用も可能になります。まずは claude.ai/code/routines で1Routine作って Run now で挙動を確認してみましょう。