管理モニタリング

Analytics API

Copy page



組織に必要なアナリティクスAPIとAPIキーを理解し、Claude Codeの生産性メトリクスまたはClaude Enterpriseのエンゲージメントおよび導入データへのアクセスをプロビジョニングします。

Anthropicは2つのアナリティクスAPIを提供しており、どちらを使用するかは、組織が管理しているClaude製品によって決まります。

• Claude Code Analytics APIは、Claude Platformを使用する組織向けに、日次のClaude Code生産性メトリクスをレポートします。これはAdmin APIの一部であり、Admin APIキーを使用します。
• Claude Enterprise Analytics APIは、Claude Enterprise組織向けに、Claude製品（チャット、プロジェクト、Claude Codeなど）全体にわたる組織全体のエンゲージメント、導入、コストデータをレポートします。これはclaude.aiで作成されたAnalytics APIキーを使用します。

この2つのAPIは、異なる場所で異なるロールによって作成される、異なる種類のキーを使用します。このページでは、どのAPIが組織に適しているか、および適切なキーの作成方法について説明します。

どのAPIが必要ですか？

キーの種類は相互に互換性がありません。Admin APIキーではClaude Enterprise Analytics APIを呼び出すことはできず、Analytics APIキーではAdmin APIを呼び出すことはできません。どちらのAPIもAdmin APIリファレンスに掲載されていますが、それぞれ別のキーの種類を持つ別々のAPIです。組織がClaude PlatformとClaude Enterpriseの両方を使用している場合は、両方のキーをプロビジョニングし、それぞれのAPIをそれぞれのデータに使用できます。

Claude Code Analytics APIへのアクセスを取得する

Claude Code Analytics APIは、Admin APIにアクセスできるすべての組織で利用でき、無料で使用できます。

1. 1

   Admin APIキーを作成する

   Admin APIキーを作成するの手順に従ってください。

2. 2

   APIを呼び出す

   x-api-keyヘッダーにキーを渡します。

   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ガイドおよびAPIリファレンスを参照してください。

Claude Enterprise Analytics APIへのアクセスを取得する

Claude Enterprise Analytics APIは、Claude Enterprise組織で利用できます。エンゲージメントと導入データは、すべてのEnterpriseプランで利用できます。コストと使用状況のエンドポイントは、使用量ベースのEnterpriseプランに適用されます。シートベースのEnterpriseプランでは、使用クレジットのみが反映されます。

1. 1

   プライマリオーナーとしてサインインする

   APIアクセスを有効にしてAnalytics APIキーを作成できるのは、組織のプライマリオーナーのみです。

2. 2

   APIアクセスを有効にしてキーを作成する

   claude.ai > Organization settings > APIに移動してパブリックAPIアクセスを有効にし、Analytics APIキーを作成します。キーにはread:analyticsスコープが付与されます。表示されたシークレットをコピーし、シークレットマネージャーに保存してください。

3. 3

   APIを呼び出す

   x-api-keyヘッダーでキーを渡し、すべてのリクエストにanthropic-versionヘッダーを含めます。エンドポイントはhttps://api.anthropic.com/v1/organizations/analytics/の下にあります。リクエストの例、パラメータ、レスポンススキーマについては、Claude Enterprise Analytics APIリファレンスを参照してください。

Claude Enterprise Analytics APIは以下を提供します。

• ユーザーアクティビティ： チャット（会話、メッセージ、プロジェクト、ファイル、アーティファクト）、Claude Code（セッション、コミット、プルリクエスト、コード行数、ツールアクション）、およびその他のClaude製品にわたるユーザーごとの日次メトリクス
• アクティビティサマリー： 組織レベルの日次、週次、月次のアクティブユーザー、シート数、保留中の招待
• プロジェクト、スキル、コネクターの使用状況： チャットプロジェクト、スキル、コネクターの導入状況の内訳
• コストと使用状況のレポート： ユーザーごとおよび組織レベルのトークン使用量とコストの時系列推移（使用量ベースのEnterpriseプラン）

エンドポイントの詳細、パラメータ、レスポンススキーマについては、Claude Enterprise Analytics APIリファレンスを参照してください。以下のセクションでは、これらのエンドポイント全体に適用されるデータの鮮度、メトリクスの定義、運用上のガイダンスについて説明します。

データの可用性と鮮度

Claude Enterprise Analytics APIのデータは、2026年1月1日以降の日付について利用できます。

エンゲージメントと導入のエンドポイント（ユーザーアクティビティ、サマリー、プロジェクト、スキル、コネクタ）は、指定した日付の日次スナップショットを返します。特定の日のデータは通常、翌日のUTC 17:00頃から利用可能になります（1日の遅延）。それまでは、利用可能な最新の日は通常、現在のUTC日付の2日前です。データの到着がさらに遅れることもあり、正確な鮮度はクエリによって異なるため、固定の時刻を前提とするのではなく、エラーレスポンスを確認してください。まだ利用できない日付をリクエストすると、利用可能な最新の日を示す400エラーが返されます。通常の遅延を大幅に過ぎてもデータが利用できない場合は、通常Anthropic側のデータパイプラインの障害を示しています。この状態が続く場合はサポートにお問い合わせください。

コストと使用状況のエンドポイントは、異なる鮮度モデルに従います。データは通常、元となる使用から4時間以内に利用可能になりますが、最大24時間かかる場合があります。特定の日付の値は、遅延したイベントの到着や照合処理の実行に伴い、最大30日間修正される可能性があります。請求書レベルの精度の合計値が必要な場合は、少なくとも30日以上前の日付をクエリしてください。

メトリクスの定義方法

アクティブユーザー。 ユーザーは、次のいずれかに該当する場合、その日のアクティブユーザーとしてカウントされます。Claudeで少なくとも1件のチャットメッセージを送信した場合、Claude Enterprise組織に関連付けられた、「tool use」（ツール使用）またはgitアクティビティを含むClaude Codeセッション（ローカルまたはリモート）が少なくとも1件あった場合、またはツール使用もしくはメッセージアクティビティを含むCoworkセッションが少なくとも1件あった場合です。

製品ごとのメトリクスブロック。 製品ごとのメトリクスオブジェクト（たとえば、ユーザーアクティビティレコード上のOffice AgentやCoworkのメトリクス）は、すべてのレコードに常に存在します。その製品を使用していない組織では、nullではなくすべてゼロの値が表示されます。

コネクター名。 コネクター名はソース間で正規化されます。たとえば、Atlassian MCP server、mcp-atlassian、atlassian_MCPはすべて、コネクター使用状況エンドポイントではatlassianとして表示されます。

APIの操作

ページネーションカーソルは、それを発行したクエリに紐付けられています。 コストと使用状況のエンドポイントでは、シーケンスの途中でクエリパラメータを変更しないでください。products[]、group_by[]、order_by、日付範囲、またはいずれかのフィルターを変更して古いカーソルを渡すと、リクエストは400エラーを返します。パラメータを変更するには、カーソルなしで最初のページからやり直してください。

リストパラメータはブラケット記法を使用します。 値ごとにパラメータを繰り返します。たとえばproducts[]=chat&products[]=claude_codeのようにします。

金額フィールドはセント単位の10進数文字列です。 通貨金額は"41280.000000"（$412.80を表します）のような10進数文字列として返されます。ドルに変換するには、10進数として解析して100で割ります。数百万ドルを超える可能性のある値については、2進浮動小数点数による解析を避けてください。

「rate limit」（レート制限）は組織レベルで適用され、キーごとではありません。このAPIのすべてのエンドポイント全体で、デフォルトは1分あたり60リクエストです。ユースケースに対して十分でない場合は、Anthropicのアカウントチームに連絡して制限の調整についてご相談ください。

バージョニング

すべてのリクエストでanthropic-versionヘッダーを送信してください。利用可能なバージョンについては、APIバージョンを参照してください。

既知の制限事項

組織がAmazon Bedrock経由でClaude Codeを使用している場合、Claude Enterprise Analytics APIはその使用分のClaude Codeアクティビティを返しません。

次のステップ