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、Write、NotebookEdit）の受け入れ率と拒否率を監視します
コスト分析： Claude Codeモデル別に分類された推定コストとトークン使用量を表示します
カスタムレポート： データをエクスポートして、経営チーム向けのエグゼクティブダッシュボードとレポートを構築します
使用状況の正当化： Claude Code導入を社内で正当化し、拡大するためのメトリクスを提供します

Admin APIキーが必要です

このAPIはAdmin APIの一部です。これらのエンドポイントには、標準APIキーと異なるAdmin APIキー（sk-ant-admin...で始まる）が必要です。管理者ロールを持つ組織メンバーのみが、Claude 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 Codeモデル別に分類された使用状況と推定コストを監視します
カーソルベースのページネーション: 不透明なカーソルを使用した安定したページネーションで大規模なデータセットを処理します
データの鮮度: メトリクスは一貫性を確保するため、最大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ツール提案の数
write_tool.accepted/rejected: ユーザーが受け入れた/拒否したWriteツール提案の数
notebook_edit_tool.accepted/rejected: ユーザーが受け入れた/拒否したNotebookEditツール提案の数

モデル別内訳

使用された各Claudeモデルについて：

model: Claudeモデル識別子（例：claude-sonnet-4-5-20250929）
tokens.input/output: このモデルの入力および出力トークンカウント
tokens.cache_read/cache_creation: このモデルのキャッシュ関連トークン使用量
estimated_cost.amount: このモデルの推定コスト（米ドルセント）
estimated_cost.currency: コスト金額の通貨コード（現在は常にUSD）

レスポンス構造

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

{
  "data": [
    {
      "date": "2025-09-01T00:00:00Z",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]"
      },
      "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-sonnet-4-5-20250929",
          "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ツール比較: メトリクスをエクスポートして、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 PAYG）からのapiか、Pro/Teamプランからのsubscriptionかを示します。

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

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

どのClaude Code展開がサポートされていますか？

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

このAPIを使用するのにコストはかかりますか？

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

ツール受け入れ率を計算するにはどうすればよいですか？

ツール受け入れ率 = accepted / (accepted + rejected)（各ツールタイプ）。たとえば、編集ツールが45件の受け入れと5件の拒否を示している場合、受け入れ率は90％です。

dateパラメータに使用されるタイムゾーンは何ですか？

すべての日付はUTCです。starting_atパラメータはYYYY-MM-DD形式である必要があり、その日のUTC真夜中を表します。

クイックスタート

Claude Code Analytics API

主要な概念

基本的な例

特定の日付の分析を取得

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

リクエストパラメータ

利用可能なメトリクス

ディメンション

コアメトリクス

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

モデル別内訳

レスポンス構造

ページネーション

一般的なユースケース

よくある質問

分析データはどのくらい新しいですか？

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

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

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

どのClaude Code展開がサポートされていますか？

このAPIを使用するのにコストはかかりますか？

ツール受け入れ率を計算するにはどうすればよいですか？

dateパラメータに使用されるタイムゾーンは何ですか？

関連項目