Claude Code 分析 API
透過 Claude Code Analytics Admin API，以程式化方式存取您組織的 Claude Code 使用分析與生產力指標。
Claude Code Analytics Admin API 提供以程式化方式存取 Claude Code 使用者每日彙總使用指標的功能，讓組織能夠分析開發人員生產力並建立自訂儀表板。此 API 提供比 Claude Console 中的基本分析儀表板更詳細的資訊，且不需要 OpenTelemetry 整合的複雜設定。
此 API 可協助您更好地監控、分析和最佳化您的 Claude Code 採用情況：
- 開發人員生產力分析： 追蹤使用 Claude Code 建立的工作階段、新增/移除的程式碼行數、commit 和 pull request
- 工具使用指標： 監控不同 Claude Code 工具（Edit、MultiEdit、Write、NotebookEdit）的接受率與拒絕率
- 成本分析： 檢視依 Claude 模型細分的預估成本和 token 使用量
- 自訂報告： 匯出資料以為管理團隊建立高階主管儀表板和報告
- 使用合理性說明： 提供指標以在內部說明並擴大 Claude Code 的採用
快速入門
取得您組織在特定日期的 Claude Code 分析資料：
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"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 參考文件。
基本範例
取得特定日期的分析資料
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"使用分頁取得分析資料
# 第一個請求
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或subscription）；記錄僅涵蓋針對您的 Claude Console 組織進行驗證的使用量 - 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 以下列格式傳回資料：
{
"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 支援基於游標的分頁，適用於擁有大量使用者的組織：
- 發出初始請求，可選擇性地加上
limit參數。 - 如果回應中的
has_more為true，請在下一個請求中使用next_page值。 - 持續進行，直到
has_more為false。
游標會編碼最後一筆記錄的位置，即使有新資料到達，也能確保穩定的分頁。每個分頁工作階段都會維持一致的資料邊界，以確保您不會遺漏或重複記錄。
常見使用案例
- 高階主管儀表板： 建立高層級報告，呈現 Claude Code 對開發速度的影響
- AI 工具比較： 匯出指標，將 Claude Code 與 Copilot 和 Cursor 等其他 AI 程式設計工具進行比較
- 開發人員生產力分析： 隨時間追蹤個人和團隊的生產力指標
- 成本追蹤與分配： 監控支出模式，並依團隊或專案分配成本
- 採用情況監控： 找出哪些團隊和使用者從 Claude Code 獲得最大價值
- 投資報酬率說明： 提供具體指標，以在內部說明並擴大 Claude Code 的採用
常見問題
分析資料的新鮮度如何？
Claude Code 分析資料通常會在使用者活動完成後 1 小時內出現。為確保分頁結果一致，回應中僅包含超過 1 小時的資料。
我可以取得即時指標嗎？
不行，此 API 僅提供每日彙總指標。如需即時監控，請考慮使用 OpenTelemetry 整合。
資料中如何識別使用者？
使用者透過 actor 欄位以兩種方式識別：
user_actor： 包含透過 OAuth 驗證之使用者的email_address（最常見）api_actor： 包含使用 API 金鑰驗證之使用者的api_key_name
customer_type 欄位為 api 或 subscription。無論其值為何，每筆記錄都描述針對您的 Claude Console 組織進行驗證的使用量。
此 API 是否包含來自 Claude 訂閱方案的使用量？
不包含。當有人使用 Claude 訂閱方案（例如 Pro、Max、Team 或 Enterprise）登入 Claude Code 時，其使用量會歸屬於其 claude.ai 組織，此 API 不會傳回該使用量。
若要追蹤該使用量，請使用下列其中一個選項：
- Claude Enterprise Analytics API： 回報 Claude Enterprise 組織的 Claude Code 活動，其他方案無法使用。請參閱分析 API。
- claude.ai 中的分析儀表板： 適用於 Team 和 Enterprise 方案。請參閱使用分析追蹤團隊使用情況。
- OpenTelemetry 匯出： 適用於任何方案。請參閱使用 OpenTelemetry 監控使用情況。
資料保留期限是多久？
歷史 Claude Code 分析資料會被保留，並可透過 API 存取。此資料沒有指定的刪除期限。
支援哪些 Claude Code 部署？
此 API 僅追蹤 Claude API 上的 Claude Code 使用情況。透過 Claude in Amazon Bedrock、Claude in Microsoft Foundry、Claude Models on Google Cloud 或 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
- Admin API 參考文件
- Claude Console 中的 Claude Code 分析儀表板
- 使用量與成本 API - 追蹤所有 Anthropic 服務的 API 使用量
- 合規 API - 擷取稽核與活動資料
- 身分與存取管理
- 使用 OpenTelemetry 監控使用情況，以取得自訂指標和警示
Was this page helpful?