Claude Code特集2026年5月更新

Claude Code Routines 使い方完全ガイド|スケジュール・API・GitHub Event の自動化設定と運用ポイント

公開日: 2026/04/22
更新日: 2026/05/17
Claude Code Routines 使い方完全ガイド|スケジュール・API・GitHub Event の自動化設定と運用ポイント

この記事のポイント

Claude Code Routines のスケジュール・API・GitHub Event 3種トリガーのセットアップ方法を curl コマンドや CLI コマンドレベルで解説。プラン別日次上限・プロンプト設計のコツ・セキュリティ注意点・他の自動化手段との使い分けまで、2026年5月最新情報で整理します。

Claude Code Routines は、Claude Code を Anthropic 管理のクラウドで自律実行させる「保存済み構成」で、Schedule・API・GitHub Event の3種類のトリガーからラップトップを閉じたままでもタスクを走らせられる機能です。 2026年4月14日に Research Preview として公開され、Pro / Max / Team / Enterprise プランで利用できます。

本記事では、公式ドキュメントに沿って3トリガーそれぞれのセットアップ方法を curl コマンドや CLI コマンドレベルで示し、プロンプト設計のベストプラクティス・料金・制約・他の自動化手段(Hooks / GitHub Actions / /loop)との使い分けまで整理します。

この記事でわかること

  • Claude Code Routines の定義と、従来の Claude Code との違い
  • Schedule / API / GitHub Event 3種類のトリガーの具体的なセットアップ手順
  • 1回限り(one-off)実行の活用と日次上限のカウント方法
  • 自律実行を安全に動かすためのプロンプト設計ポイント
  • Web UI・CLI・Desktop アプリでの作成・管理方法
  • Pro / Max / Team / Enterprise プランごとの日次実行数(2026年5月時点)
  • Hooks・GitHub Actions・/loop・Desktop scheduled tasks との使い分け
  • セキュリティ運用で注意すべきポイント(ブランチ制約・トークン管理・個人アカウント名義)

誰向けの記事か

  • Claude Code を PC を閉じたままクラウドで自動実行させたいエンジニア
  • Sentry / Datadog のアラート連動や PR 自動レビューを Claude に任せたいチームリード
  • Hooks や GitHub Actions との役割分担を整理したい DevOps 担当者
  • Pro / Max プランで Routines を試す前に、日次上限やセキュリティ制約を確認したい方
Claude Code 公式ロゴ

出典: Anthropic Claude Code 公式

Claude Code Routines とは

Claude Code Routines は、プロンプト・リポジトリ・クラウド環境・コネクタ(MCP)・トリガーを一つにまとめて保存し、繰り返し自律実行できる仕組みです。一般的な Claude Code は開発者のローカル環境で動きますが、Routines は Anthropic 管理のクラウドインフラ上で動くため、cron ジョブを自前で用意したり MCP サーバーを常駐させたりする必要がありません。

現時点では Research Preview として提供されており、API の形状や日次上限などの仕様は今後変わる可能性があります。本番クリティカルな処理に組み込む際は、公式ドキュメントと管理画面で最新情報を確認したうえで採用してください。

従来の Claude Code との違い

観点

通常の Claude Code

Claude Code Routines

実行場所

開発者のローカルマシン

Anthropic 管理のクラウド

PC 依存

PC 起動・アプリ起動中のみ

PC 電源オフでも継続

起動方法

ターミナルで claude 実行

Schedule / API / GitHub Event

設定の保存

シェル履歴や手動メモ

1つの「ルーチン」として保存

セッション管理

都度新規

トリガー発火ごとに新規セッションを生成

承認プロンプト

ツール実行前に確認

承認プロンプトなし(完全自律)

「毎晩9時に Issue をトリアージ」「Sentry アラートが来たらスタックトレースを解析」「PR が開かれたらカスタムレビュー」といった、ローカルでは cron や Actions に逃がしていた処理をクラウドで完結させるための機能です。

3種類のトリガーの使い方

Claude Code Routines の3トリガーを表すスケジュール・自動化のイメージ

Routines は以下の3種類のトリガーを単独または組み合わせて設定できます。

トリガー

作成場所

主なユースケース

Schedule

Web / CLI / Desktop

定期バックログ整理、週次ドキュメント更新

API

Web UI のみ

アラート連動、CI/CD からのデプロイ検証

GitHub

Web UI のみ(GitHub App 必須)

PR レビュー、リリース後トリアージ

一つのルーチンに複数トリガーを紐付け可能で、たとえば「毎日9時」と「API 呼び出し時」の両方で同じプロンプトを実行することもできます。

1. Schedule(スケジュール)トリガー

プリセットで最も手軽に使えるトリガーです。hourly / daily / weekdays / weekly の4種類が用意されており、時刻はローカルタイムゾーンで入力すれば内部で UTC に変換されます。

Web UI での作成

  1. claude.ai/code/routines にアクセス
  2. 「New routine」をクリック
  3. プロンプト・リポジトリ・環境・コネクタを選択
  4. Triggers から「Schedule」を追加
  5. hourly / daily / weekdays / weekly から選択し、時刻を指定

CLI での作成

Claude Code の任意のセッション内で /schedule コマンドを実行します。自然言語で条件を書くと、そのままルーチンに変換されます。

# セッション内で実行
/schedule daily PR review at 9am

# 既存ルーチンの一覧
/schedule list

# cron 式の更新(カスタム頻度)
/schedule update <routine-id>

# 手動発火(テスト用)
/schedule run <routine-id>

CLI から作成できるのは Schedule トリガーのみです。API トリガー・GitHub トリガーは Web UI からのみ設定できます。

カスタム cron

プリセットでカバーできない頻度は cron 式で指定します。Web フォームで最寄りのプリセットを選んだ後、CLI の /schedule update で cron 式に上書きします。

  • 最小間隔は1時間。それ未満の cron 式(例: */30 * * * *)は拒否されます。
  • 実行はスケジュール時刻から数分ずれる(stagger)ことがありますが、同じルーチンのオフセットは一貫しています。

1回限り(one-off)実行の活用

Schedule トリガーには「特定タイムスタンプで1回だけ実行し、実行後に自動無効化する」one-off モードがあります。

重要なポイント: one-off 実行は日次上限にカウントされません。通常のサブスクリプション使用量として消費されるだけで、Pro の「5回/日」枠などを消費しません。「このリリースの翌朝9時にだけ自動チェックを走らせたい」といった用途で、日次上限を温存しながら使える手段です。

# 自然言語でone-off指定する例
/schedule in 2 weeks, open a cleanup PR that removes the feature flag
/schedule tomorrow at 9am, summarize yesterday's merged PRs

2. API トリガー

外部システムからルーチンを発火させるための HTTP エンドポイントが、ルーチンごとに発行されます。Sentry・Datadog のアラート、CD パイプライン、社内ダッシュボードなどから POST するユースケースが想定されています。

セットアップ手順(Web UI 限定)

  1. ルーチン詳細画面 → 「Add trigger」→「API」を選択
  2. 生成された Bearer トークンが1回だけ表示されるので、安全なシークレットストアに保管
  3. 表示された POST 先 URL を呼び出し元に設定

トークンを紛失した場合は Web UI から Regenerate(再発行)または Revoke(無効化) できます。CLI からは API トリガーの追加・トークン管理はできません。

curl での発火例

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."}'

trig_01ABCDEFGHJKLMNOPQRSTUVW は例示用 ID です。実際の ID は管理画面で確認してください。

必須ヘッダーは以下4つで、どれか1つでも欠けるとリクエストは拒否されます。

ヘッダー

Authorization

Bearer sk-ant-oat01-...(ルーチン専用トークン)

anthropic-beta

experimental-cc-routine-2026-04-01

anthropic-version

2023-06-01

Content-Type

application/json

anthropic-beta ヘッダーについて: このヘッダーは Research Preview 中のベータ機能を有効化するものです。仕様変更時は新しいバージョンのベータヘッダーが発行されますが、旧バージョンは移行猶予として直近2バージョンまで継続動作する方針です。

レスポンス形式

正常に受け付けられた場合、以下のような JSON が返ります。

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}

claude_code_session_url にアクセスすると、クラウドで走っている Claude Code のセッションをリアルタイムで確認できます。発火元システムでこの URL をログ出力しておくと、問題発生時のデバッグに役立ちます。

text フィールドの扱い

body の text フィールドは 自由記述の追加コンテキストとして扱われます。JSON オブジェクトを入れても単なる文字列としてプロンプトに渡されるため、構造化したい場合は「ラベル: 値」形式で書くのが実用的です。

{
  "text": "Alert: SEN-4521\nSeverity: critical\nService: checkout\nStack: NullPointerException at CartService.java:142"
}

3. GitHub トリガー

Pull request や Release イベントに応じてルーチンを起動するトリガーです。PR レビューやリリース後のリグレッション確認など、推論を伴う自動化に向きます。

前提条件

  • Claude GitHub App のインストールが必須です。/web-setup ではインストールされないので、Claude GitHub App から別途導入してください。
  • 組織アカウントでは管理者権限が必要になる場合があります。

対応イベント(2026年5月時点)

カテゴリ

イベント

Pull request

opened / closed / assigned / labeled / synchronized / edited

Release

created / published / edited / deleted

現時点では Pull request と Release のみサポートです。Issues などその他の webhook イベントは現在非対応ですが、公式ロードマップで拡張が予定されています。

フィルタ設定

PR 向けには以下のフィールドでフィルタが可能です。

  • Author / Title / Body / Base branch / Head branch / Labels / Is draft / Is merged

演算子は equals / contains / starts with / is one of / is not one of / matches regex の6種類。

matches regex の注意点: この演算子はフィールド値の全体をマッチ対象にします。hotfix というキーワードを含む PR タイトルに反応させたい場合、hotfix だけでは一致しません。.*hotfix.* のように前後にワイルドカードを付けて記述する必要があります。

フィルタを組み合わせる実例:

目的

フィールド

演算子

特定の Author の PR だけ

Author

is one of

bot, dependabot

ドラフトは除外

Is draft

equals

false

feature/ ブランチ向けの PR のみ

Base branch

starts with

feature/

hotfix 関連 PR に反応

Title

matches regex

.*hotfix.*

挙動の注意点

  • マッチしたイベントごとに独立した新規セッションが起動します。PR が短時間に複数更新されれば、その回数だけセッションが立ち上がります。
  • Research Preview 中は webhook の時間当たり上限がルーチン単位・アカウント単位で設けられており、超過分はウィンドウリセットまでドロップされます(キューイングなし)。上限の具体的な数値は公式では非公開のため、実運用時は管理画面で動作を確認してください。

作成・管理手段(Web UI・CLI・Desktop)

3つのサーフェスがあり、すべて同じクラウドアカウントに書き込むため設定は同期されます。

サーフェス

作成可能トリガー

向き

Web UI(claude.ai/code/routines

Schedule / API / GitHub すべて

初回セットアップ・API/GitHub 設定

CLI(/schedule

Schedule のみ

既存セッションから素早く定期実行を追加

Desktop アプリ(サイドバー「Routines」→「New remote task」)

Schedule / API / GitHub すべて

GUI で複数ルーチンを一覧管理

Desktop アプリで「New task」を選ぶ際、Local task を選ぶとローカル Desktop の scheduled task になり Routines とは別物になります。クラウドで動かしたい場合は必ず New remote task を選んでください。

ルーチンの構成要素

ルーチン1つは、以下5要素をまとめたパッケージです。

  1. プロンプト + モデルセレクタ — 毎回指定したモデルで実行
  2. リポジトリ — 実行ごとに default branch から clone。書き込みは claude/ プレフィックスブランチのみ(後述)
  3. クラウド環境 — ネットワークアクセスレベル・環境変数・セットアップスクリプト
  4. コネクタ(MCP) — 接続済み MCP コネクタが既定ですべて含まれる
  5. スキル — リポジトリの skills/ にコミットされたスキルを呼び出し可能

MCP・コネクタ設定の注意点

コネクタ(MCP)の扱いには2つの重要な制約があります。

ローカル MCP サーバーは使用不可: claude mcp add でローカルに追加した MCP サーバーは、クラウドで実行される Routines からは参照できません。Routines で外部サービスを使うには、claude.ai/customize/connectors でコネクタとして登録するか、リポジトリに .mcp.json としてコミットしてください。

コネクタのデフォルト全包含: 既定では、アカウントに登録済みのすべてのコネクタが Routines に含まれます。Slack への書き込み権限を持つコネクタが含まれたまま、想定外のチャネルへ通知が飛ぶといったトラブルを避けるために、不要なコネクタは明示的に除外してください。

MCP の仕組みについては「MCP(Model Context Protocol)とは」で詳しく解説しています。

プロンプト設計のベストプラクティス

Routines は承認プロンプトなしで完全自律実行されます。プロンプトの設計が甘いと、想定外の操作や無限ループが発生するリスクがあります。以下の原則を押さえてください。

「何をするか」と「成功基準」を明示する

曖昧なプロンプトは自律実行環境では特に危険です。

❌ 悪い例:
ラベルを整理してください。

✅ 良い例:
GitHubリポジトリのすべてのIssueを確認し、以下のルールでラベルを付与してください。
- バグ報告: label "bug"を付与
- 機能要望: label "enhancement"を付与
- 不明確なIssue: label "needs-triage"を付与し、コメントで追加情報を依頼

完了条件: ラベルなしのIssueが0件になること。
実行後、処理したIssue数と変更内容の要約をSlackの#dev-opsチャンネルに投稿してください。

権限境界を最初に決める

プロンプトに「やってよいこと」と「やってはいけないこと」を明記します。

権限範囲:
- OK: claude/triage-* ブランチへのプッシュ
- OK: Issueへのラベル付け・コメント投稿
- NG: main・develop ブランチへの直接プッシュ
- NG: Issueやプルリクエストのクローズ・削除

エラー時の挙動を指定する

自律実行中に外部APIが落ちている場合など、エラー時の処理を書いておかないと予期しない動作につながります。

エラー処理:
- GitHub APIが503を返した場合: 5分後に1回だけリトライ。それでも失敗したら処理を中断し、
  Slackの#dev-opsに「Routineが失敗しました: [エラー内容]」を投稿してください。
- 対象Issueが100件を超えた場合: 最初の50件のみ処理し、残りは翌日に持ち越してください。

テスト用プロンプトで動作確認

本番適用の前に、対象リポジトリをフォークしたテスト環境で同じルーチンを走らせて動作を確認することを強く推奨します。CLIの /schedule run <routine-id> でいつでも手動発火できます。

利用可能プランと日次実行数

Claude Code on the web が有効な claude.ai アカウントが必要です。Free プランでは利用できません。

プラン

月額料金

Routines

日次実行数(報道値)

Free

無料

Pro

$20

1日 5 ルーチン

Max 5x

$100

1日 15 ルーチン

Max 20x

$200

1日 15 ルーチン(要確認)

Team

$25/シート

1日 25 ルーチン

Enterprise

カスタム

1日 25 ルーチン

※ 日次上限の具体的数値は、2026年4月14日の発表時に報じられた値です。公式ドキュメントでは「daily run allowance が存在する」とのみ記載されており、厳密な数値は claude.ai/code/routinesclaude.ai/settings/usage で都度確認する前提になっています。

Team / Enterprise では管理者が Routines 全体を無効化できます(サーバー側設定のため、ユーザー側で上書き不可)。組織での導入前に管理者ポリシーを確認してください。

課金の考え方

  • Routines の実行は通常のサブスクリプション使用量に合算されます。別枠ではありません。
  • 対話型セッションと同様にトークンを消費するため、Routines を多用すると対話型の残量に影響します。
  • 1回限り(one-off)実行は日次上限にカウントされない点は前述の通りです(通常のサブスクリプション使用量として消費)。
  • 日次上限やプラン使用量上限に達した場合、「Settings > Billing」で extra usage(メーター課金のオーバーエッジ) を有効にしていれば継続実行が可能です。無効のままだとウィンドウがリセットされるまで実行は拒否されます。
  • 2026年5月6日のアップデート: Anthropic は全有料プランの Claude Code 5時間レート制限を2倍に引き上げ、Pro・Max のピーク時間帯スロットリングも廃止しました。Routines の実行枠も同様の恩恵を受けます。

料金設計の全体像は「Claude Code 料金プラン」で詳しく整理しています。

代表的なユースケース

Routinesで自動化する開発ワークフローのイメージ

公式ドキュメントで紹介されている活用例を、トリガー別に整理します。

用途

トリガー

概要

バックログメンテナンス

Schedule(毎晩)

Issue のラベル付け・アサイン・Slack サマリ送信

ドキュメントドリフト検出

Schedule(週次)

API 変更を検知し docs 更新 PR を自動作成

アラートトリアージ

API

Sentry / Datadog の閾値超過 → スタックトレース解析 → 修正 PR ドラフト

デプロイ検証

API

CD パイプラインから POST → スモークテスト → Slack へ go/no-go

カスタム PR レビュー

GitHub(PR opened)

チーム独自チェックリストを適用、インラインコメント投稿

ライブラリポート

GitHub(PR closed・merged)

1 SDK のマージを別言語 SDK へ自動ポート

実務では「API で任意の瞬間に発火」+「Schedule で定期監視」を1ルーチンに組み合わせると、手動実行と自動監視の両方をカバーできます。

Claude Code 全体の活用パターンは「Claude Code 活用事例」にまとめています。

他の自動化手段との使い分け

Routines が登場した後も、Hooks・GitHub Actions・/loop・Desktop scheduled tasks はそれぞれ異なる役割を持っています。目的に合わせて組み合わせるのが実務的です。

Claude Code Hooks との違い

観点

Claude Code Hooks

Claude Code Routines

実行場所

ローカルマシン

Anthropic 管理クラウド

起動タイミング

Claude Code ライフサイクルイベント(PreToolUse / PostToolUse / SessionStart / Stop)

Schedule / API / GitHub webhook

目的

決定論的なガードレール・フォーマット強制・監査ログ

自律的な繰り返し自動化

定義場所

~/.claude/settings.json などの JSON

Web UI / CLI の /schedule

セッション依存

アクティブセッション必須

セッション不要(クラウドで自走)

Hooks は「Claude Code セッション内のイベントに反応するローカルフック」なのに対し、Routines は「Claude Code セッション自体を外部トリガーから起動する仕組み」です。詳しくは「Claude Code Hooks 使い方」で解説しています。

GitHub Actions 連携との違い

観点

GitHub Actions 上の Claude Code

Claude Code Routines

実行インフラ

GitHub runner

Anthropic 管理クラウド

トリガー

GitHub Actions の全ワークフロートリガー

Schedule / API / GitHub event のみ

設定ファイル

.github/workflows/*.yml(Git 管理対象)

Web UI / CLI(Git 管理外)

向き

テスト・ビルド・デプロイなど決定論的 CI 処理

レビュー・要約・トリアージなど推論タスク

コスト

GitHub Actions 分 + Anthropic API 分

Claude サブスクリプション使用量のみ

両者は相補関係で、Actions でテストや Lint を回し、Routines で PR のリスク分析やサマリ生成を行うのが典型的な併用パターンです。GitHub Actions 上での Claude Code の使い方は「Claude Code GitHub Actions 使い方」で詳しく扱っています。

/loop・Desktop scheduled tasks との違い

機能

実行場所

持続性

主な用途

/loop(in-session)

ローカル CLI セッション内

セッション終了で停止、タスクは自動7日失効

「このデプロイを1時間監視」など一時的ウォッチ

Desktop scheduled tasks

ローカルマシン

PC 起動・アプリ起動中のみ

ローカルファイル操作を伴う定期タスク

Claude Code Routines

Anthropic クラウド

PC 電源オフでも継続

本番的な無人自動化

「数時間だけ走らせたい」なら /loop、「ローカルの特定ディレクトリを触るタスク」なら Desktop scheduled tasks、「PC を閉じても止まらない本番自動化」なら Routines という住み分けです。

セキュリティと運用上の注意点

APIトークンとブランチ保護を中心としたRoutinesのセキュリティ運用イメージ

Routines は承認プロンプトなしの完全自律実行なので、設計を誤ると想定外の操作が走る可能性があります。以下を最低限チェックしてください。

クラウド実行環境のセキュリティ設計

公式セキュリティドキュメントによると、Routines のクラウド実行は以下の構造で保護されています。

  • 分離された仮想マシン: 各クラウドセッションは独立した VM で実行され、セッション間で環境が共有されません。
  • ネットワークアクセス制限: デフォルト(Trusted モード)では、パッケージレジストリ・主要クラウドプロバイダー API などのホワイトリスト内のみ許可。社内エンドポイントへのアクセスが必要な場合は「Custom」から追加します。
  • 認証はスコープ付きプロキシ経由: Anthropic のセキュアプロキシ経由で認証され、直接の認証情報露出を避ける設計です。
  • セッション後の自動クリーンアップ: 実行完了後にクラウド環境は自動削除されます。
  • 全操作の監査ログ記録: すべての操作が記録されます。

ブランチ保護の扱い

  • リポジトリへの書き込みは claude/ プレフィックスのブランチのみに制限されるのが既定です。
  • Allow unrestricted branch pushes を明示的に有効化すると任意ブランチへ push 可能になりますが、本番ブランチへの直 push を許可することになるため有効化は慎重に。

API トークンの管理

  • API トリガーのトークンは 生成時に1回だけ表示されます。画面を閉じると再表示不可なので、シークレットマネージャに即座に保存してください。
  • 漏洩時は Web UI から Regenerate または Revoke で即時無効化します。
  • CLI からはトークン発行・再発行ができないため、トークン管理は Web UI に一本化する運用ルールにするのが安全です。

連携アカウント名義での動作

  • Routines 実行中の GitHub コミット・PR・Slack メッセージ・Linear Issue 操作は、接続した個人アカウント名義で発生します。
  • ルーチン自体も個人 claude.ai アカウントに紐づき、日次枠も個人アカウントの枠を消費します。チームメイトとの直接共有はできません。

コネクタ・環境の最小権限

  • 既定では接続済みコネクタ(MCP)がすべて含まれます。不要なコネクタは削除して権限範囲を絞り込みましょう。
  • MCP コネクタのトラフィックは Anthropic サーバー経由のため、Allowed domains への追加は不要です。

実運用で起きやすい事故パターン

実録記事から報告されている事故事例です。事前に対策を把握しておいてください。

事故パターン

対策

テスト用ルーティンの削除忘れで想定外の課金

ルーチン一覧を週次で棚卸し、不要なものを削除する

GitHubイベントトリガーの連続発火(15件/2分など)→ Slack 通知暴走

フィルタ条件を絞り込み、テスト環境で発火頻度を事前確認

同一ルーティンの2重登録による重複実行

名前に作成日を入れてダブリを防ぐ

extra usage 有効のまま放置して請求が増大

本番導入前に extra usage の有効・無効を意図的に設定する

緊急停止手順: Web UI のルーチン詳細画面から「Disable」または「Delete」で即時停止できます。CLI では /schedule update <routine-id> でトリガーを削除できます。

Research Preview としての注意

  • API の形状(リクエスト・レスポンス・トークンセマンティクス)は変更される可能性があります。後方互換は直近2バージョンまで保証される方針です。
  • 日次キャップの具体値は公式非公開なので、管理画面で必ず確認してください。
  • 実行時間の正式な上限・webhook の時間当たり上限の具体的数値は、執筆時点で公式に明記されていません。

Claude Code 全体のセキュリティ運用は「Claude Code セキュリティ 安全な使い方」で整理しています。

こんな方におすすめ

  • PC を閉じた状態でも Claude Code にタスクを走らせたい人
  • Sentry・Datadog のアラート → Claude による初動解析を自動化したいチーム
  • PR レビューで推論を伴うチェック(ロジック穴探し、仕様との整合性)を Claude に任せたいチームリード
  • cron ジョブや MCP サーバーの運用を減らしたい DevOps 担当者
  • 既に Pro / Max / Team / Enterprise プランを契約済みで、追加課金を避けつつ自動化を拡張したい人

おすすめしない方

  • Free プランを利用中の方(Routines は利用不可)
  • PC 常時起動環境で、ローカルのファイル操作を自動化したい方 — Desktop scheduled tasks の方が適しています
  • 決定論的な CI / CD 処理(テスト・ビルド・デプロイ)を自動化したい方 — GitHub Actions や既存 CI の方が信頼性・再現性で有利
  • 数秒〜数十分間隔での高頻度監視が必要な方 — Routines は最小間隔が1時間。短い間隔のウォッチには /loop や専用の監視ツールを使うべき
  • 本番で完全に止められない自動化を組みたい方 — Research Preview 中のため、仕様変更や一時的な制限の影響を受ける可能性があります

よくある質問(FAQ)

Q1. Pro プランでも API トリガー・GitHub トリガーは使えますか?

現時点では Pro / Max / Team / Enterprise すべてで3トリガーが利用可能と公式ドキュメントから読み取れます。ただし日次実行数はプランごとに異なる(Pro は1日5ルーチン、Max は15、Team・Enterprise は25)ため、トリガー数よりも実行回数の上限で Pro の利用可能範囲が決まる形です。最新値は管理画面で確認してください。

Q2. 1時間より短い間隔で走らせる方法はありますか?

Routines の最小間隔は1時間で、それ未満の cron 式は拒否されます。15分おきに走らせたいような場合は以下を検討してください。

  • /loop(アクティブセッション内で短いウォッチをかける)
  • 外部 cron / CI から API トリガーを高頻度で叩く(ただし webhook 時間当たり上限の影響を受ける可能性あり)
  • GitHub Actions の schedule イベント(5分間隔〜)で走らせたうえで、推論部分のみ API トリガー経由で Claude に渡す

Q3. ルーチンをチームで共有できますか?

Research Preview 時点では個人 claude.ai アカウントに紐づく仕様で、チームメイトへの直接共有はできません。チームで同じ処理を走らせたい場合、同じプロンプト・リポジトリ設定を各自が作る運用になります。将来的な共有機能については公式の続報を待つ必要があります。

Q4. 1回限り実行は日次上限にカウントされますか?

カウントされません。 one-off 実行は通常のサブスクリプション使用量として消費されますが、Pro の「5回/日」などの日次 Routines 上限には含まれません。日次枠を節約しながら、特定イベントに合わせた単発実行を行う用途に活用できます。

Q5. 実行ログはどこで確認できますか?

各ルーチンの実行履歴は Web UI のルーチン詳細画面、および個別セッション URL(https://claude.ai/code/session_...)から確認できます。API トリガーのレスポンスに含まれる claude_code_session_url をログ出力しておくと、発火元システムから実行詳細へ直接ジャンプできて便利です。

Q6. トークンをうっかり GitHub にコミットしてしまった場合は?

即座に Web UI から Revoke(無効化) してください。その後 Regenerate(再発行) し、新しいトークンをシークレットマネージャに登録し直します。既に外部に漏れたトークンは Revoke しない限り有効なので、対応スピードが重要です。

Q7. 日次上限に達したらどうなりますか?

「Settings > Billing」の extra usage(メーター課金のオーバーエッジ) が有効なら、上限超過後も実行が続きます。無効のままだと、日次ウィンドウがリセットされるまで実行は拒否されます。本番用途で使う場合は、意図せず止まらないように extra usage の設定を事前に確認しておくと安心です。

Q8. ルーチンが実行されない場合の診断フローは?

以下の順で確認してください。

  1. 組織ポリシーの確認: Team / Enterprise の場合、管理者が Routines を無効化しているケースがあります。管理者に問い合わせてください。
  2. GitHub App のインストール確認: GitHub トリガーが動かない場合は、Claude GitHub App がリポジトリにインストールされているか確認してください。
  3. フィルタ条件の確認: GitHub トリガーで「反応しない」場合、フィルタの条件(特に matches regex の全体一致)が意図通りか見直してください。
  4. 日次上限の確認: Schedule トリガーが実行されない場合、日次上限に達していないか claude.ai/settings/usage で確認してください。
  5. ネットワークアクセス設定: 社内エンドポイントへのアクセスが必要な場合、クラウド環境の「Custom」でドメインを追加しているか確認してください。
  6. ルーチンの有効/無効状態: Web UI でルーチンが「Enabled」になっているか確認してください。

まとめ

Claude Code Routines は、Claude Code を Anthropic 管理クラウドで自律実行させ、Schedule・API・GitHub Event の3トリガーからタスクを走らせる Research Preview 機能です。

  • 従来の Claude Code との違いは「PC を閉じても動く」「承認プロンプトなしで自律実行」「1つのルーチンとして保存・再利用できる」の3点
  • 3トリガーのうち API と GitHub は Web UI 限定、Schedule は CLI でも作成可能
  • one-off 実行は日次上限にカウントされないため、特定タイムスタンプの単発処理に活用可能
  • プロンプト設計では「何をするか」「成功基準」「権限境界」「エラー時の挙動」を明示することが自律実行の安全性を左右する
  • Pro / Max / Team / Enterprise で利用可能、日次実行数は報道値で Pro 5 / Max 15 / Team・Enterprise 25(最新は管理画面で要確認)
  • 2026年5月6日のアップデートで Claude Code の5時間レート制限が2倍に。ピーク時間帯スロットリングも廃止
  • Hooks は決定論的ガードレール、GitHub Actions は CI、/loop は短期監視、Routines は無人自動化という棲み分けで組み合わせるのが実務的
  • セキュリティ面では claude/ プレフィックスブランチ制約・トークン1回表示・個人アカウント名義実行に注意

Research Preview 中は仕様変更の可能性があるため、本番クリティカルな依存は段階的に組み込み、管理画面と公式ドキュメントで最新情報を継続的に確認することを推奨します。


Claude Code の全体像からセキュリティ・料金まで、関連トピックは以下の記事でさらに深掘りできます。

この記事の著者

AI革命

AI革命

編集部

AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。

AI活用ならAI革命にお任せ。サービスを見てみる
AI Revolution Growth Arrow

AIでビジネスを革新しませんか?

あなたのビジネスにAIがどのような価値をもたらすかをご提案いたします。