管理監控

分析 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（工作階段、提交、拉取請求、程式碼行數、工具動作）、Chat and Cowork unified（聊天活動與 Cowork 工作階段）以及其他 Claude 產品的每位使用者每日指標
• 活動摘要：組織層級的每日、每週與每月活躍使用者、席次數量與待處理邀請
• 專案、技能與連接器使用情況：聊天專案、技能與連接器的採用細項
• 成本與用量報告：每位使用者與組織層級隨時間變化的 token 用量與成本（以用量計費的 Enterprise 方案）

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

資料可用性與新鮮度

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

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

成本與用量端點採用不同的新鮮度模型。資料通常會在實際使用後四小時內提供，但最多可能需要 24 小時。隨著延遲事件送達和對帳作業執行，數值可能會被修訂，直到該日曆月結束後約 7 天為止。例如，10 月 1 日的數值可能會變動至約 11 月 7 日。若需要可用於開立發票的總計，請僅查詢已結束至少 7 天的月份。

指標的定義方式

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

Chat and Cowork unified（beta）。Chat and Cowork unified 將 Cowork 的功能帶入 claude.ai 聊天中。Chat and Cowork unified 中的大部分活動會以 chat_cowork_unified 產品值回報，而非 chat 或 cowork。

在使用者活動以及技能、連接器與外掛程式使用情況中，此用量會出現在 chat_cowork_unified_metrics 物件中。在活動摘要中，它會計入 chat_cowork_unified_daily_active_user_count、chat_cowork_unified_weekly_active_user_count 與 chat_cowork_unified_monthly_active_user_count。

隨著越來越多使用者開始使用 Chat and Cowork unified，用量會從您的聊天與 Cowork 數據移轉至這些新數據中。使用者開始使用 Chat and Cowork unified 之前的用量仍保留在聊天或 Cowork 之下。全組織的數據，例如總 token 用量、總成本與整體活躍使用者數，不會改變。依產品篩選的成本與用量報告會排除 Chat and Cowork unified 的用量，除非 products[] 包含 chat_cowork_unified。

Chat and Cowork unified 使用者的部分活動（例如語音模式）仍可能以聊天或 Cowork 回報。在使用者開始使用 Chat and Cowork unified 的當天，其活動也可能分散在不同產品之間。在為其關閉此功能的當天也是如此。活動的分配方式不受保證。

使用者可能同時出現在聊天或 Cowork 計數以及 Chat and Cowork unified 計數中。這可能發生在使用者使用 Chat and Cowork unified、但其部分活動仍以聊天或 Cowork 回報的當天。當時間範圍內同時有兩種活動時（即使發生在不同日期），每週與每月計數可能會將其同時計入兩者。例如，時間範圍可能涵蓋使用者開始使用 Chat and Cowork unified 之前與之後的日期。

當您依專案篩選使用者活動時，每天的專案活動只會計入一處。如果使用者當天在 Chat and Cowork unified 中傳送了聊天訊息，其所有專案活動都會計入 chat_cowork_unified_metrics.chat。否則，會計入 chat_metrics。

各產品指標區塊。各產品指標物件（例如使用者活動記錄中的 Office Agent 或 Cowork 指標）一律會出現在每筆記錄中。未使用該產品的組織會看到全為零的值，而非 null。例外是 Chat and Cowork unified：在未提供此功能的部署中，其欄位會從回應中省略。

連接器名稱。連接器名稱會跨來源進行正規化。例如，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 活動。

後續步驟