管理監控

分析 API

Copy page



了解您的組織需要哪一種分析 API 與 API 金鑰，然後佈建對 Claude Code 生產力指標或 Claude Enterprise 參與度與採用資料的存取權限。

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 存取權限的組織使用，且免費使用。

1. 1

   建立 Admin API 金鑰

   請依照建立 Admin API 金鑰中的步驟操作。

2. 2

   呼叫 API

   在 x-api-key 標頭中傳遞金鑰：

   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: $ANTHROPIC_ADMIN_KEY"

   

如需可用的指標、請求參數與回應結構描述，請參閱 Claude Code Analytics API 指南與 API 參考文件。

取得 Claude Enterprise Analytics API 的存取權限

Claude Enterprise Analytics API 可供 Claude Enterprise 組織使用。參與度與採用資料在所有 Enterprise 方案中皆可使用。成本與用量端點適用於以用量計費的 Enterprise 方案；對於以席次計費的 Enterprise 方案，這些端點僅反映用量點數。

1. 1

   以主要擁有者身分登入

   只有組織的主要擁有者可以啟用 API 存取並建立 Analytics API 金鑰。

2. 2

   啟用 API 存取並建立金鑰

   前往 claude.ai > Organization settings > API 並啟用公開 API 存取，然後建立 Analytics API 金鑰。金鑰具有 read:analytics 範圍。請複製顯示的密鑰並將其儲存在您的密鑰管理工具中。

3. 3

   呼叫 API

   在 x-api-key 標頭中傳入金鑰，並在每個請求中加入 anthropic-version 標頭。端點位於 https://api.anthropic.com/v1/organizations/analytics/ 之下。如需請求範例、參數與回應結構描述，請參閱 Claude Enterprise Analytics API 參考。

Claude Enterprise Analytics API 提供：

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

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

資料可用性與新鮮度

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

參與度與採用端點（使用者活動、摘要、專案、技能、連接器）會傳回您所指定日期的每日快照。特定日期的資料通常會在隔天約 17:00 UTC 起提供（延遲 1 天）；在此之前，最近可用的日期通常是目前 UTC 日期的前兩天。資料偶爾會較晚送達，且確切的新鮮度會因查詢而異，因此與其假設固定時間，不如檢查錯誤回應：請求尚未提供的日期時，會傳回 400 錯誤，並指出最近可用的日期。如果資料在遠超過一般延遲時間後仍無法取得，通常表示 Anthropic 端的資料管線發生故障；若缺漏持續存在，請聯絡支援團隊。

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

指標的定義方式

活躍使用者。若符合下列任一條件，使用者即計為當日活躍：他們在 Claude 中傳送了至少一則聊天訊息；他們有至少一個與您的 Claude Enterprise 組織相關聯、且包含「tool use」（工具使用）或 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。對於可能超過數百萬美元的數值，請避免使用二進位浮點數解析。

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

版本控制

請在每個請求中傳送 anthropic-version 標頭；如需可用版本，請參閱 API 版本。

已知限制

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

後續步驟