管理モニタリング

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を呼び出すことはできません。唯一の例外はUsage and Cost Analytics APIで、Claude Enterprise組織はAnalytics 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" \
     -H "anthropic-version: 2026-10-21" \
     -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

   

利用可能なメトリクス、リクエストパラメータ、およびレスポンススキーマについては、Claude Code Analytics APIガイドとAPIリファレンスAPI リファレンスへのリンクを含むプレビューを表示できます — カードにフォーカスが移るまで Tab キーを押します。戻るには Escape キーを押します。を参照してください。

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

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

1. 1

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

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

2. 2

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

   claude.ai > 組織設定 > 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（セッション、コミット、プルリクエスト、コード行数、ツールアクション）、Chat and Cowork unified（チャットアクティビティとCoworkセッション）、およびその他のClaude製品にわたるユーザーごとの日次メトリクス
• アクティビティサマリー： 組織レベルの日次、週次、月次のアクティブユーザー、シート数、保留中の招待
• プロジェクト、スキル、コネクターの使用状況： チャットプロジェクト、スキル、コネクターの導入状況の内訳
• コストと使用量のレポート： ユーザーごとおよび組織レベルのトークン使用量とコストの推移（使用量ベースのEnterpriseプラン）

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

データの可用性と鮮度

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

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

コストと使用量のエンドポイントは、異なる鮮度モデルに従います。データは通常、基になる使用から4時間以内に利用可能になりますが、最大24時間かかる場合があります。遅れて届いたイベントや照合処理の実行に応じて、暦月の終了後約7日まで値が修正される可能性があります。たとえば、10月1日の値は11月7日頃まで変わる可能性があります。請求書レベルの合計値が必要な場合は、終了から少なくとも7日が経過した月のみをクエリしてください。

メトリクスの定義方法

アクティブユーザー。 次のいずれかに該当する場合、そのユーザーはその日のアクティブユーザーとしてカウントされます。

• Claudeで少なくとも1件のチャットメッセージを送信した。
• Claude Enterprise組織に関連付けられた、ツール使用またはgitアクティビティを含むClaude Codeセッション（ローカルまたはリモート）が少なくとも1つあった。
• ツール使用またはメッセージアクティビティを含むCoworkセッションが少なくとも1つあった。

Chat and Cowork unified。 Chat and Cowork unifiedは、Coworkの機能をclaude.aiのチャットに取り込むものです。Chat and Cowork unifiedでのアクティビティの大部分は、chatやcoworkではなく、chat_cowork_unifiedという製品値で報告されます。

ユーザーアクティビティ、およびスキル、コネクター、プラグインの使用状況では、この使用量はchat_cowork_unified_metricsオブジェクトに表示されます。アクティビティサマリーでは、chat_cowork_unified_daily_active_user_count、chat_cowork_unified_weekly_active_user_count、chat_cowork_unified_monthly_active_user_countでカウントされます。

ユーザーがChat and Cowork unifiedを使い始めると、そのユーザーの使用量はチャットおよびCoworkの数値からChat and Cowork unifiedの数値へと移行します。ユーザーがChat and Cowork unifiedを使い始める前の日の使用量は、チャットまたはCoworkの下に残ります。総トークン使用量、総コスト、全体のアクティブユーザー数などの組織全体の数値は変わりません。製品でフィルタリングしたコストと使用状況のレポートでは、products[]にchat_cowork_unifiedが含まれていない限り、Chat and Cowork unifiedの使用量は除外されます。

Chat and Cowork unifiedのユーザーによる一部のアクティビティ（音声モードなど）は、引き続きチャットまたはCoworkの下でレポートされる場合があります。また、ユーザーがChat and Cowork unifiedを使い始めた日には、そのユーザーのアクティビティが製品間で分割される場合があります。そのユーザーに対して無効化された日も同様です。アクティビティがどのように分割されるかは保証されません。

ユーザーは、チャットまたはCoworkのカウントと、Chat and Cowork unifiedのカウントの両方に表示される場合があります。これは、ユーザーがChat and Cowork unifiedを使用し、そのアクティビティの一部がまだチャットまたはCoworkで報告されている日に発生する可能性があります。週次および月次のカウントでは、期間内に両方の種類のアクティビティがある場合、たとえ別々の日であっても、ユーザーが両方に含まれることがあります。たとえば、期間が、ユーザーがChat and Cowork unifiedを使い始める前と後の日にまたがる場合です。

ユーザーアクティビティをプロジェクトでフィルタリングする場合、各日のプロジェクトアクティビティは1か所でのみカウントされます。ユーザーがその日にChat and Cowork unifiedでチャットメッセージを送信した場合、そのユーザーのプロジェクトアクティビティはすべてchat_cowork_unified_metrics.chatでカウントされます。それ以外の場合は、chat_metricsでカウントされます。

製品ごとのメトリクスブロック。 製品ごとのメトリクスオブジェクト（たとえば、ユーザーアクティビティレコード上のOffice AgentやCoworkのメトリクス）は、すべてのレコードに常に存在します。その製品を使用していない組織では、nullオブジェクトではなくゼロのカウントが表示されます。例外はChat and Cowork unifiedで、これを提供していないデプロイメントでは、そのフィールドはレスポンスから除外されます。これらのオブジェクト内の個々のフィールドはnullになる場合があり、これは値が利用できないことを意味します。たとえば、ユーザーアクティビティをプロジェクトでフィルタリングする場合、chat_metrics内のdistinct_skills_used_countはnullになります。どのフィールドがnullになり得るかは、Claude Enterprise Analytics APIリファレンスに記載されています。

コネクター名。 コネクター名はソース間で正規化されます。たとえば、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ヘッダーを送信してください。利用可能なバージョンについては、バージョンを参照してください。

既知の制限事項

Amazon Bedrock経由のClaude Code

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

カスタマー管理の暗号化キーを使用したClaude CodeとCowork

組織がカスタマー管理の暗号化キーを使用している場合、Anthropicはデータを保護するため、Claude CodeとCoworkの使用に関する一部の詳細を使用状況アナリティクスから除外します。そのため、組織のClaude CodeまたはCoworkの使用量を測定する目的で、以下のClaude Enterprise Analytics APIの数値を使用しないでください。これらはゼロになるか、実際の使用量より低くなる可能性があります。

• コードの変更： ユーザーアクティビティでは、claude_code_metrics.core_metrics内の次のフィールドがゼロになる可能性があります：lines_of_code（追加および削除された行数）とcommit_count。pull_request_countフィールドは、実際のプルリクエスト数より低くなる可能性があります。
• スラッシュコマンドで開始されたスキル： ユーザーがClaude CodeまたはCoworkで/skill-nameなどのスラッシュコマンドを入力してスキルを開始した場合、その使用はカウントされません。これはスキルの使用状況、およびユーザーアクティビティにおけるCoworkのスキル数に適用されます。Claudeがスラッシュコマンドなしで呼び出したスキルは引き続きカウントされます。

カスタマー管理の暗号化キーに関するその他のアナリティクスの変更については、Claude EnterpriseでCMEKが保護する範囲を参照してください。

次のステップ