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セッションを開始する必要がある内部ツールです。

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

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

すべてのリクエストにはanthropic-beta: experimental-cc-routine-2026-04-01ヘッダーを含める必要があります。これがないリクエストは400 invalid_request_errorを返します。

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

- 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 "anthropic-beta: experimental-cc-routine-2026-04-01" \
      -H "Content-Type: application/json" \
      -d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"

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

ヘッダー

パスパラメータ

リクエストボディ

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

レスポンス

成功したリクエストは、新しいセッションの詳細とともに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呼び出し元が再試行すると、エンドポイントは複数のセッションを作成します。

レート制限

ルーティン実行は、プランによって異なるアカウントごとの1日の割り当てにカウントされ、結果として得られるセッションは、インタラクティブセッションと同じClaude Codeサブスクリプション使用量を消費します。いずれかの制限に達すると、エンドポイントはRetry-Afterヘッダーとともに429 rate_limit_errorを返します。追加使用量が有効になっている組織は、従量制の超過分で含まれる割り当てを超えて継続します。

残りの1日の実行回数はclaude.ai/code/routinesで確認できます。ルーティンの使用量がサブスクリプション制限および追加使用量の課金とどのように相互作用するかについては、Claude CodeドキュメントのUsage and limitsを参照してください。

SDKサポート

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

関連項目

• Claude CodeドキュメントのAutomate work with routines
• ベータヘッダー
• エラー