管理とモニタリング

Claude Code Analytics API

Claude Code Analytics Admin APIを使用して、組織のClaude Code使用状況分析と生産性メトリクスにプログラムからアクセスします。

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モデル別に分類された推定コストとトークン使用量を表示
カスタムレポート： データをエクスポートして、経営チーム向けのエグゼクティブダッシュボードとレポートを構築
使用の正当化： 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日分のメトリクスを返します
ユーザーレベルのデータ: 各レコードは、指定された日の1人のユーザーのアクティビティを表します
生産性メトリクス: セッション、コード行数、コミット、プルリクエスト、ツール使用状況を追跡
トークンとコストデータ: Claudeモデル別に分類された使用量と推定コストを監視
カーソルベースのページネーション: 不透明なカーソルを使用した安定したページネーションで大規模なデータセットを処理
データの鮮度: 一貫性を確保するため、メトリクスは最大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日付。この1日分のメトリクスのみを返します
`limit`	integer	いいえ	ページあたりのレコード数（デフォルト：20、最大：1000）
`page`	string	いいえ	前回のレスポンスの`next_page`フィールドからの不透明なカーソルトークン

利用可能なメトリクス

各レスポンスレコードには、1人のユーザーの1日分の以下のメトリクスが含まれます：

ディメンション

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-opus-4-6）
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-opus-4-6",
          "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）からのものか、subscriptionカスタマー（Pro/Teamプラン）からのものかを示します。

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

過去のClaude Codeアナリティクスデータは保持され、APIを通じてアクセス可能です。このデータに対する指定された削除期間はありません。

どのClaude Codeデプロイメントがサポートされていますか？

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

このAPIの使用コストはいくらですか？

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

ツール承認率はどのように計算しますか？

ツール承認率 = 各ツールタイプのaccepted / (accepted + rejected)。例えば、Editツールが45件の承認と5件の拒否を示している場合、承認率は90%です。

日付パラメータにはどのタイムゾーンが使用されますか？

すべての日付はUTCです。starting_atパラメータはYYYY-MM-DD形式で、その日のUTC午前0時を表します。

Claude Code Analytics API

Claude Code Analytics Admin APIを使用して、組織のClaude Code使用状況分析と生産性メトリクスにプログラムからアクセスします。

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

このAPIにより、Claude Codeの導入をより効果的に監視、分析、最適化できます：

開発者の生産性分析： Claude Codeを使用したセッション、追加/削除されたコード行数、コミット、プルリクエストを追跡
ツール使用メトリクス： さまざまなClaude Codeツール（Edit、Write、NotebookEdit）の承認率と拒否率を監視
コスト分析： Claudeモデル別に分類された推定コストとトークン使用量を表示
カスタムレポート： データをエクスポートして、経営チーム向けのエグゼクティブダッシュボードとレポートを構築
使用の正当化： Claude Codeの社内導入を正当化し拡大するためのメトリクスを提供

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

主要な概念

日次集計: starting_atパラメータで指定された1日分のメトリクスを返します
ユーザーレベルのデータ: 各レコードは、指定された日の1人のユーザーのアクティビティを表します
生産性メトリクス: セッション、コード行数、コミット、プルリクエスト、ツール使用状況を追跡
トークンとコストデータ: Claudeモデル別に分類された使用量と推定コストを監視
カーソルベースのページネーション: 不透明なカーソルを使用した安定したページネーションで大規模なデータセットを処理
データの鮮度: 一貫性を確保するため、メトリクスは最大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日付。この1日分のメトリクスのみを返します
`limit`	integer	いいえ	ページあたりのレコード数（デフォルト：20、最大：1000）
`page`	string	いいえ	前回のレスポンスの`next_page`フィールドからの不透明なカーソルトークン

利用可能なメトリクス

各レスポンスレコードには、1人のユーザーの1日分の以下のメトリクスが含まれます：

ディメンション

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-opus-4-6）
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-opus-4-6",
          "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の社内導入を正当化し拡大するための具体的なメトリクスを提供

よくある質問

アナリティクスデータはどの程度新鮮ですか？

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

いいえ、このAPIは日次集計メトリクスのみを提供します。リアルタイム監視については、OpenTelemetryインテグレーションの使用を検討してください。

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

ユーザーはactorフィールドを通じて2つの方法で識別されます：

user_actor: OAuth経由で認証するユーザーのemail_addressを含みます（最も一般的）
api_actor: APIキー経由で認証するユーザーのapi_key_nameを含みます

customer_typeフィールドは、使用がapiカスタマー（API PAYG）からのものか、subscriptionカスタマー（Pro/Teamプラン）からのものかを示します。

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

過去のClaude Codeアナリティクスデータは保持され、APIを通じてアクセス可能です。このデータに対する指定された削除期間はありません。

どのClaude Codeデプロイメントがサポートされていますか？

このAPIの使用コストはいくらですか？

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

ツール承認率はどのように計算しますか？

ツール承認率 = 各ツールタイプのaccepted / (accepted + rejected)。例えば、Editツールが45件の承認と5件の拒否を示している場合、承認率は90%です。

日付パラメータにはどのタイムゾーンが使用されますか？

すべての日付はUTCです。starting_atパラメータはYYYY-MM-DD形式で、その日のUTC午前0時を表します。

クイックスタート

Claude Code Analytics API

主要な概念

基本的な例

特定の日のアナリティクスを取得

ページネーション付きでアナリティクスを取得

リクエストパラメータ

利用可能なメトリクス

ディメンション

コアメトリクス

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

モデル内訳

レスポンス構造

ページネーション

一般的なユースケース

よくある質問

アナリティクスデータはどの程度新鮮ですか？

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

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

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

どのClaude Codeデプロイメントがサポートされていますか？

このAPIの使用コストはいくらですか？

ツール承認率はどのように計算しますか？

日付パラメータにはどのタイムゾーンが使用されますか？

関連情報

クイックスタート

Claude Code Analytics API

主要な概念

基本的な例

特定の日のアナリティクスを取得

ページネーション付きでアナリティクスを取得

リクエストパラメータ

利用可能なメトリクス

ディメンション

コアメトリクス

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

モデル内訳

レスポンス構造

ページネーション

一般的なユースケース

よくある質問

アナリティクスデータはどの程度新鮮ですか？

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

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

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

どのClaude Codeデプロイメントがサポートされていますか？

このAPIの使用コストはいくらですか？

ツール承認率はどのように計算しますか？

日付パラメータにはどのタイムゾーンが使用されますか？

関連情報