automation·

Claude Code Routines 完全ガイド|スケジュール・API・GitHub Webhookで「ラップトップを閉じても動く」自動化を実現する

2026年4月14日にリサーチプレビュー開始したClaude Code Routinesを徹底解説。Scheduled・API・GitHubの3トリガー、Anthropicクラウドでの永続実行、/loopやGitHub Actionsとの違い、bearer tokenの安全な扱いまで、一次情報ベースで整理します。

Claude Code Routines 完全ガイド|スケジュール・API・GitHub Webhookで「ラップトップを閉じても動く」自動化を実現する

深夜のセキュリティ監査を毎晩走らせたい、PR が開かれた瞬間にレビューを自動で流したい、外部 SaaS の Webhook をきっかけに DB マイグレーション検証を動かしたい ── どれもこれまでは GitHub Actions や cron、あるいは /loop でローカルセッションを起動しっぱなしにして実現してきたはずです。

2026 年 4 月 14 日にリサーチプレビュー開始した Claude Code Routines は、これらを Claude Code のセッションそのものをクラウド上で永続化するという発想で再構成します。本記事では、3 トリガーの仕様、/loop や GitHub Actions との棲み分け、bearer token の運用まで、一次情報と実装例で解説します。Claude Code の基本はClaude Code完全ガイド、ローカル自動化はClaude Code Hooksで自動化する5つの実例をあわせてご覧ください。

この記事を読むとわかること

  • Routines の定義・対象プラン・実行インフラの前提がわかる
  • 3 トリガー(Scheduled / API / GitHub)の仕様と使い分けマトリクスが理解できる
  • /loop / GitHub Actions / Managed Agents との違いが整理できる
  • bearer token の運用・レートリミット・監査ログの取り扱いなど、セキュリティとガバナンスの実務観点が押さえられる
  • 実際に動く YAML 相当の Routine 設定例が手に入る

結論 ── Routines は「Claude Code のセッションをクラウドで永続化する」機能

Claude Code Routines は、保存済みの Claude Code 設定(プロンプト + リポジトリ + コネクタ)を Anthropic のクラウドインフラ上で自動実行する機能です。 トリガーは Scheduled(定期実行)、API(HTTP POST)、GitHub(Webhook)の 3 種類で、ラップトップを閉じても処理が継続します。

2026 年 4 月 14 日にリサーチプレビューとして全有償プラン(Pro / Max / Team / Enterprise)で利用可能になりました。従来の /loop がローカルマシン上でセッションを回し続ける方式だったのに対し、Routines は「Claude Code セッションそのものをクラウド化」する点が本質です。

Claude Code Routines の基本

リサーチプレビュー開始の経緯

Anthropic は 2026 年 4 月中旬に、Claude Code 周辺で 3 つのアップデートを立て続けに公開しました。

日付更新
2026-04-14Claude Code Routines リサーチプレビュー開始
2026-04-15デスクトップアプリの並列セッション再設計
2026-04-16Claude Opus 4.7 一般提供開始

この 3 つはセットで設計されており、Routines は Opus 4.7 の推論品質を前提に、ローカルに縛られない「AI 自動化の受け皿」を提供します。

Routine の構成要素

Routine は以下 3 要素をパッケージ化した設定です。

  • Prompt: 実行時に Claude Code に与える指示
  • Repositories: 対象リポジトリ(1 つ以上)
  • Connectors: MCP サーバーや外部サービスのコネクタ

一度この 3 要素を定義すれば、Anthropic のクラウドインフラ上で指定されたトリガーに応じて自動実行されます。

対象プラン

リサーチプレビュー段階では Pro / Max / Team / Enterprise の全有償プランで利用可能です。Free プランでは利用できません。

3 つのトリガー徹底比較

Scheduled トリガー(定期実行)

cron 相当の定期実行です。hourly / nightly / weekly などのパターンが公式に用意されており、独自の cron 式も指定できます(具体的な表記は公式ドキュメントで最新情報を確認してください)。

triggers:
  - type: scheduled
    cron: "0 3 * * *"   # 毎日 3:00 UTC
    timezone: "Asia/Tokyo"

ユースケース: 深夜の依存関係監査、週次のリリースノート生成、日次のダッシュボード更新。

API トリガー(HTTP POST)

各 Routine には固有のエンドポイントが生成され、bearer token 付きで HTTP POST することで任意のタイミングで実行できます。

curl -X POST https://routines.claude.com/v1/run/<routine-id> \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputs": {"pr_number": 123}}'

ユースケース: 外部 SaaS の Webhook からの連携、Slack / Notion など別ツールからのトリガー、モニタリングアラート起点の自動修復。

GitHub トリガー(Webhook)

Claude GitHub App の Webhook を経由して、リポジトリイベントに応じて Routine を自動実行します。受け付けるイベント一覧は広く、以下のような主要イベントに対応しています。

イベント代表ユースケース
pull_requestPR 自動レビュー、差分検証
pushブランチ保護下のポリシー検査
issue新規 Issue への初動応答
check_runテスト失敗時の原因切り分け
workflow_runCI 失敗の自動修復
discussionディスカッションへの要約コメント
releaseリリースノート生成、告知ドラフト
merge_queueマージキューイベントの監視

ただし **GitHub トリガーには per-routine・per-account で時間あたりの実行上限(レートリミット)**が設けられており、プレビュー中はこれを超えたイベントは破棄されます。上限の具体値は公式ドキュメントの最新情報を確認してください。

トリガー使い分けマトリクス

観点ScheduledAPIGitHub
起動の契機時刻外部 HTTPリポジトリイベント
遅延許容度低(決まった時刻に走る)秒〜分単位
外部システム連携GitHub 限定
セキュリティ境界最低限bearer token 必須GitHub App 経由
主な用途定期監査・レポートアラート連携・他 SaaS 連携PR / Issue / CI 自動化

実装例

例1: 毎朝 8 時に依存関係のセキュリティ監査

name: daily-security-audit
repositories:
  - owner/main-repo
prompt: |
  npm audit と pip audit を実行し、脆弱性がある場合は
  Slack #security-alerts にレポートを送ってください。
connectors:
  - mcp-slack
triggers:
  - type: scheduled
    cron: "0 23 * * *"    # 日本時間 8:00 = UTC 23:00 前日
    timezone: "UTC"

例2: PR オープン時に自動コードレビュー

name: pr-auto-review
repositories:
  - owner/main-repo
prompt: |
  PR {{pr_number}} の差分に対して、
  - 型安全・セキュリティ・パフォーマンスの観点でレビュー
  - 修正提案を PR コメントに投稿
  を行ってください。
triggers:
  - type: github
    events: [pull_request]
    actions: [opened, synchronize]

例3: 外部 SaaS からの Webhook で DB マイグレーション検証

name: db-migration-verify
repositories:
  - owner/backend
prompt: |
  提供された migration SQL ファイルを PR に含めて、
  - ステージング環境にドライラン
  - 実行計画の差分をコメント
  - 危険な操作(DROP など)を検知したら Slack 通知
  を行ってください。
triggers:
  - type: api
    authentication: bearer_token

既存の自動化手段との比較

Routines vs /loop(ローカル vs クラウド)

/loop はローカルマシン上で Claude Code セッションを反復実行する仕組みで、ラップトップを閉じると停止します。Routines はクラウドで動くため、マシンの電源状態に依存しません。詳細はClaude Codeスラッシュコマンド集を参照してください。

Routines vs GitHub Actions(Claude Code 前提 vs 汎用 CI)

GitHub Actions は汎用 CI で YAML 定義が必要ですが、Routines は Claude Code のエージェントループ前提で、Claude Code セッションをそのままクラウドで回す設計です。YAML で各ステップを書き下ろす代わりに、Prompt として自然言語で指示します。

Routines vs Managed Agents(軽量自動化 vs 長時間本番稼働)

Claude Managed Agentsは、サンドボックス・状態永続化・エラー復旧まで含む本番エージェント運用基盤で、長時間稼働・セッション状態が必要なユースケース向けです。Routines は「軽量なトリガー駆動の自動実行」、Managed Agents は「本番級のエージェントプラットフォーム」と棲み分けできます。

比較表

項目Routines/loopGitHub ActionsManaged Agents
実行場所Anthropic クラウドローカルGitHub インフラAnthropic クラウド
ラップトップ依存なしありなしなし
Claude Code 前提はいはいいいえはい
定義形式Routine 設定CLI コマンドYAMLエージェント定義
状態永続化セッション単位セッション単位ジョブ単位長期永続化
主な用途軽量トリガー自動化ローカル反復汎用 CI/CD本番エージェント

Gotcha ── プレビュー期間中の落とし穴

GitHub トリガーのレートリミット

リサーチプレビュー中は per-routine / per-account の時間単位レートリミットがあり、上限を超えた Webhook イベントは破棄されます。高頻度で発火する Webhook(巨大モノレポの全 PR push 等)を Routines で直接拾うのは不向きで、GitHub Actions 側で間引いてから API トリガーで呼び出す構成が現実的です。

API トリガーの bearer token 管理(ローテーション・スコープ制限・漏洩時の対処)

bearer token は コードにハードコードしない環境変数またはシークレットマネージャで管理する定期的にローテーションするのが鉄則です。万一 token が漏洩した場合に備えて、Anthropic 側のコンソールで即座に無効化できることも確認してください。

# Bad: token を直書き(例示用のプレースホルダ)
curl -H "Authorization: Bearer <YOUR_ROUTINE_TOKEN>" ...

# Good: 環境変数経由
export ROUTINE_TOKEN=$(vault read -field=token secret/routines/audit)
curl -H "Authorization: Bearer $ROUTINE_TOKEN" ...

タイムアウトと再試行ポリシーの把握

長時間処理を想定する Routine では、タイムアウト上限と失敗時の再試行挙動を事前に把握してください(公式ドキュメントに最新仕様あり)。無限に再試行される設定だと、Anthropic クラウド上で想定以上のトークンを消費するリスクがあります。

実行ログの追跡方法

Routine の実行ログは Anthropic コンソールから確認できますが、外部 SaaS へのエクスポートや監査ログ保管については、エンタープライズ契約で明示的に確認する必要があります。

セキュリティ・ガバナンス観点

エンタープライズで Routines を導入する場合、以下 4 点は最新の公式情報・契約条件で必ず確認してください。

  • データレジデンシー: 実行中データがどのリージョンで処理されるか
  • SOC2 / ISO 準拠: Anthropic の取得状況と Routines への適用範囲
  • 学習利用のオプトアウト: Routine 実行時のコード・データがモデル学習に使われるかの取扱い
  • 監査ログの保管期間: 実行ログの保管年限と取得 API の有無

これらは 2026 年 4 月時点で research preview 段階のため、GA 移行時に条件が変わる可能性があります。

よくある質問

よくある質問

まとめと次のステップ

Claude Code Routines は、「AI 自動化の軸足をローカルからクラウドへ」という大きな方向転換の入口です。ラップトップを閉じても動くだけでなく、Claude Code のエージェントループがそのまま本番自動化の単位になるという発想の転換が本質です。

まずは Scheduled トリガーの小さな Routine(日次のセキュリティ監査など)から始め、次に GitHub トリガーで PR レビューを自動化、慣れてきたら API トリガーで外部連携へ、と段階的に広げるのが安全です。

次のステップとして、以下をおすすめします。

関連記事

koromo からの提案

AIツールの導入判断は、突き詰めると「投資対効果が合うか」「リスクを管理できるか」「事業にどう効くか」の3点に帰着します。koromo では、この判断に必要な材料を整理するところからご支援しています。

以下のような状況にある方は、まず現状の整理だけでも前に進むきっかけになります。

  • AIで開発や業務を効率化したいが、自社に合う方法がわからない
  • 社内にエンジニアがいない / 少人数で、AI導入の進め方に見当がつかない
  • 外注先の開発会社にAI活用を提案したいが、何を求めればいいか整理できていない
  • 「AIを使えばコスト削減できるはず」と感じているが、具体的な試算ができていない

ツールを使った上で相談したい方はお問い合わせフォームから「AI活用の相談」とご記載ください。初回の壁打ち(30分)は無料で対応しています。

本記事の更新方針: 本記事は定期的に内容を見直しています。記事内の判断軸・運用パターンは執筆時点での koromo の実務的知見に基づくものであり、個別環境での効果を保証するものではありません。仕様の最新情報は必ず Claude Code Routines 公式ドキュメント をご確認ください。

Related Articles