「Claude Enterpriseを導入したのに、実際に組織の誰がどれくらい使っているか把握できていない」そんな悩みを持つ管理者は多いのではないでしょうか。AIツールへの投資対効果を上司に説明できず、採用促進の施策も打てないまま時間だけが過ぎていく——。そのモヤモヤをスッキリ解消するのが、Claude Enterprise Analytics APIです。
この記事でわかることを簡単にまとめると、次のとおりです。
- Claude Enterprise Analytics APIの仕組みと日次データ取得の全体像
- 5つのエンドポイントの使い方と取得できるメトリクスの具体的な内容
- Admin APIとEnterprise Analytics APIの違いと使い分けのポイント
- Claude Enterprise Analytics APIとは何か?
- 日次データを取得できる5つのエンドポイント
- Enterprise Analytics APIとAdmin APIの違いを整理する
- 実際の取得フローと実装のポイント
- 2026年3月時点での最新動向と今後の展望
- 「データが来ない」「数字がおかしい」——現場で実際によくある5つのトラブルと解決策
- ClaudeをAnalyticsデータの「解析エンジン」として使う活用術
- Compliance APIとの違い——ガバナンス視点で見た使い分け
- GitHubと連携してClaude Codeの「実際の貢献」を可視化する
- Python×Claude APIで作る「週次レポート自動化」の実装イメージ
- ぶっちゃけこうした方がいい!
- Claude Enterpriseの日次データ取得に関する疑問解決
- まとめ
Claude Enterprise Analytics APIとは何か?

AIのイメージ
Claude Enterprise Analytics APIは、Enterprise組織内のClaudeおよびClaude Codeの利用状況を、プログラムから取得できる専用のAPIです。「誰が」「いつ」「どのくらい」Claudeを使っているのかを日次単位で把握できる設計になっており、社内ダッシュボードの構築や採用率の追跡、経営層への報告資料作成に活用されています。
最大の特徴は、組織単位・日次単位でデータが集計される点です。日(N-1)のデータはN日のUTC10:00に処理が走り、集計後3日が経過した時点から照会可能になります。つまり、今日(2026年3月11日)取得できる最新データは3月8日分ということになります。この3日間の遅延は、データの正確性を担保するために設けられた仕様です。
また、このAPIにアクセスするにはEnterpriseプランの「プライマリオーナー」である必要があります。claude.ai/analytics/api-keysからAPIキーを発行し、read:analyticsスコープを付与することで利用が始められます。
なお、2026年3月現在、Anthropicはこの Analytics APIをEnterpriseプラン専用として提供しています。TeamプランではCSVエクスポートや管理画面での利用分析は使えるものの、プログラムからの日次データ取得はできません。Teamプランから移行を検討している組織は、この点を念頭に置いてください。
日次データを取得できる5つのエンドポイント
Analytics APIには5つのエンドポイントが用意されています。それぞれが別々の視点から組織の利用状況を照らし出してくれます。
ユーザーごとのエンゲージメント(/users)
/v1/organizations/analytics/usersは、指定した1日分のユーザーごとのアクティビティデータを返します。1レコードが1ユーザーに対応していて、Claude.aiでの会話数やメッセージ数だけでなく、Claude Codeの利用データ(gitコミット数、プルリクエスト数、追加・削除コード行数、セッション数)まで1つのエンドポイントで取得できます。
さらに細かいところでは、アーティファクトの作成数、ファイルのアップロード数、コネクタの呼び出し回数、Webサーチの利用回数なども含まれます。「エンジニアはClaude Codeで何コミットしているか」「ビジネスサイドのメンバーはどのくらいチャットを活用しているか」といった職種別の分析が、このエンドポイント1本でカバーできます。
デフォルトの取得件数は1ページ20件ですが、最大1000件まで指定可能です。カーソルベースのページネーションに対応しており、next_pageトークンを使って全ユーザーのデータを順次取得していく仕組みです。
リクエスト例はシンプルです。
GET /v1/organizations/analytics/users?date=2026-03-08&limit=100
ヘッダーにはx-api-keyでAPIキーを渡すだけです。
組織全体のサマリー(/summaries)
/v1/organizations/analytics/summariesは、DAU(日次アクティブユーザー数)・WAU(週次)・MAU(月次)を一括取得できる便利なエンドポイントです。最大31日間の日付範囲を指定でき、シート割り当て数や保留中の招待数も含まれるため、ライセンスの消化状況を把握するのにも役立ちます。
ここでいう「アクティブ」の定義は明確で、Claude.aiでチャットメッセージを1件以上送信したか、Claude Codeセッションでツール使用またはgitアクティビティが1件以上あった場合が対象です。曖昧さがなく、経営層への報告指標としてそのまま使えます。
週次・月次のローリングウィンドウは、指定した日付から過去に向かって7日・30日を集計します。過去30日に満たないデータが存在する場合(例APIの利用を開始したばかりの組織など)は月次が過小計上になることがあるため注意してください。
チャットプロジェクト別の利用状況(/apps/chat/projects)
Claude.ai上でプロジェクト機能を活用している組織には、/v1/organizations/analytics/apps/chat/projectsが特に有用です。プロジェクトごとにユニークユーザー数・会話数・メッセージ数が返ってくるため、「どのプロジェクトが活発に使われているか」「どのプロジェクトが放置されているか」が一目瞭然です。社内でのAI活用普及を推進する際の優先順位付けに直結します。
スキル利用データ(/skills)
/v1/organizations/analytics/skillsは、組織内でどのスキルが使われているかを日次で取得します。Claude.aiのチャットとClaude Codeの両方をカバーしており、各スキルを利用したユニークユーザー数が返ってきます。スキルの浸透度を把握することで、社内トレーニングの改善や新スキルの導入判断に役立てられます。
コネクタ・MCP利用データ(/connectors)
5つ目のエンドポイントがコネクタとMCPサーバーの利用状況を返す/v1/organizations/analytics/connectorsです。外部ツール連携がどれだけ使われているかを把握でき、連携の費用対効果を評価するための材料になります。
Enterprise Analytics APIとAdmin APIの違いを整理する
「Analytics API」と「Admin API」は、どちらもデータを取得する目的で使われますが、アクセス方法・対象データ・利用プランが異なります。混乱しやすいポイントなので、ここで整理しておきます。
| 比較項目 | Enterprise Analytics API | Admin API(Usage&Cost) |
|---|---|---|
| APIキーの種類 | read:analytics スコープのキー(claude.ai発行) | Admin APIキー(sk-ant-admin…) |
| 利用可能プラン | Enterpriseプランのみ | Claude Developer Platform(Console組織) |
| 主なデータ内容 | ユーザーエンゲージメント・採用率・プロジェクト活用状況 | トークン消費量・APIコスト・モデル別内訳 |
| データ粒度 | 組織単位・日次集計(過去90日、2026年1月1日以降) | APIリクエスト単位・バケット幅指定可能 |
| 遅延 | 3日の遅延あり | APIリクエスト完了から約5分以内 |
Enterprise Analytics APIは「誰がどう使っているか」というエンゲージメントと採用の視点に特化しており、Admin APIは「いくらかかっているか」というコストと消費量の視点に特化しています。両方を組み合わせることで、「活発に使われているユーザーがどれくらいのコストを消費しているか」といった複合分析も可能になります。
なお、Claude Code Analytics Admin APIという3つ目の選択肢もあります。こちらはAdmin APIの一部として提供されており、エンジニアのプロダクティビティメトリクス(セッション数、コード行数、コミット数、ツールの承認・却下率、推定コストなど)を日次で取得できます。データはユーザーアクティビティ完了から約1時間以内に反映されるため、Enterprise Analytics APIの3日遅延より圧倒的にリアルタイムに近いのが特徴です。開発組織の生産性分析が目的であれば、このAPIが最適解になります。
実際の取得フローと実装のポイント
実装にあたって押さえておくべき点をまとめます。
まず認証の仕組みについてです。全リクエストにリクエストヘッダーx-api-keyでAPIキーを渡す必要があります。ベースURLはhttps://api.anthropic.comで、各エンドポイントへのリクエストはすべてGETメソッドです。
ページネーションはカーソルベース方式を採用しており、レスポンスに含まれるnext_pageフィールドの値を次のリクエストのpageパラメータに渡すことで続きのデータを取得します。next_pageがnullになったら全件取得完了のサインです。
エラーハンドリングについては、HTTPステータスコードで判断するのが基本です。400は日付が無効か取得可能期間外であることを示し、特に「2026年1月1日より前の日付」または「3日以内の日付」を指定すると発生します。404はAPIキーが見つからないか権限が不足している場合、429はレート制限超過、503は一時的な障害を示します。503が返ってきた場合はリトライで解消できることがほとんどです。
社内ダッシュボードへの組み込みでよく使われるパターンとして、毎朝UTCの午前10時以降に前日(N-2日)のデータを取得してBIツールに書き込むバッチ処理があります。データの遅延を3日と知らずに設計すると「データが来ない」と勘違いしやすいので、取得対象日を現在日付から3日以上前に設定することを必ず実装に盛り込んでください。
2026年3月時点での最新動向と今後の展望
2026年に入り、AnthropicはEnterprise向けのデータ活用基盤を急ピッチで整備しています。Claude Code Analytics Admin APIのリリース、EnterpriseプランのWebセルフサーブ購入対応(営業担当との会話なしでも契約可能に)、そしてClaude Sonnet 4.6の1Mトークンコンテキスト対応など、2026年2〜3月だけでも多数のアップデートが連続しています。
Enterprise Analytics APIが取得できるデータの保存期間は過去90日間(2026年1月1日以降が対象)と定められています。長期トレンドの分析を行いたい場合は、毎日のバッチでデータを外部ストレージに蓄積していく設計が必要です。この点は、実装前に必ずデータ保管戦略を検討しておきましょう。
また、現時点ではTeamプランにAnalytics APIは提供されていませんが、EnterpriseプランのAnalytics APIがTeamプランにも将来的に展開されることを期待している声が開発者コミュニティでは多く聞かれます。組織規模が150名を超えた場合はEnterpriseプランへの移行が必要になる(Teamプランの上限が150シート)ため、その移行タイミングでAnalytics APIを活用し始める企業も増えています。
「データが来ない」「数字がおかしい」——現場で実際によくある5つのトラブルと解決策

AIのイメージ
Analytics APIを実装した後、現場でよく聞く声がある。「ちゃんとリクエストを投げているのにデータが空で返ってくる」「先週まで動いていたのに突然エラーになった」——これらの多くは仕様の理解不足か、Anthropic側の一時的な障害が原因だ。実体験ベースで解説する。
トラブル1400エラーが返ってきてデータが取れない
これが一番多い。原因は9割以上が「日付指定のミス」だ。Analytics APIは集計から3日後以降の日付しか受け付けない。今日が3月11日なら、取得できる最新データは3月8日分まで。3月9日や3月10日を指定すると400が返る。また、2026年1月1日より前の日付も同様に400になる。実装時に「当日日付から3を引く」という処理を忘れやすいので、バッチスクリプトの日付計算ロジックは必ず二重チェックすること。
トラブル2データは返ってくるがユーザー数が実態より少ない
summariesエンドポイントで月次アクティブユーザー数(MAU)を取得したとき、「明らかに少ない」と感じるケースがある。これはローリングウィンドウの仕様によるものだ。月次MAUは「指定日から過去30日間」を集計するが、APIの利用開始から30日未満の場合はウィンドウ内のデータが埋まっていないため、過小計上になる。導入初月のレポートに使う場合はこの点を必ずメモしておこう。
トラブル3ある特定の日だけデータが欠落している
これはAnthropic側のデータパイプライン障害が原因であることが多い。実際に2026年2月26日〜27日にかけてUsage report APIとAnalyticsダッシュボードで障害が発生し、データの欠損と誤表示が報告されている。このような障害はAnthropicのステータスページ(status.claude.com)に記録されるため、「3日以上前のデータなのに取れない」という状況が発生したら、まずステータスページを確認することを習慣にしてほしい。障害後にデータが復旧されるケースが多いため、数時間後にリトライするのが正解だ。CSMに相談するのはその後でいい。
トラブル4レート制限(429)に引っかかる
Analytics APIのデフォルトレート制限は組織単位で1分60リクエストだ。1回のリクエストで大量のページを取得するバッチ処理を作ると、あっという間にこの上限に達する。対策は2つ。1つ目は取得ロジックにexponential backoffを実装すること。2つ目は、limitパラメータを最大値(1000)に設定して1回のリクエストで取得できる件数を増やし、全体のリクエスト回数を減らすことだ。それでも不足する場合はCSMにレート制限の引き上げを相談できる。
トラブル5APIキーは正しいのに404が返ってくる
404が返ってくる場合、まず確認すべきはAPIキーにread:analyticsスコープが付与されているかどうかだ。標準的なClaude APIキーやAdmin APIキーはAnalytics APIでは使えない。claude.ai/analytics/api-keysで発行した専用キーが必要で、かつそのキーにread:analyticsスコープが設定されていることが条件だ。キーの発行画面でスコープを設定し忘れるケースが意外と多い。
ClaudeをAnalyticsデータの「解析エンジン」として使う活用術
ここからが本題だ。Analytics APIでデータを取得した後、そのデータをどう分析・活用するかで差がつく。実はClaudeそのものをAPIレスポンスの解析エンジンとして使うという発想が、2026年現在の最も効率的な活用パターンになっている。
単純にBIツールにデータを流し込んでグラフを作るだけでは、「何かが起きている」という事実は見えても「なぜ起きているか」「次に何をすべきか」までは見えてこない。Claudeに生のJSONデータを渡すことで、その解釈と次のアクションまでを一気に引き出せる。
以下に、実際の業務で使えるプロンプトをいくつか紹介する。
プロンプト1日次レポートの自動生成(経営層向け)
Analytics APIから取得した/summariesのJSONレスポンスをそのままClaudeに渡し、次のように指示する。
「以下は我が組織の過去7日間のClaude利用サマリーデータです。経営会議で使うスライド1枚分のサマリーを日本語で作成してください。DAUのトレンド、週次対比での増減率、シート稼働率の現状と課題感、改善に向けた具体的な施策提案を含めてください。数字は文章の中に自然に組み込み、非エンジニアでも理解できる表現を使ってください。」
このプロンプトで経営層向けの週次レポートが数秒で生成できる。毎週月曜の朝にバッチでデータを取得してClaudeに流し込み、Slackに自動投稿する仕組みを作っている企業が実際に増えている。
プロンプト2ユーザー別の利用傾向分析と「声かけが必要な人」の特定
/usersエンドポイントから全ユーザーデータを取得した後、このプロンプトが使える。
「以下は組織内ユーザーのClaude利用データ(CSV形式)です。このデータを分析して、①過去7日間で利用が急減したユーザー(前週比50%以上の減少)、②一度も使っていないユーザー、③特定の機能(Claude Code、コネクタなど)を集中的に使っているパワーユーザーの3グループに分類してください。各グループに対して、AI活用推進担当者としてどのようなフォローアップアクションを取るべきかも提案してください。」
「声かけが必要な人を自動抽出する」という使い方はシンプルだが効果が高い。人事異動や業務変化で利用が止まったユーザーに早期にアプローチできる。
プロンプト3プロジェクト利用データからROI仮説を立てる
/apps/chat/projectsのデータをClaudeに渡し、こう聞く。
「以下はClaude.aiのプロジェクト別利用データです。会話数・ユニークユーザー数・メッセージ数のパターンから、どのプロジェクトが組織にとって最も価値を生み出している可能性が高いか、またどのプロジェクトは活用が停滞しているかを分析してください。停滞しているプロジェクトについては、活性化のための仮説と施策を3つ挙げてください。プロジェクト名から業務内容を推測したうえで回答してください。」
このプロンプトは「何となく作ったけど使われていないプロジェクト」の棚卸しに絶大な効果がある。半年に一度の定期レビューに組み込むと、AI活用の質が着実に上がる。
プロンプト4スキル利用データからトレーニングの優先順位を決める
/skillsエンドポイントのデータに対して使えるプロンプト。
「以下は組織内のスキル利用データです。各スキルを利用しているユニークユーザー数をもとに、全社員に対するスキル普及率を計算してください(総ユーザー数は名)。普及率が低い重要スキルを特定し、社内研修プログラムの優先順位付けと、各スキルの普及率を高めるための具体的な社内施策を提案してください。」
スキルの普及率データと研修計画を結びつけるのは、「データドリブンなAI人材育成」の第一歩だ。感覚ではなく数字で優先順位を決められる。
Compliance APIとの違い——ガバナンス視点で見た使い分け
「Analytics APIで個々の会話内容も取れますか?」という質問をよく受ける。答えはノーだ。Analytics APIが返すのはあくまで集計データであり、個別の会話テキストや具体的な操作ログは含まれない。
個別ユーザーの行動ログや会話内容に関するアクセスが必要な場合は、Compliance APIを使う必要がある。Compliance APIはガバナンスと監査目的で設計されており、個別ユーザーアクション・生のアクティビティイベント・会話コンテンツへのアクセスが可能だ。
この使い分けは非常に重要だ。内部ダッシュボードの構築や採用率トラッキングが目的ならAnalytics API、コンプライアンス対応や情報セキュリティ監査が目的ならCompliance APIと、目的に応じて明確に切り分けることが求められる。両方を混同して「Analytics APIで会話内容を取れないか」と問い合わせてくる例もあるが、設計思想が根本的に異なるため、それぞれの役割を理解しておくことが大切だ。
GitHubと連携してClaude Codeの「実際の貢献」を可視化する
2026年現在、EnterpriseプランではClaude.aiのAnalyticsダッシュボードをGitHubと接続することでより深い洞察が得られるようになっている。設定すると、「Claude Codeが関与したPR数」「Claude Codeアシスト付きのコード行数」「全マージ済みPRに占めるClaude Code関与率」といった貢献メトリクスが取得できる。
ここで注意したいのが、このメトリクスは意図的に保守的な設計になっている点だ。Claude Codeが関与したと高い確信度で判断できるPRとコード行のみがカウントされる。つまり「実際の効果を過小評価」する仕様であり、逆に言えば数字として出てきている貢献は確実な証拠として使える。
設定手順は、claude.ai/analytics/claude-codeにアクセスし、GitHub analyticsのトグルをオンにしてGitHub組織と連携するだけだ。データ反映には通常24時間かかり、その後は毎日更新される。この数字はエンジニア組織でのROI説明資料に使うと説得力が増す。
Python×Claude APIで作る「週次レポート自動化」の実装イメージ
具体的な実装のイメージを持ってもらうために、Analytics APIとClaude APIを組み合わせた週次レポート自動化の構成を説明する。コードの全体像は以下の流れになる。
まずステップ1として、Analytics APIの/summariesエンドポイントに対して過去7日分のデータをリクエストする。日付計算には「今日から4日前を終了日、11日前を開始日」とすることで、3日の遅延を考慮した確実に取得可能な期間を指定する。
ステップ2では/usersエンドポイントを叩いてページネーションで全ユーザーデータを取得し、アクティブユーザー数・非アクティブユーザーリスト・Claude Codeのコミット合計数などを集計する。
ステップ3では取得したデータをJSONとして整形し、Claude API(claude-sonnet-4-6モデル推奨)に対して「経営層向け週次サマリーを日本語で作成してください」というプロンプトと共に投げる。
ステップ4でClaudeが生成したサマリーテキストをSlack Webhookまたはメールで関係者に自動配信する。
この一連の流れをGitHub ActionsやAWS LambdaなどのCI/CDツールで月曜朝9時に定期実行するよう設定すれば、完全自動の週次AIレポーティングシステムの出来上がりだ。Anthropic自身もこのようなBI連携を想定した設計でAPIを作っているため、標準的なPython requestsライブラリだけで実装できる。
一点だけ注意してほしいのは、Analytics APIへのポーリング頻度だ。ダッシュボードのように頻繁な更新が必要な場合でも、レスポンスを最低1時間はキャッシュすることが推奨されている。Analytics APIのデータ自体は日次集計なので、何度叩いても同じデータしか返ってこない。無駄なリクエストでレート制限を消費しないよう、キャッシュ設計は必須だ。
ぶっちゃけこうした方がいい!
ここまで色々書いてきたけど、個人的にはこうしたほうが楽だし効率的だと思う。
Analytics APIの実装は「完璧なダッシュボード」を最初から作ろうとしないことだ。よくあるパターンが「まず全エンドポイントを叩いて完全なBIダッシュボードを作る」という着想から始めるもので、これが挫折の元になる。エンドポイントは5つあり、データ構造は複雑で、ページネーション処理もある。最初から全部やろうとすると、数週間かかって結局誰も使わないダッシュボードが完成する。
正直なところ、まず/summariesだけに絞って週次DAUと月次MAUの推移グラフを1本作るのがベストだ。それだけでも「誰がいつ使っているか」の全体感がつかめる。次に/usersを追加して「非アクティブユーザーリストを毎週Slackに自動投稿する」という小さな自動化を作る。この2ステップだけで、ほとんどのAI活用推進担当者が本当に必要なことの8割はカバーできる。
もう1つぶっちゃけると、取得したデータの解釈はClaudeに任せてしまうのが最速だ。「このデータから何が読み取れるか」を人間が頑張って考えるより、CSVかJSONをそのままClaudeに渡して「採用を促進するために今週アクションすべきことを教えて」と聞く方が、同じ時間で圧倒的に深い示唆が出てくる。Analytics APIとClaude APIを組み合わせる設計は、まさにこの「データ取得」と「データ解釈」を両立させるために最適化されている。
APIを使いこなすことが目的になっている人をたまに見かけるけど、本来の目的は「組織のClaude活用を加速させること」だ。その手段として最も効果的なのは、取得したデータを素早くアクションに変換することに尽きる。難しい実装より、シンプルな自動化と、Claudeへの上手な質問の組み合わせが、現場では間違いなく最強だ。
Claude Enterpriseの日次データ取得に関する疑問解決
APIキーはどこで発行できますか?
claude.ai/analytics/api-keysにアクセスして発行できます。発行にはEnterprise組織のプライマリオーナー権限が必要です。発行したキーには必ずread:analyticsスコープを付与してください。組織ごとに複数のキーを作成でき、レート制限はキー単位ではなく組織単位で管理されます。
データが取得できない場合はどうすればいいですか?
まず確認すべきは取得対象の日付が3日以上前になっているかという点です。当日や直近2日分のデータは集計が完了していないため取得できません。次に、取得対象日が2026年1月1日以降であることを確認してください。これがAPIで取得できる最古の日付です。上記を確認してもデータが返ってこない場合は、データパイプラインの障害が発生している可能性があります。Anthropic側は通常そのような問題を把握していますが、必要であればCSM(カスタマーサクセスマネージャー)に問い合わせてください。
Claude Codeの利用データはEnterprise Analytics APIとAdmin APIのどちらで取得すべきですか?
目的によって使い分けるのがベストです。「誰がどのくらいClaude Codeを使っているか」というエンゲージメントの把握が目的であれば、Enterprise Analytics APIの/usersエンドポイントが適しています。一方、「開発チームのプロダクティビティをコストと合わせて詳細分析したい」場合は、Claude Code Analytics Admin APIの方がモデル別コスト・ツール承認率・セッション詳細などをより細かく取得できます。大規模開発組織であれば両方を組み合わせて使うのが理想的です。
リアルタイムのモニタリングは可能ですか?
Enterprise Analytics APIは日次集計のみ対応しており、リアルタイムモニタリングには対応していません。リアルタイムでの監視が必要な場合は、OpenTelemetryインテグレーションの利用をAnthropicは推奨しています。なお、Claude Code Analytics Admin APIはアクティビティ完了から約1時間以内にデータが反映されるため、準リアルタイムに近い形でClaude Codeの利用状況を把握したい場合はこちらが選択肢になります。
まとめ
Claude Enterprise Analytics APIは、Enterprise組織がClaudeの採用状況・エンゲージメント・プロジェクト活用度を日次単位でプログラムから取得できる、AI活用推進担当者にとって欠かせないツールです。
重要なポイントを改めて確認しておきましょう。データの取得可能期間は集計から3日後以降・過去90日以内(2026年1月1日以降)で、APIキーの発行にはプライマリオーナー権限とread:analyticsスコープが必要です。5つのエンドポイントをうまく組み合わせることで、ユーザー個別の分析から組織全体のDAU/MAU管理まで、多角的なデータ活用が実現できます。
コスト管理まで含めた包括的な分析を行うには、Enterprise Analytics APIだけでなくAdmin APIやClaude Code Analytics Admin APIとの組み合わせが有効です。それぞれのAPIの特性を理解した上で、自組織の課題に合ったデータ戦略を設計してみてください。


コメント