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 分析管理員 API 提供對 Claude Code 使用者每日彙總使用指標的程式存取，使組織能夠分析開發人員生產力並建立自訂儀表板。此 API 彌補了我們基本 分析儀表板 和複雜 OpenTelemetry 整合之間的差距。 此 API 使您能夠更好地監控、分析和最佳化您的 Claude Code 採用：
  • 開發人員生產力分析： 追蹤使用 Claude Code 建立的工作階段、新增/移除的程式碼行數、提交和拉取請求
  • 工具使用指標： 監控不同 Claude Code 工具（編輯、寫入、NotebookEdit）的接受和拒絕率
  • 成本分析： 檢視按 Claude 模型分類的估計成本和代幣使用情況
  • 自訂報告： 匯出資料以建立主管儀表板和管理團隊報告
  • 使用情況正當化： 提供指標以正當化和擴展內部 Claude Code 採用
需要管理員 API 金鑰此 API 是 管理員 API 的一部分。這些端點需要管理員 API 金鑰（以 sk-ant-admin... 開頭），與標準 API 金鑰不同。只有具有管理員角色的組織成員才能透過 Claude 控制台 佈建管理員 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 分析 API

使用 /v1/organizations/usage_report/claude_code 端點追蹤整個組織的 Claude Code 使用情況、生產力指標和開發人員活動。

​
主要概念

  • 每日彙總：傳回由 starting_at 參數指定的單一日期的指標
  • 使用者層級資料：每筆記錄代表一個使用者在指定日期的活動
  • 生產力指標：追蹤工作階段、程式碼行數、提交、拉取請求和工具使用情況
  • 代幣和成本資料：監控按 Claude 模型分類的使用情況和估計成本
  • 基於遊標的分頁：使用不透明遊標透過穩定分頁處理大型資料集
  • 資料新鮮度：指標可在完成後最多 1 小時內取得，以確保一致性
如需完整的參數詳細資訊和回應架構，請參閱 Claude Code 分析 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字串是YYYY-MM-DD 格式的 UTC 日期。僅傳回此單一日期的指標
limit整數否每頁記錄數（預設值：20，最大值：1000）
page字串否來自先前回應的 next_page 欄位的不透明遊標代幣

​
可用指標

每個回應記錄包含單一使用者在單一日期的以下指標：

​
維度

  • 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：使用者接受/拒絕的編輯工具提案數
  • write_tool.accepted/rejected：使用者接受/拒絕的寫入工具提案數
  • notebook_edit_tool.accepted/rejected：使用者接受/拒絕的 NotebookEdit 工具提案數

​
模型分類

對於使用的每個 Claude 模型：
  • model：Claude 模型識別碼（例如 claude-sonnet-4-5-20250929）
  • tokens.input/output：此模型的輸入和輸出代幣計數
  • tokens.cache_read/cache_creation：此模型的快取相關代幣使用情況
  • estimated_cost.amount：此模型的估計成本（以美分 USD 計）
  • 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-sonnet-4-5-20250929",
          "tokens": {
            "input": 100000,
            "output": 35000,
            "cache_read": 10000,
            "cache_creation": 5000
          },
          "estimated_cost": {
            "currency": "USD",
            "amount": 1025
          }
        }
      ]
    }
  ],
  "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 整合。

​
資料中如何識別使用者？

使用者透過 actor 欄位以兩種方式識別：
  • 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 分析 API 對所有有權存取管理員 API 的組織免費使用。

​
我如何計算工具接受率？

工具接受率 = accepted / (accepted + rejected)（針對每種工具類型）。例如，如果編輯工具顯示 45 個已接受和 5 個已拒絕，接受率為 90%。

​
日期參數使用什麼時區？

所有日期均為 UTC。starting_at 參數應為 YYYY-MM-DD 格式，代表該日期的 UTC 午夜。

​
另請參閱

Claude Code 分析 API 幫助您了解和最佳化團隊的開發工作流程。深入了解相關功能：