The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Claude Code Analytics Admin APIは、Claude Codeユーザーの日次集計使用メトリクスへのプログラム的アクセスを提供し、組織が開発者の生産性を分析し、カスタムダッシュボードを構築できるようにします。このAPIは、基本的なAnalyticsダッシュボードと複雑なOpenTelemetry統合の間のギャップを埋めます。 このAPIにより、Claude Codeの採用をより良く監視、分析、最適化できます：
  • 開発者生産性分析： Claude Codeを使用したセッション、追加/削除されたコード行数、コミット、プルリクエストの作成を追跡
  • ツール使用メトリクス： 異なるClaude Codeツール（Edit、MultiEdit、Write、NotebookEdit）の受諾率と拒否率を監視
  • コスト分析： Claudeモデル別に分類された推定コストとトークン使用量を表示
  • カスタムレポート： データをエクスポートして、経営陣向けのエグゼクティブダッシュボードとレポートを構築
  • 使用状況の正当化： 社内でClaude Codeの採用を正当化し拡大するためのメトリクスを提供
Admin APIキーが必要このAPIはAdmin APIの一部です。これらのエンドポイントには、標準のAPIキーとは異なるAdmin APIキー（sk-ant-admin...で始まる）が必要です。管理者ロールを持つ組織メンバーのみが、Anthropic Consoleを通じてAdmin APIキーをプロビジョニングできます。

​
クイックスタート

特定の日の組織のClaude Code分析を取得： 
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
統合にはUser-Agentヘッダーを設定統合を構築している場合は、使用パターンを理解するためにUser-Agentヘッダーを設定してください：
User-Agent: YourApp/1.0.0 (https://yourapp.com)

​
Claude Code Analytics API

/v1/organizations/usage_report/claude_codeエンドポイントを使用して、組織全体のClaude Code使用状況、生産性メトリクス、開発者活動を追跡します。

​
主要概念

  • 日次集計: starting_atパラメータで指定された単一日のメトリクスを返す
  • ユーザーレベルデータ: 各レコードは指定された日の1人のユーザーの活動を表す
  • 生産性メトリクス: セッション、コード行数、コミット、プルリクエスト、ツール使用を追跡
  • トークンとコストデータ: Claudeモデル別に分類された使用量と推定コストを監視
  • カーソルベースのページネーション: 不透明なカーソルを使用した安定したページネーションで大きなデータセットを処理
  • データの新鮮さ: 一貫性のため最大1時間の遅延でメトリクスが利用可能
完全なパラメータの詳細とレスポンススキーマについては、Claude Code Analytics APIリファレンスを参照してください。

​
基本例

​
特定の日の分析を取得

curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
ページネーション付きで分析を取得

# 最初のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# レスポンスからのカーソルを使用した後続のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
リクエストパラメータ

パラメータタイプ必須説明
starting_atstringはいYYYY-MM-DD形式のUTC日付。この単一日のメトリクスのみを返す
limitintegerいいえページあたりのレコード数（デフォルト：20、最大：1000）
pagestringいいえ前のレスポンスのnext_pageフィールドからの不透明なカーソルトークン

​
利用可能なメトリクス

各レスポンスレコードには、単一日の単一ユーザーに対する以下のメトリクスが含まれます：

​
ディメンション

  • date: RFC 3339形式の日付（UTCタイムスタンプ）
  • actor: Claude Codeアクションを実行したユーザーまたはAPIキー（email_addressを持つuser_actorまたはapi_key_nameを持つapi_actorのいずれか）
  • organization_id: 組織UUID
  • customer_type: 顧客アカウントのタイプ（APIカスタマーの場合はapi、Pro/Teamカスタマーの場合はsubscription）
  • terminal_type: Claude Codeが使用されたターミナルまたは環境のタイプ（例：vscode、iTerm.app、tmux）

​
コアメトリクス

  • num_sessions: このアクターによって開始されたClaude Codeセッションの個別数
  • lines_of_code.added: Claude Codeによってすべてのファイルに追加されたコード行の総数
  • lines_of_code.removed: Claude Codeによってすべてのファイルから削除されたコード行の総数
  • commits_by_claude_code: Claude Codeのコミット機能を通じて作成されたgitコミット数
  • pull_requests_by_claude_code: Claude CodeのPR機能を通じて作成されたプルリクエスト数

​
ツールアクションメトリクス

ツールタイプ別のツールアクション受諾率と拒否率の内訳：
  • edit_tool.accepted/rejected: ユーザーが受諾/拒否したEditツール提案の数
  • multi_edit_tool.accepted/rejected: ユーザーが受諾/拒否したMultiEditツール提案の数
  • write_tool.accepted/rejected: ユーザーが受諾/拒否したWriteツール提案の数
  • notebook_edit_tool.accepted/rejected: ユーザーが受諾/拒否したNotebookEditツール提案の数

​
モデル内訳

使用された各Claudeモデルについて：
  • model: Claudeモデル識別子（例：claude-3-5-sonnet-20241022）
  • tokens.input/output: このモデルの入力および出力トークン数
  • tokens.cache_read/cache_creation: このモデルのキャッシュ関連トークン使用量
  • estimated_cost.amount: このモデルの推定コスト（セント単位USD）
  • estimated_cost.currency: コスト金額の通貨コード（現在は常にUSD）

​
レスポンス構造

APIは以下の形式でデータを返します： 
{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "developer@company.com"
      },
      "organization_id": "dc9f6c26-b22c-4831-8d01-0446bada88f1",
      "customer_type": "api",
      "terminal_type": "vscode",
      "core_metrics": {
        "num_sessions": 5,
        "lines_of_code": {
          "added": 1543,
          "removed": 892
        },
        "commits_by_claude_code": 12,
        "pull_requests_by_claude_code": 2
      },
      "tool_actions": {
        "edit_tool": {
          "accepted": 45,
          "rejected": 5
        },
        "multi_edit_tool": {
          "accepted": 12,
          "rejected": 2
        },
        "write_tool": {
          "accepted": 8,
          "rejected": 1
        },
        "notebook_edit_tool": {
          "accepted": 3,
          "rejected": 0
        }
      },
      "model_breakdown": [
        {
          "model": "claude-3-5-sonnet-20241022",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

​
ページネーション

APIは多数のユーザーを持つ組織向けにカーソルベースのページネーションをサポートします：
  1. オプションのlimitパラメータで初回リクエストを行う
  2. レスポンスでhas_moreがtrueの場合、次のリクエストでnext_page値を使用
  3. has_moreがfalseになるまで続行
カーソルは最後のレコードの位置をエンコードし、新しいデータが到着しても安定したページネーションを保証します。各ページネーションセッションは一貫したデータ境界を維持し、レコードの欠落や重複を防ぎます。

​
一般的な使用例

  • エグゼクティブダッシュボード: 開発速度に対するClaude Codeの影響を示すハイレベルレポートを作成
  • AIツール比較: CopilotやCursorなどの他のAIコーディングツールとClaude Codeを比較するためのメトリクスをエクスポート
  • 開発者生産性分析: 個人およびチームの生産性メトリクスを時系列で追跡
  • コスト追跡と配分: 支出パターンを監視し、チームまたはプロジェクト別にコストを配分
  • 採用監視: どのチームとユーザーがClaude Codeから最も価値を得ているかを特定
  • ROI正当化: Claude Codeの採用を正当化し社内で拡大するための具体的なメトリクスを提供

​
よくある質問

​
分析データはどの程度新鮮ですか？

Claude Code分析データは通常、ユーザー活動完了から1時間以内に表示されます。一貫したページネーション結果を保証するため、1時間より古いデータのみがレスポンスに含まれます。

​
リアルタイムメトリクスを取得できますか？

いいえ、このAPIは日次集計メトリクスのみを提供します。リアルタイム監視については、OpenTelemetry統合の使用を検討してください。

​
データ内でユーザーはどのように識別されますか？

ユーザーはactorフィールドを通じて2つの方法で識別されます：
  • user_actor: OAuth経由で認証するユーザーのemail_addressを含む（最も一般的）
  • api_actor: APIキー経由で認証するユーザーのapi_key_nameを含む
customer_typeフィールドは、使用量がapiカスタマー（API PAYG）からかsubscriptionカスタマー（Pro/Teamプラン）からかを示します。

​
データ保持期間はどのくらいですか？

過去のClaude Code分析データは保持され、API経由でアクセス可能です。このデータに対する指定された削除期間はありません。

​
どのClaude Codeデプロイメントがサポートされていますか？

このAPIはAnthropic API（1st party）でのClaude Code使用のみを追跡します。Amazon Bedrock、Google Vertex AI、またはその他のサードパーティプラットフォームでの使用は含まれません。

​
このAPIの使用にはどのくらいのコストがかかりますか？

Claude Code Analytics APIは、Admin APIへのアクセス権を持つすべての組織で無料で使用できます。

​
ツール受諾率はどのように計算しますか？

ツール受諾率 = 各ツールタイプのaccepted / (accepted + rejected)。例えば、editツールが45受諾、5拒否を示している場合、受諾率は90%です。

​
dateパラメータにはどのタイムゾーンが使用されますか？

すべての日付はUTCです。starting_atパラメータはYYYY-MM-DD形式で、その日のUTC午前0時を表します。

​
関連項目

Claude Code Analytics APIは、チームの開発ワークフローを理解し最適化するのに役立ちます。関連機能について詳しく学ぶ：