API経由でルーティンをトリガーする

Claude CodeはAnthropicのエージェント型コーディングツールです。Claude Code on the webは、claude.ai/codeでAnthropic管理のクラウドインフラストラクチャ上でClaude Codeセッションを実行し、ルーティンはそこに保存された設定です。プロンプト、1つ以上のリポジトリ、コネクタをパッケージ化したもので、スケジュールに従って、GitHubイベントに応答して、またはHTTP経由で呼び出されたときに無人で実行できます。

このエンドポイントはHTTPのエントリポイントです。これにPOSTすると、既存のルーティンの新しい実行が開始され、結果として得られるセッションIDとURLが返されます。典型的な呼び出し元は、アラートシステム、CIパイプライン、およびプログラムでClaude Codeセッションを開始する必要がある内部ツールです。

このエンドポイントを呼び出すには、Pro、Max、Team、またはEnterpriseプランのclaude.aiアカウントで、Claude Code on the webが有効になっている必要があります。認証には、Claude APIキーではなく、Claude CodeのWeb UIで作成したルーティンごとの「bearer token」（ベアラートークン）を使用します。

Claude Platformとの違い

ルーティン発火エンドポイントはClaude Code製品サーフェスに属しており、いくつかの点でClaude PlatformのAPIおよびSDKとは異なります。

始める前に

このエンドポイントを呼び出すには、以下が必要です。

1. claude.ai/code/routinesで作成されたルーティン。
2. そのルーティン用に生成されたベアラートークン。ルーティンを編集用に開き、Select a triggerの下のAdd another triggerをクリックし、APIを選択してから、モーダルウィンドウでGenerate tokenをクリックします。トークンは一度だけ表示され、後で取得することはできません。

完全なセットアップの手順については、Claude CodeドキュメントのAdd an API triggerを参照してください。

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

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

Claude CodeのWeb UIは、APIトリガーを追加するときにトークンとともに完全なURLを提供するため、ほとんどの統合では両方をシークレットとして保存し、エンドポイントを直接呼び出します。次の例は、シェル呼び出しと、CI失敗時にルーティンをトリガーするGitHub Actionsステップを示しています。

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 "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

- if: failure()
  env:
    ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
    ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
  run: |
    curl -X POST "$ROUTINE_FIRE_URL" \
      -H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
      -H "anthropic-version: 2023-06-01" \
      -H "Content-Type: application/json" \
      -d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"

リクエストはセッションが作成されると返されます。セッション出力をストリーミングしたり、セッションの完了を待機したりすることはありません。

ヘッダー

anthropic-beta: experimental-cc-routine-2026-04-01ヘッダーを送信する既存の統合は影響を受けません。エンドポイントは、このヘッダーの有無にかかわらずリクエストを受け付けます。

パスパラメータ

リクエストボディ

ボディはオプションです。ボディ内の不明なフィールドは無視されます。

レスポンス

成功したリクエストは、新しいセッションの詳細とともに200 OKを返します。

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

エラー

エラーは標準のAnthropic エラーエンベロープを使用します。

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "<string>"
  }
}

認証

ベアラートークンは単一のルーティンにスコープされています。侵害されたトークンはそのルーティンをトリガーすることしかできません。読み取りアクセス、他のルーティンへのアクセス、アカウントデータへのアクセスは付与されません。

claude.ai/code/routinesのルーティンのAPIトリガー設定からトークンを生成および取り消します。トークン管理用の公開APIはありません。新しいトークンを生成すると、以前のトークンが取り消されます。

冪等性

成功した各リクエストは新しいセッションを作成します。冪等性キーはありません。Webhook呼び出し元が再試行すると、エンドポイントは複数のセッションを作成します。

レート制限

APIによる実行は1時間あたりの回数が制限されています。各ルーティンは1時間あたり最大30回の実行を受け付け（API経由の実行、Web UIのRun nowボタン、および単発の再設定で共有されます）、各アカウントはすべてのルーティンを合わせて1時間あたり最大100回のAPI実行を行えます。作成されたセッションは、対話型セッションと同じClaude Codeサブスクリプションの使用量を消費します。上限に達すると、エンドポイントはRetry-Afterヘッダーとともに429 rate_limit_errorを返します。

ルーティンの使用量がサブスクリプションの上限や追加使用量の課金とどのように関係するかについては、Claude Codeドキュメントの使用量と上限を参照してください。

SDKサポート

このエンドポイントはAnthropic SDKには含まれていません。そのトークンモデルはAPIキー認証とは異なり、CIジョブやアラートWebhookなどの典型的な呼び出し元はリクエストを直接送信します。

関連項目

• Claude Codeドキュメントのルーティンで作業を自動化する
• エラー