Claude Analytics API群の使い分け
Claude Code Analytics APIとClaude Enterprise Analytics APIは別物のAPI。対象組織・キー種別・データの鮮度が違う2つを、組織形態から選ぶ基準で整理する。
AnthropicのAnalytics APIは2種類ある
Anthropicは分析用のAPIを2本提供しています。名前が似ているため混同されがちですが、対象組織もキー種別も別物です。
- Claude Code Analytics API: Claude Platformを使う組織向けに、Claude Codeの日次生産性指標を返す。Admin APIの一部で、Admin APIキーを使う
- Claude Enterprise Analytics API: Claude Enterprise組織向けに、chat・projects・Claude Codeなど製品横断のエンゲージメント・アダプション・コストデータを返す。専用のAnalytics APIキーを使う
どちらを使うべきかは、自社がどちらの製品を管理しているかで決まります。
どちらのAPIを使うべきか
| API | キー種別 | 作成場所 | 作成できる人 | カバーする範囲 |
|---|---|---|---|---|
| Claude Code Analytics API | キー種別Admin APIキー(sk-ant-admin01-...) | 作成場所Console > Settings > Admin keys | 作成できる人組織のadmin | カバーする範囲ユーザー単位の日次Claude Code指標: セッション数・コード行数・コミット・PR・ツール受入率・モデル別推定コスト |
| Claude Enterprise Analytics API | キー種別Analytics APIキー | 作成場所claude.ai > Organization settings > API | 作成できる人primary owner | カバーする範囲組織全体のエンゲージメント・アダプション(ユーザー活動・アクティブユーザー集計・プロジェクト/スキル/コネクタ利用状況)、コスト・利用状況レポート |
2つのキー種別に互換性はありません。Admin APIキーでClaude Enterprise Analytics APIは呼べず、逆も同様です。どちらもAdmin APIリファレンスの配下に載っていますが、実体は別のAPIです。ConsoleとEnterpriseの両方を使っている組織は、両方のキーを作って使い分けます。Admin APIキー自体の取得手順とスコープ設計はClaude Admin APIキーの取得方法にまとめています。
APIの使用量・コストそのものを見たいだけなら、Analytics APIではなくUsage and Cost APIが対象です。製品内でエンゲージメント・アダプションを確認したいだけなら、claude.aiのAnalyticsダッシュボードで足ります。個々のユーザー操作や会話内容の監査が目的ならCompliance APIの領分です。
Claude Code Analytics APIへのアクセス
Claude Code Analytics APIは、Admin APIへのアクセス権を持つすべての組織で利用でき、料金は無料です。Admin APIキーを作成し、x-api-keyヘッダーに渡して/v1/organizations/usage_report/claude_codeエンドポイントを呼び出します。
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: $ANTHROPIC_ADMIN_KEY"取得できる指標・パラメータ・レスポンス形式の詳細はClaude Code Analytics APIの使い方で扱います。
Claude Enterprise Analytics APIへのアクセス
Claude Enterprise Analytics APIはClaude Enterprise組織向けです。エンゲージメント・アダプションデータは全Enterpriseプランで利用でき、コスト・利用状況エンドポイントは使用量ベースのEnterpriseプランが対象です(シート課金型プランでは利用クレジットのみの反映になります)。
組織のprimary ownerがAPIアクセスを有効化してAnalytics APIキーを作成し(read:analyticsスコープが付与されます)、https://api.anthropic.com/v1/organizations/analytics/配下のエンドポイントをx-api-keyヘッダー付きで呼び出します。
Claude Enterprise Analytics APIから取得できるデータは4種類です。
- ユーザー活動: chat(会話・メッセージ・プロジェクト・ファイル・アーティファクト)、Claude Code(セッション・コミット・PR・コード行数・ツール操作)など製品横断のユーザー単位日次指標
- 活動サマリー: 組織単位の日次・週次・月次アクティブユーザー数、シート数、招待保留数
- プロジェクト・スキル・コネクタ利用状況: chatのプロジェクト、スキル、コネクタのアダプション内訳
- コスト・利用状況レポート: 使用量ベースEnterpriseプランでの、ユーザー単位・組織単位のトークン使用量とコストの時系列データ
データの提供開始日と鮮度の違い
Claude Enterprise Analytics APIのデータは2026年1月1日以降の日付から利用できます。エンドポイントの種類によって、鮮度モデルが大きく異なります。
エンゲージメント・アダプション系のエンドポイントは、指定した日の1日分のスナップショットを返します。通常はその翌日のUTC17時頃に利用可能になり(1日遅れ)、それまでは現在のUTC日から2日前が最新の取得可能日になるのが一般的です。データの到着が遅れることもあるため、固定時刻を前提にせず、まだ利用できない日付をリクエストしたときに返る400エラーの中身(利用可能な最新の日付を明示)で確認するのが確実です。遅延が典型的な範囲を大きく超えて続く場合は、Anthropic側のデータパイプライン障害が疑われるためサポートへの連絡が必要です。
コスト・利用状況系のエンドポイントは別の鮮度モデルに従います。データは通常4時間以内、遅くとも24時間以内に利用可能になりますが、後から届くイベントの反映と再計算処理により、ある日付の値は最大30日間修正され続けます。請求と一致する確定値が必要なら、30日以上前の日付を対象にクエリを実行します。
レスポンスにはdata_refreshed_atタイムスタンプが含まれます。ending_atを省略すると(デフォルトは現在時刻)、data_refreshed_atより後の未確定データの末尾がレスポンスに混ざります。繰り返し呼び出して結果を安定させたいなら、ending_atに過去のレスポンスで返ってきたdata_refreshed_at以前の値を指定します。
実装で踏みやすい制約
Claude Enterprise Analytics APIには、実装時に見落としやすい仕様がいくつかあります。
- ページネーションカーソルはクエリに紐づく: コスト・利用状況系のエンドポイントで、
products[]・group_by[]・order_by・日付範囲・その他のフィルターを変更したまま古いカーソルを渡すと400エラーになります。パラメータを変える場合は、カーソルなしで1ページ目からやり直します - リストパラメータはブラケット記法: 値ごとにパラメータを繰り返します(例:
products[]=chat&products[]=claude_code) - 金額フィールドはセント単位の文字列: 通貨額は
"41280.000000"(412.80ドルを表す)のような10進文字列で返ります。ドルに変換するには10進数としてパースして100で割ります。数百万ドルを超える可能性がある値でバイナリ浮動小数点パースを使うと誤差が出ます - レート制限は組織単位: キー単位ではなく組織単位で、このAPI全体のエンドポイントを合わせてデフォルト60リクエスト/分です。不足する場合はAnthropicのアカウントチームに調整を相談します
すべてのリクエストでanthropic-versionヘッダーの送信が必須です。
アクティブユーザー(active users)の定義はAPIごとに違う
Claude Enterprise Analytics APIの「アクティブユーザー」は、直感で決めてよい概念ではありません。公式定義では、ある日にユーザーがアクティブとみなされるのは、次のいずれかを満たした場合です。①Claudeでチャットメッセージを1件以上送った ②その組織に紐づくClaude Codeセッション(ローカル・リモート問わず)でツール使用またはgit活動を伴うものを1件以上行った ③ツール使用またはメッセージ活動を伴うCoworkセッションを1件以上行った。単にログインしただけ、あるいはセッションを開いただけでは「アクティブ」に数えられません。
この定義はダッシュボードの数字を読むときにも効いてきます。「アクティブユーザー数が思ったより少ない」という違和感の多くは、ツールを使わず眺めるだけのユーザーがカウントから漏れていることに起因します。また、製品ごとのメトリクスブロック(たとえばOffice AgentやCoworkの指標)は、その製品を使っていない組織でも全レコードに必ず存在し、未使用の場合はnullではなく全項目ゼロ値で埋まります。集計スクリプトでnullチェックをしてしまうと、未使用組織のレコードを誤って除外してしまう点は実装上の落とし穴です。
コネクタ利用状況のエンドポイントでは、接続元の表記ゆれが正規化されます。たとえばAtlassian MCP server・mcp-atlassian・atlassian_MCPはすべてatlassianという1つの名前でレポートされます。複数のMCPサーバー実装を並行運用している組織が、コネクタ別の利用状況を手作業で名寄せする必要はありません。
どちらか一方では足りないケース
組織がClaude PlatformとClaude Enterpriseの両方を契約しているなら、どちらか一方のAPIだけでは全体像がつかめません。典型的には、開発チームはClaude Platform経由でClaude Codeを使い、営業やカスタマーサポートなど非開発チームはClaude Enterprise経由でchatやprojectsを使う、という組織構成です。この場合、開発チームの生産性はClaude Code Analytics API、非開発チームのアダプションはClaude Enterprise Analytics APIという具合に、レポーティングの対象を分けて両方運用することになります。
逆に、Claude Enterprise組織の開発チームがClaude Codeを使っている場合は話が変わります。claude.aiのEnterprise組織に所属するユーザーのClaude Code活動は、Claude Code Analytics APIではなくClaude Enterprise Analytics API側の「ユーザー活動」データに現れます。Admin APIキーでClaude Code Analytics APIを叩いても、Enterprise組織のユーザー分は取得できません。どちらのAPIを叩けばよいかは、ユーザーがどちらの組織に所属しているかで決まるのであって、使っている機能がClaude Codeかどうかでは決まらない、という点を取り違えないようにします。
既知の制限
Claude CodeをAmazon Bedrock経由で使っている場合、Claude Enterprise Analytics APIはそのBedrock利用分のClaude Code活動を返しません。Bedrock経由の利用状況を見たい場合は、この制限を踏まえて別の経路(Bedrock側のコンソール等)を確認する必要があります。
まとめ
Claude Code Analytics APIとClaude Enterprise Analytics APIは、見た目の名前は似ていても対象組織・キー種別・データ範囲が異なる別のAPIです。Claude Platform組織でClaude Codeの生産性指標だけが欲しいならAdmin APIキーでClaude Code Analytics APIを、Claude Enterprise組織で製品横断のエンゲージメント・コストを見たいならAnalytics APIキーでClaude Enterprise Analytics APIを選びます。両方を使っている組織は、両方のキーを別々に用意して使い分けます。