Claude Code 分析 API

Claude Code Analytics Admin API 提供以程式化方式存取 Claude Code 使用者每日彙總使用指標的功能，讓組織能夠分析開發人員生產力並建立自訂儀表板。此 API 提供比基本分析儀表板更詳細的資訊，且不需要 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"

請求參數

可用指標

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

維度

• 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 以下列格式傳回資料：

{
  "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 小時的資料。

我可以取得即時指標嗎？