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

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

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

このエンドポイントを呼び出すには、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ドキュメントのAPIトリガーの追加を参照してください。



ルーチンをトリガーする

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ドキュメントの使用量と制限を参照してください。



SDKサポート

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



関連項目

• Claude Codeドキュメントのルーチンで作業を自動化する
• ベータヘッダー
• エラー