--- title: 分析 API url: https://platform.claude.com/docs/zh-TW/manage-claude/analytics-api description: 了解您的組織需要哪一種分析 API 與 API 金鑰，然後佈建對 Claude Code 生產力指標或 Claude Enterprise 參與度與採用資料的存取權限。 --- Anthropic 提供兩種分析 API，您使用哪一種取決於您的組織管理的是哪一項 Claude 產品： * **Claude Code Analytics API** 為使用 Claude Platform 的組織回報每日 Claude Code 生產力指標。它是 [Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api) 的一部分，並使用 Admin API 金鑰。 * **Claude Enterprise Analytics API** 為 Claude Enterprise 組織回報橫跨各項 Claude 產品（聊天、專案、Claude Code 等）的全組織參與度、採用與成本資料。它使用在 claude.ai 中建立的 Analytics API 金鑰。 這兩種 API 使用不同的金鑰類型，由不同角色在不同位置建立。本頁說明哪一種 API 適合您的組織，以及如何建立正確的金鑰。 ## 您需要哪一種 API？ | API | 金鑰類型 | 建立位置 | 誰可以建立 | 涵蓋內容 | | ----------------------------------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- | ----- | ----------------------------------------------------------- | | **Claude Code Analytics API** | Admin API 金鑰（`sk-ant-admin01-...`） | Claude Console 中的 [Admin keys](https://platform.claude.com/settings/admin-keys) 頁面（`platform.claude.com/settings/admin-keys`） | 組織管理員 | 每位使用者的每日 Claude Code 指標：工作階段、程式碼行數、提交、拉取請求、工具接受率，以及依模型估算的成本 | | **Claude Enterprise Analytics API** | Analytics API 金鑰 | [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) | 主要擁有者 | 全組織參與度與採用情況（使用者活動、活躍使用者摘要、專案、技能與連接器使用情況），以及成本與用量報告 | 這兩種金鑰類型無法互換：Admin API 金鑰無法呼叫 Claude Enterprise Analytics API，而 Analytics API 金鑰也無法呼叫 Admin API。兩個 API 都列在 [Admin API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization)之下，但它們是使用不同金鑰類型的獨立 API。如果您的組織同時使用 Claude Platform 與 Claude Enterprise，您可以佈建兩種金鑰，並使用各個 API 取得其各自的資料。 您要找的是 API 用量與成本資料，而非產品分析資料嗎？請參閱 [Usage and Cost API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api) ，其中說明了適用於 Claude Console 與 Claude Enterprise 組織的正確途徑。 如果您想在產品中檢視參與度與採用資料，而非以程式化方式取得，請使用 claude.ai 中的[分析儀表板](https://claude.ai/analytics/activity)。若為治理與稽核使用情境（個別使用者動作、原始活動事件、對話內容），請參閱 [Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access)。 ## 取得 Claude Code Analytics API 的存取權限 Claude Code Analytics API 可供所有具有 [Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api) 存取權限的組織使用，且免費使用。 請依照[建立 Admin API 金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api-keys#create-a-key-for-a-claude-console-organization)中的步驟操作。 在 `x-api-key` 標頭中傳遞金鑰： ```bash 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 指南](https://platform.claude.com/docs/zh-TW/manage-claude/claude-code-analytics-api)與 [API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization/usage_report/retrieve_claude_code)。 ## 取得 Claude Enterprise Analytics API 的存取權限 Claude Enterprise Analytics API 可供 Claude Enterprise 組織使用。參與度與採用資料在所有 Enterprise 方案中皆可使用。成本與用量端點適用於以用量計費的 Enterprise 方案；對於以席次計費的 Enterprise 方案，這些端點僅反映用量點數。 只有組織的主要擁有者可以啟用 API 存取並建立 Analytics API 金鑰。 前往 [claude.ai > Organization settings > API](https://claude.ai/admin-settings/api-access) 並啟用公開 API 存取，然後建立 Analytics API 金鑰。金鑰具有 `read:analytics` 範圍。請複製顯示的密鑰並將其儲存在您的密鑰管理工具中。 在 `x-api-key` 標頭中傳入金鑰，並在每個請求中加入 [`anthropic-version`](https://platform.claude.com/docs/zh-TW/api/versioning) 標頭。端點位於 `https://api.anthropic.com/v1/organizations/analytics/` 之下。如需請求範例、參數與回應結構描述，請參閱 [Claude Enterprise Analytics API 參考](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics)。 Claude Enterprise Analytics API 提供： * **使用者活動：**跨聊天（對話、訊息、專案、檔案、Artifacts）、Claude Code（工作階段、提交、拉取請求、程式碼行數、工具動作）、Chat and Cowork unified（聊天活動與 Cowork 工作階段）以及其他 Claude 產品的每位使用者每日指標 * **活動摘要：**組織層級的每日、每週與每月活躍使用者、席次數量與待處理邀請 * **專案、技能與連接器使用情況：**聊天專案、技能與連接器的採用細項 * **成本與用量報告：**每位使用者與組織層級隨時間變化的 token 用量與成本（以用量計費的 Enterprise 方案） 如需端點詳細資訊、參數與回應結構描述，請參閱 [Claude Enterprise Analytics API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics)。以下各節涵蓋適用於這些端點的資料新鮮度、指標定義與操作指引。 ## 資料可用性與新鮮度 Claude Enterprise Analytics API 資料適用於 2026 年 1 月 1 日當天或之後的日期。 **參與度與採用率端點**（使用者活動、摘要、專案、技能、連接器）會傳回您指定日期的每日快照。特定日期的資料通常會在隔天約 13:00–13:30 UTC 之前提供（延遲 1 天）；在此之前，最近可用的日期通常是目前 UTC 日期的前兩天。當上游資料管線延遲執行時，資料會較晚送達，且確切的新鮮度因查詢而異，因此請勿假設固定時間，而應檢查錯誤回應：請求尚未可用的日期會傳回 400 錯誤，並指出最近可用的日期。如果資料在遠超過一般延遲時間後仍無法取得，通常表示 Anthropic 端的資料管線發生故障；如果缺漏持續存在，請聯絡支援團隊。 **成本與用量端點**採用不同的新鮮度模型。資料通常會在實際使用後四小時內提供，但最多可能需要 24 小時。隨著延遲事件送達和對帳作業執行，數值可能會被修訂，直到該日曆月結束後約 7 天為止。例如，10 月 1 日的數值可能會變動至約 11 月 7 日。若需要可用於開立發票的總計，請僅查詢已結束至少 7 天的月份。 成本與用量回應包含 `data_refreshed_at` 時間戳記。當省略 `ending_at`（預設為目前時間）時，回應會包含 `data_refreshed_at` 之後一段尚不完整的尾端資料。若要在重複呼叫之間取得穩定的結果，請將 `ending_at` 設定為等於或早於先前回傳之 `data_refreshed_at` 的值。 ## 指標的定義方式 **活躍使用者。**若符合下列任一條件，使用者即計為當日活躍：他們在 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 版本](https://platform.claude.com/docs/zh-TW/api/versioning)。 ## 已知限制 如果您的組織透過 Amazon Bedrock 使用 Claude Code，Claude Enterprise Analytics API 不會回傳該用量的 Claude Code 活動。 ## 後續步驟 使用 Admin API 金鑰追蹤 Claude Code 工作階段、程式碼變更與工具使用情況。 追蹤您組織的 API token 用量與成本。 參與度、採用與成本資料的端點參考文件。 稽核與合規資料使用其專屬的金鑰類型。