Claude Code Analytics API

Claude Code Analytics Admin APIは、Claude Codeユーザーの日次集計された使用状況メトリクスへのプログラムによるアクセスを提供し、組織が開発者の生産性を分析し、カスタムダッシュボードを構築できるようにします。このAPIは、OpenTelemetry統合の複雑さなしに、基本的なAnalyticsダッシュボードよりも詳細な情報を提供します。

このAPIにより、Claude Codeの導入状況をより適切に監視、分析、最適化できます。

• 開発者の生産性分析： Claude Codeを使用したセッション数、追加/削除されたコード行数、コミット数、作成されたプルリクエスト数を追跡します
• ツール使用メトリクス： さまざまなClaude Codeツール（Edit、MultiEdit、Write、NotebookEdit）の承認率と拒否率を監視します
• コスト分析： Claudeモデルごとに分類された推定コストとトークン使用量を表示します
• カスタムレポート： データをエクスポートして、経営陣向けのエグゼクティブダッシュボードやレポートを構築します
• 使用の正当化： 社内でのClaude Code導入を正当化し拡大するためのメトリクスを提供します

クイックスタート

特定の日の組織のClaude Code分析を取得します。

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

Claude Code Analytics API

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

主要な概念

• 日次集計： starting_atパラメータで指定された1日分のメトリクスを返します
• ユーザーレベルのデータ： 各レコードは、指定された日の1人のユーザーのアクティビティを表します
• 生産性メトリクス： セッション数、コード行数、コミット数、プルリクエスト数、ツール使用を追跡します
• トークンとコストのデータ： Claudeモデルごとに分類された使用量と推定コストを監視します
• カーソルベースのページネーション： 不透明なカーソルを使用した安定したページネーションで大規模なデータセットを処理します
• データの鮮度： 一貫性のため、メトリクスは最大1時間の遅延で利用可能になります

パラメータの詳細とレスポンススキーマの全容については、Claude Code Analytics APIリファレンスを参照してください。

基本的な例

特定の日の分析を取得する

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

ページネーションを使用して分析を取得する

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

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

リクエストパラメータ

利用可能なメトリクス

各レスポンスレコードには、1人のユーザーの1日分について以下のメトリクスが含まれます。

ディメンション

• 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-opus-5）
• tokens.input/output： このモデルの入力および出力トークン数
• tokens.cache_read/cache_creation： このモデルのキャッシュ関連のトークン使用量
• estimated_cost.amount： このモデルの推定コスト（米ドルのセント単位）
• estimated_cost.currency： コスト金額の通貨コード（現在は常にUSD）

レスポンス構造

APIは以下の形式でデータを返します。

{
  "data": [
    {
      "date": "2025-09-08T00: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-opus-5",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 141
          }
        }
      ]
    }
  ],
  "has_more": false,
  "next_page": null
}

ページネーション

このAPIは、多数のユーザーを持つ組織向けにカーソルベースのページネーションをサポートしています。

1. オプションのlimitパラメータを指定して最初のリクエストを行います。
2. レスポンスのhas_moreがtrueの場合、次のリクエストでnext_pageの値を使用します。
3. has_moreがfalseになるまで続けます。

カーソルは最後のレコードの位置をエンコードしており、新しいデータが到着しても安定したページネーションを保証します。各ページネーションセッションは一貫したデータ境界を維持するため、レコードの取りこぼしや重複が発生しません。

一般的なユースケース

• エグゼクティブダッシュボード： Claude Codeが開発速度に与える影響を示す概要レポートを作成します
• AIツールの比較： メトリクスをエクスポートして、Claude CodeをCopilotやCursorなどの他のAIコーディングツールと比較します
• 開発者の生産性分析： 個人およびチームの生産性メトリクスを時系列で追跡します
• コストの追跡と配分： 支出パターンを監視し、チームまたはプロジェクトごとにコストを配分します
• 導入状況の監視： どのチームやユーザーが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）によるものか、subscription顧客（Pro/Teamプラン）によるものかを示します。

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

過去のClaude Code分析データは保持され、APIを通じてアクセスできます。このデータには指定された削除期間はありません。

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

このAPIはClaude API上でのClaude Codeの使用のみを追跡します。Claude in Amazon Bedrock、Claude in Microsoft Foundry、Claude on Google Cloud、またはClaude Platform on AWSを通じた使用は含まれません。

この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は、チームの開発ワークフローを理解し最適化するのに役立ちます。関連機能の詳細については以下を参照してください。

• Admin API
• Admin APIリファレンス
• Claude Code Analyticsダッシュボード
• Usage and Cost API - すべてのAnthropicサービスにわたるAPI使用状況を追跡します
• Compliance API - 監査およびアクティビティデータを取得します
• IDとアクセス管理
• カスタムメトリクスとアラートのためのOpenTelemetryによる使用状況の監視