Claude Platform Docs
  • Messages
  • Managed Agents
  • 管理

Search...
⌘K
組織
Admin API工作區
驗證
概覽建立 Admin API 金鑰Workload Identity Federation透過 API 管理 WIFWIF 參考
監控
Usage and Cost APIRate Limits APIAnalytics APIClaude Code Analytics APISpend Limits API
資料與合規
資料駐留API 與資料保留存取透明度
Compliance API
概覽取得存取權活動動態對話、檔案與專案組織、使用者、角色、群組與設定設計您的整合錯誤常見問題

Log in
Analytics API
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Claude Platform Docs

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Claude on AWS
  • Claude on Google Cloud

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
管理/監控

分析 API

了解您的組織需要哪個分析 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？

API金鑰類型建立位置可建立者涵蓋內容
Claude Code Analytics APIAdmin API 金鑰（sk-ant-admin01-...）Claude Console > Settings > Admin keys組織管理員每位使用者的每日 Claude Code 指標：工作階段、程式碼行數、提交、拉取請求、工具接受率，以及按模型估算的成本
Claude Enterprise Analytics APIAnalytics API 金鑰claude.ai > Organization settings > API主要擁有者全組織的參與度和採用率（使用者活動、活躍使用者摘要、專案、技能和連接器使用情況），以及成本和使用量報告

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



想尋找 API 使用量和成本資料，而非產品分析？請參閱 Usage and Cost API，其中說明了 Claude Console 和 Claude Enterprise 組織的正確途徑。



如果您想在產品中檢視參與度和採用率資料，而非以程式化方式取得，請使用 claude.ai 中的 Analytics 儀表板。對於治理和稽核使用案例（個別使用者動作、原始活動事件、對話內容），請參閱 Compliance 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: $ADMIN_API_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 標頭中傳遞金鑰。端點位於 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 日或之後的日期。

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

UTC 進行彙總，並在彙總後三天可供查詢。如果資料未在該時間範圍內提供，通常表示 Anthropic 端的資料管線發生故障；如果差距持續存在，請聯絡支援團隊。

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



成本和使用量回應包含 data_refreshed_at 時間戳記。當省略 ending_at 時（預設為目前時間），回應會包含 data_refreshed_at 之後的一段不完整資料。為了在重複呼叫中獲得穩定的結果，請將 ending_at 設定為等於或早於先前回傳的 data_refreshed_at 的值。

指標的定義方式

活躍使用者。 如果以下任一條件為真，則使用者在該日計為活躍：他們在 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 活動。

後續步驟

Claude Code Analytics API

使用 Admin API 金鑰追蹤 Claude Code 工作階段、程式碼變更和工具使用情況。

Usage and Cost API

追蹤您組織的 API token 使用量和成本。

Claude Enterprise Analytics API 參考文件

參與度、採用率和成本資料的端點參考。

取得 Compliance API 的存取權限

稽核和合規資料使用其專屬的金鑰類型。

Was this page helpful?

  • 您需要哪個 API？
  • 取得 Claude Code Analytics API 的存取權限
  • 取得 Claude Enterprise Analytics API 的存取權限
  • 資料可用性和新鮮度
  • 指標的定義方式
  • 使用 API
  • 已知限制
  • 後續步驟