---
title: Claude Code Analytics API
url: https://platform.claude.com/docs/ja/manage-claude/claude-code-analytics-api
description: Claude Code Analytics Admin APIを使用して、組織のClaude Codeの使用状況分析と生産性メトリクスにプログラムからアクセスします。
---
**Admin APIは個人アカウントではご利用いただけません。** チームメイトと共同作業を行い、メンバーを追加するには、Claude Consoleの[Organization](https://platform.claude.com/settings/organization)ページ（`platform.claude.com/settings/organization`）で組織を設定してください。
Claude Code Analytics Admin APIは、Claude Codeユーザーの日次集計された使用状況メトリクスへのプログラムによるアクセスを提供します。これにより、組織は開発者の生産性を分析し、カスタムダッシュボードを構築できます。このAPIは、OpenTelemetry統合のような複雑さを伴わずに、基本的な[Analyticsダッシュボード](https://platform.claude.com/claude-code)よりも詳細な情報を提供します。
このAPIを使用すると、Claude Codeの導入状況をより適切に監視、分析、最適化できます。
* **開発者の生産性分析：** Claude Codeを使用して作成されたセッション、追加/削除されたコード行数、コミット、および「pull request」（プルリクエスト）、すなわちPRを追跡します
* **ツール使用メトリクス：** さまざまなClaude Codeツール（Edit、MultiEdit、Write、NotebookEdit）の承認率と拒否率を監視します
* **コスト分析：** Claudeモデルごとに内訳された推定コストとトークン使用量を確認します
* **カスタムレポート：** データをエクスポートして、経営陣向けのエグゼクティブダッシュボードやレポートを構築します
* **使用の正当化：** 社内でClaude Codeの導入を正当化し拡大するためのメトリクスを提供します
**Admin API認証情報が必要です。** これらのエンドポイントはAdmin APIの一部です。[Admin APIキー](https://platform.claude.com/docs/ja/manage-claude/admin-api-keys)、`org:admin`スコープを持つOAuthトークン、またはワークスペースにスコープされていない個人アカウントキーもしくはサービスアカウントキーを使用してアクセスできます。ワークスペースAPIキーは使用できません。詳細については、[認証](https://platform.claude.com/docs/ja/manage-claude/admin-api#authentication)を参照してください。
**Claude Platform on AWS：** Claude Code Analytics APIは現在利用できません。代わりに、Claude Consoleの**Usage**ページでClaude Codeの使用状況を確認してください。
**Claude Enterprise組織：** claude.aiユーザーのClaude Codeアクティビティは、Claude Enterprise Analytics APIによって報告されます。このAPIはAdmin APIキーではなくAnalytics APIキーを使用します。組織に必要なAPIとキーの種類については、[Analytics API](https://platform.claude.com/docs/ja/manage-claude/analytics-api)を参照してください。
## クイックスタート
特定の日の組織のClaude Code分析データを取得します。
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
**統合用にUser-Agentヘッダーを設定する**
統合を構築している場合は、Anthropicが使用パターンを把握できるようにUser-Agentヘッダーを設定してください。
```text wrap
User-Agent: YourApp/1.0.0 (https://yourapp.com)
```
## Claude Code Analytics API
`/v1/organizations/usage_report/claude_code`エンドポイントを使用して、組織全体のClaude Codeの使用状況、生産性メトリクス、開発者のアクティビティを追跡します。
### 主要な概念
* **日次集計：** `starting_at`パラメータで指定された単一の日のメトリクスを返します
* **ユーザーレベルのデータ：** 各レコードは、指定された日における1人のユーザーのアクティビティを表します
* **生産性メトリクス：** セッション、コード行数、コミット、プルリクエスト、ツール使用を追跡します
* **トークンとコストのデータ：** Claudeモデルごとに内訳された使用量と推定コストを監視します
* **カーソルベースのページネーション：** 不透明なカーソルを使用した安定した「pagination」（ページネーション）により、大規模なデータセットを処理します
* **データの鮮度：** 一貫性を確保するため、メトリクスは最大1時間の遅延で利用可能になります
パラメータの詳細とレスポンススキーマの全体については、[Claude Code Analytics APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization/usage_report/retrieve_claude_code)を参照してください。
### 基本的な例
#### 特定の日の分析データを取得する
```bash cURL
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
#### ページネーションを使用して分析データを取得する
```bash cURL
# 最初のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
limit=20" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
# レスポンスのカーソルを使用した後続のリクエスト
curl "https://api.anthropic.com/v1/organizations/usage_report/claude_code?\
starting_at=2025-09-08&\
page=page_MjAyNS0wNS0xNFQwMDowMDowMFo=" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"
```
### リクエストパラメータ
| パラメータ | 型 | 必須 | 説明 |
| ------------- | ------- | --- | ------------------------------------------------------------------------------- |
| `starting_at` | string | はい | YYYY-MM-DD形式の「Coordinated Universal Time」（協定世界時）、すなわちUTCの日付。この単一の日のメトリクスのみを返します |
| `limit` | integer | いいえ | 1ページあたりのレコード数（デフォルト：20、最大：1000） |
| `page` | string | いいえ | 前回のレスポンスの`next_page`フィールドから取得した不透明なカーソルトークン |
### 利用可能なメトリクス
各レスポンスレコードには、単一の日における単一ユーザーの以下のメトリクスが含まれます。
#### ディメンション
* **date：** RFC 3339形式の日付（UTCタイムスタンプ）
* **actor：** Claude Codeのアクションを実行したユーザーまたはAPIキー（`email_address`を持つ`user_actor`、または`api_key_name`を持つ`api_actor`のいずれか）
* **organization\_id：** 組織の「universally unique identifier」（汎用一意識別子）、すなわち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ツールの提案の数
* **multi\_edit\_tool.accepted/rejected：** ユーザーが承認/拒否したMultiEditツールの提案の数
* **write\_tool.accepted/rejected：** ユーザーが承認/拒否したWriteツールの提案の数
* **notebook\_edit\_tool.accepted/rejected：** ユーザーが承認/拒否したNotebookEditツールの提案の数
#### モデル別の内訳
使用された各Claudeモデルについて：
* **model：** Claudeモデルの識別子（例：`claude-opus-5`）
* **tokens.input/output：** このモデルの入力および出力トークン数
* **tokens.cache\_read/cache\_creation：** このモデルのキャッシュ関連のトークン使用量
* **estimated\_cost.amount：** このモデルの推定コスト（米ドルのセント単位）
* **estimated\_cost.currency：** コスト金額の通貨コード（現在は常に`USD`）
### レスポンス構造
APIは以下の形式でデータを返します。
```json
{
"data": [
{
"date": "2025-09-08T00:00:00Z",
"actor": {
"type": "user_actor",
"email_address": "developer@company.com"
},
"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-5-5",
"tokens": {
"input": 100000,
"output": 35000,
"cache_read": 10000,
"cache_creation": 5000
},
"estimated_cost": {
"currency": "USD",
"amount": 113
}
}
]
}
],
"has_more": false,
"next_page": null
}
```
## ページネーション
APIは、多数のユーザーを抱える組織向けにカーソルベースのページネーションをサポートしています。
1. オプションの`limit`パラメータを指定して最初のリクエストを送信します。
2. レスポンスで`has_more`が`true`の場合、次のリクエストで`next_page`の値を使用します。
3. `has_more`が`false`になるまで続けます。
カーソルは最後のレコードの位置をエンコードしており、新しいデータが到着しても安定したページネーションを保証します。各ページネーションセッションは一貫したデータ境界を維持するため、レコードを見逃したり重複したりすることはありません。
## 一般的なユースケース
* **エグゼクティブダッシュボード：** 開発速度に対するClaude Codeの影響を示す概要レポートを作成します
* **AIツールの比較：** メトリクスをエクスポートして、Claude CodeをCopilotやCursorなどの他のAIコーディングツールと比較します
* **開発者の生産性分析：** 個人およびチームの生産性メトリクスを経時的に追跡します
* **コストの追跡と配分：** 支出パターンを監視し、チームやプロジェクトごとにコストを配分します
* **導入状況の監視：** どのチームやユーザーがClaude Codeから最も価値を得ているかを特定します
* **ROIの正当化：** 社内でClaude Codeの導入を正当化し拡大するための具体的なメトリクスとして、「return on investment」（投資収益率）、すなわちROIを示します
## よくある質問
### 分析データはどのくらい新しいですか？
Claude Codeの分析データは通常、ユーザーのアクティビティ完了から1時間以内に表示されます。一貫したページネーション結果を保証するため、レスポンスには1時間以上前のデータのみが含まれます。
### リアルタイムのメトリクスを取得できますか？
いいえ、このAPIは日次集計されたメトリクスのみを提供します。リアルタイムの監視には、[OpenTelemetry統合](https://code.claude.com/docs/ja/monitoring-usage)の使用を検討してください。
### データ内でユーザーはどのように識別されますか？
ユーザーは`actor`フィールドを通じて、次の2つの方法で識別されます。
* **`user_actor`：** OAuthで認証するユーザー（最も一般的）の`email_address`を含みます
* **`api_actor`：** APIキーで認証するユーザーの`api_key_name`を含みます
`customer_type`フィールドは、使用が`api`顧客（従量課金制API）によるものか、`subscription`顧客（Pro/Teamプラン）によるものかを示します。
### データの保持期間はどのくらいですか？
Claude Codeの過去の分析データは保持され、APIを通じてアクセスできます。このデータには特定の削除期間は設定されていません。
### どのClaude Codeデプロイメントがサポートされていますか？
このAPIは、Claude API上のClaude Codeの使用状況のみを追跡します。[Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)、[Claude in Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)、[Claude on Google Cloud](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai)、または[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws)を通じた使用は含まれません。
### このAPIの使用にはどのくらいの費用がかかりますか？
Claude Code Analytics APIは、Admin APIにアクセスできるすべての組織が無料で使用できます。
### ツールの承認率はどのように計算しますか？
ツールの承認率は、各ツールの種類について`accepted / (accepted + rejected)`で計算されます。たとえば、Editツールで承認が45件、拒否が5件の場合、承認率は90%です。
### dateパラメータにはどのタイムゾーンが使用されますか？
すべての日付はUTCです。`starting_at`パラメータはYYYY-MM-DD形式で指定する必要があり、その日のUTC午前0時を表します。
## 関連項目
Claude Code Analytics APIは、チームの開発ワークフローを理解し最適化するのに役立ちます。関連機能の詳細については、以下を参照してください。
* [Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)
* [Admin APIリファレンス](https://platform.claude.com/docs/ja/api/beta/organization)
* [Claude Code Analyticsダッシュボード](https://platform.claude.com/claude-code)
* [Usage and Cost API](https://platform.claude.com/docs/ja/manage-claude/usage-cost-api) - すべてのAnthropicサービスにわたるAPI使用状況を追跡します
* [Compliance API](https://platform.claude.com/docs/ja/manage-claude/compliance-api) - 監査データとアクティビティデータを取得します
* [IDとアクセス管理](https://code.claude.com/docs/en/iam)
* [OpenTelemetryによる使用状況の監視](https://code.claude.com/docs/ja/monitoring-usage)（カスタムメトリクスとアラート用）