---
title: Claude Code 分析 API
url: https://platform.claude.com/docs/zh-TW/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 提供比基本[分析儀表板](https://platform.claude.com/claude-code)更詳細的資訊，且不需要 OpenTelemetry 整合的複雜設定。
此 API 可協助您更好地監控、分析和最佳化您的 Claude Code 採用情況：
* **開發人員生產力分析：** 追蹤使用 Claude Code 建立的工作階段、新增/移除的程式碼行數、commit 和 pull request
* **工具使用指標：** 監控不同 Claude Code 工具（Edit、MultiEdit、Write、NotebookEdit）的接受率與拒絕率
* **成本分析：** 檢視依 Claude 模型細分的預估成本和 token 使用量
* **自訂報告：** 匯出資料以為管理團隊建立高階主管儀表板和報告
* **使用合理性說明：** 提供指標以在內部說明並擴大 Claude Code 的採用
**需要 Admin API 憑證。** 這些端點屬於 Admin API 的一部分。您可以使用 [Admin API 金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys)、具有 `org:admin` 範圍的 OAuth 權杖，或未限定於特定工作區的個人或服務帳戶金鑰來存取它們；工作區 API 金鑰無法使用。詳情請參閱[驗證](https://platform.claude.com/docs/zh-TW/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 使用 Analytics API 金鑰而非 Admin API 金鑰。請參閱[分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api)，以了解您的組織需要哪種 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 標頭**
如果您正在建立整合，請設定您的 User-Agent 標頭，以協助 Anthropic 了解使用模式：
```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` 參數指定之單一日期的指標
* **使用者層級資料：** 每筆記錄代表一位使用者在指定日期的活動
* **生產力指標：** 追蹤工作階段、程式碼行數、commit、pull request 和工具使用情況
* **Token 與成本資料：** 監控依 Claude 模型細分的使用量和預估成本
* **「Cursor-based pagination」（基於游標的分頁）：** 使用不透明游標進行穩定分頁，以處理大型資料集
* **資料新鮮度：** 為確保一致性，指標最多會有 1 小時的延遲
如需完整的參數詳細資訊和回應結構描述，請參閱 [Claude Code Analytics API 參考文件](https://platform.claude.com/docs/zh-TW/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"
# 後續請求，使用回應中的 cursor
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 格式的 UTC 日期；僅傳回此單一日期的指標 |
| `limit` | integer | 否 | 每頁記錄數（預設：20，最大值：1000） |
| `page` | string | 否 | 來自前一個回應之 `next_page` 欄位的不透明游標 token |
### 可用指標
每筆回應記錄包含單一使用者在單一日期的下列指標：
#### 維度
* **date：** RFC 3339 格式的日期（UTC 時間戳記）
* **actor：** 執行 Claude Code 動作的使用者或 API 金鑰（為包含 `email_address` 的 `user_actor`，或包含 `api_key_name` 的 `api_actor`）
* **organization\_id：** 組織 UUID
* **customer\_type：** 客戶帳戶類型（`api` 代表 API 客戶，`subscription` 代表 Pro/Team 客戶）
* **terminal\_type：** 使用 Claude Code 的終端機或環境類型（例如 `vscode`、`iTerm.app`、`tmux`）
#### 核心指標
* **num\_sessions：** 此 actor 啟動的不同 Claude Code 工作階段數量
* **lines\_of\_code.added：** Claude Code 在所有檔案中新增的程式碼總行數
* **lines\_of\_code.removed：** Claude Code 在所有檔案中移除的程式碼總行數
* **commits\_by\_claude\_code：** 透過 Claude Code 的 commit 功能建立的 git commit 數量
* **pull\_requests\_by\_claude\_code：** 透過 Claude Code 的 PR 功能建立的 pull request 數量
#### 工具動作指標
依工具類型細分的工具動作接受率與拒絕率：
* **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：** 此模型的輸入和輸出 token 數量
* **tokens.cache\_read/cache\_creation：** 此模型與快取相關的 token 使用量
* **estimated\_cost.amount：** 此模型的預估成本，以美分（USD）計
* **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 獲得最大價值
* **投資報酬率說明：** 提供具體指標，以在內部說明並擴大 Claude Code 的採用
## 常見問題
### 分析資料的新鮮度如何？
Claude Code 分析資料通常會在使用者活動完成後 1 小時內出現。為確保分頁結果一致，回應中僅包含超過 1 小時的資料。
### 我可以取得即時指標嗎？
不行，此 API 僅提供每日彙總指標。如需即時監控，請考慮使用 [OpenTelemetry 整合](https://code.claude.com/docs/zh-TW/monitoring-usage)。
### 資料中如何識別使用者？
使用者透過 `actor` 欄位以兩種方式識別：
* **`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/zh-TW/build-with-claude/claude-in-amazon-bedrock)、[Claude in Microsoft Foundry](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-microsoft-foundry)、[Claude on Google Cloud](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-vertex-ai) 或 [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) 的使用量不包含在內。
### 使用此 API 需要多少費用？
所有可存取 Admin API 的組織皆可免費使用 Claude Code Analytics API。
### 如何計算工具接受率？
每種工具類型的工具接受率 = `accepted / (accepted + rejected)`。例如，如果 edit 工具顯示 45 次接受和 5 次拒絕，則接受率為 90%。
### 日期參數使用哪個時區？
所有日期皆為 UTC。`starting_at` 參數應為 YYYY-MM-DD 格式，代表該日的 UTC 午夜。
## 另請參閱
Claude Code Analytics API 可協助您了解並最佳化團隊的開發工作流程。進一步了解相關功能：
* [Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api)
* [Admin API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization)
* [Claude Code 分析儀表板](https://platform.claude.com/claude-code)
* [使用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api) - 追蹤所有 Anthropic 服務的 API 使用量
* [合規 API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api) - 擷取稽核與活動資料
* [身分與存取管理](https://code.claude.com/docs/en/iam)
* [使用 OpenTelemetry 監控使用情況](https://code.claude.com/docs/zh-TW/monitoring-usage)，以取得自訂指標和警示