分析 API

Anthropic 提供兩種分析 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 產品的每位使用者每日指標
• 活動摘要： 組織層級的每日、每週和每月活躍使用者、席位數量和待處理邀請
• 專案、技能和連接器使用情況： 聊天專案、技能和連接器的採用率細分
• 成本和使用量報告： 每位使用者和組織層級的權杖使用量和隨時間變化的成本（基於使用量的 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 活動。



後續步驟