Analytics API

Anthropic 提供兩個 analytics API，您使用哪一個取決於您的組織管理哪個 Claude 產品：

• Claude Code Analytics API 為使用 Claude Platform 的組織回報每日 Claude Code 生產力指標。它是 Admin API 的一部分，並使用 Admin API 金鑰。
• Claude Enterprise Analytics API 為 Claude Enterprise 組織回報跨 Claude 產品（聊天、專案、Claude Code 等）的全組織參與度、採用率和成本資料。它使用在 claude.ai 中建立的 Analytics API 金鑰。

這兩個 API 使用不同的金鑰類型，由不同的角色在不同的地方建立。本頁說明哪個 API 適合您的組織，以及如何建立正確的金鑰。



您需要哪個 API？

這些金鑰類型不可互換：Admin API 金鑰無法呼叫 Claude Enterprise Analytics API，而 Analytics API 金鑰也無法呼叫 Admin API。兩個 API 都出現在 Admin API 參考文件下，但它們是具有不同金鑰類型的獨立 API。如果您的組織同時使用 Claude Platform 和 Claude Enterprise，您可以佈建兩種金鑰，並將每個 API 用於其各自的資料。



取得 Claude Code Analytics API 的存取權限

Claude Code Analytics API 可供所有具有 Admin API 存取權限的組織使用，且可免費使用。

有關可用的指標、請求參數和回應結構，請參閱 Claude Code Analytics API 指南和 API 參考文件。



取得 Claude Enterprise Analytics API 的存取權限

Claude Enterprise Analytics API 可供 Claude Enterprise 組織使用。所有 Enterprise 方案都提供參與度和採用率資料。成本和使用量端點適用於基於使用量的 Enterprise 方案；對於基於席次的 Enterprise 方案，它們僅反映使用額度。

Claude Enterprise Analytics API 提供：

• **使用者活動：**每位使用者在聊天（對話、訊息、專案、檔案、artifacts）、Claude Code（工作階段、提交、拉取請求、程式碼行數、工具操作）和其他 Claude 產品中的每日指標
• **活動摘要：**組織層級的每日、每週和每月活躍使用者、席次數量和待處理邀請
• **專案、技能和連接器使用情況：**聊天專案、技能和連接器的採用率細分
• **成本和使用量報告：**每位使用者和組織層級隨時間變化的 token 使用量和成本（基於使用量的 Enterprise 方案）

有關端點詳細資訊、參數和回應結構，請參閱 Claude Enterprise Analytics API 參考文件。以下各節涵蓋適用於這些端點的資料新鮮度、指標定義和操作指引。



資料可用性和新鮮度

Claude Enterprise Analytics API 資料適用於 2026 年 1 月 1 日或之後的日期。

參與度和採用率端點（使用者活動、摘要、專案、技能、連接器）會回傳您指定日期的每日快照。特定日期的資料會在次日 10

成本和使用量端點遵循不同的新鮮度模型。資料通常在底層使用量發生後四小時內可用，但最長可能需要 24 小時。隨著延遲事件的到達和對帳作業的執行，特定日期的數值可能在最多 30 天內被修訂。若需要發票等級的總計，請查詢至少 30 天前的日期。



指標如何定義

**活躍使用者。**如果符合以下任一條件，使用者即被計為當日活躍：他們在 Claude 中至少傳送了一則聊天訊息、他們至少有一個與您的 Claude Enterprise 組織相關聯且包含工具使用或 git 活動的 Claude Code 工作階段（本地或遠端），或者他們至少有一個包含工具使用或訊息活動的 Cowork 工作階段。

**每個產品的指標區塊。**每個產品的指標物件（例如，使用者活動記錄上的 Office Agent 或 Cowork 指標）始終存在於每筆記錄中。未使用該產品的組織會看到全為零的值，而非 null。

**連接器名稱。**連接器名稱會跨來源進行正規化。例如，Atlassian MCP server、mcp-atlassian 和 atlassian_MCP 在連接器使用情況端點中都顯示為 atlassian。



使用 API

**分頁游標綁定於發出它們的查詢。**在成本和使用量端點上，請勿在序列中途變更查詢參數：如果您變更 products[]、group_by[]、order_by、日期範圍或任何篩選條件並傳遞舊的游標，請求會回傳 400 錯誤。若要變更參數，請從第一頁重新開始，不帶游標。

**清單參數使用方括號表示法。**為每個值重複該參數，例如 products[]=chat&products[]=claude_code。

**金額欄位是以美分為單位的十進位字串。**貨幣金額以十進位字串回傳，例如 "41280.000000"（代表 $412.80）。若要轉換為美元，請解析為十進位數並除以 100。對於可能超過數百萬美元的值，請避免使用二進位浮點數解析。

速率限制適用於組織層級，而非每個金鑰，此 API 中所有端點的預設值為每分鐘 60 個請求。如果這不足以滿足您的使用案例，請聯絡您的 Anthropic 客戶團隊討論調整限制。



已知限制

如果您的組織透過 Amazon Bedrock 使用 Claude Code，Claude Enterprise Analytics API 不會回傳該使用量的 Claude Code 活動。



後續步驟