Claude Code Analytics API

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_at`	string	はい	YYYY-MM-DD形式のUTC日付。この単一日のメトリクスのみを返す
`limit`	integer	いいえ	ページあたりのレコード数（デフォルト：20、最大：1000）
`page`	string	いいえ	前のレスポンスの`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は多数のユーザーを持つ組織向けにカーソルベースのページネーションをサポートします：

オプションのlimitパラメータで初回リクエストを行う
レスポンスでhas_moreがtrueの場合、次のリクエストでnext_page値を使用
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時を表します。

APIの使用

APIリファレンス

SDK

例

サードパーティAPI

Admin APIの使用

サポートと設定

Claude Code Analytics API

クイックスタート

Claude Code Analytics API

主要概念

基本例

特定の日の分析を取得

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

リクエストパラメータ

利用可能なメトリクス

ディメンション

コアメトリクス

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

モデル内訳

レスポンス構造

ページネーション

一般的な使用例

よくある質問

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

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

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

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

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

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

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

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

関連項目

APIの使用

APIリファレンス

SDK

例

サードパーティAPI

Admin APIの使用

サポートと設定

​クイックスタート

​Claude Code Analytics API

​主要概念

​基本例

​特定の日の分析を取得

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

​リクエストパラメータ

​利用可能なメトリクス

​ディメンション

​コアメトリクス

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

​モデル内訳

​レスポンス構造

​ページネーション

​一般的な使用例

​よくある質問

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

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

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

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

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

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

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

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

​関連項目

クイックスタート

Claude Code Analytics API

主要概念

基本例

特定の日の分析を取得

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

リクエストパラメータ

利用可能なメトリクス

ディメンション

コアメトリクス

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

モデル内訳

レスポンス構造

ページネーション

一般的な使用例

よくある質問

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

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

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

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

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

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

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

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

関連項目