--- 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 分析 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 分析 API** | Admin API 金鑰（`sk-ant-admin01-...`） | Claude Console 中的[管理員金鑰](https://platform.claude.com/settings/admin-keys)頁面（`platform.claude.com/settings/admin-keys`） | 組織管理員 | 每位使用者的每日 Claude Code 指標：工作階段、程式碼行數、提交、拉取請求、工具接受率，以及依模型估算的成本 | | **Claude Enterprise Analytics API** | Analytics API 金鑰 | [claude.ai > 組織設定 > API](https://claude.ai/admin-settings/api-access) | 主要擁有者 | 全組織參與度與採用情況（使用者活動、活躍使用者摘要、專案、技能與連接器使用情況），以及成本與用量報告 | 這兩種金鑰類型無法互換：Admin API 金鑰無法呼叫 Claude Enterprise Analytics API，而 Analytics API 金鑰也無法呼叫 Admin API。唯一的例外是[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api)，Claude Enterprise 組織會使用其 Analytics API 金鑰呼叫此 API。兩個產品分析 API 都列在 [Admin API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization)之下，但它們是使用不同金鑰類型的獨立 API。如果您的組織同時使用 Claude Platform 與 Claude Enterprise，您可以佈建兩種金鑰，並使用各個 API 取得其各自的資料。 想要取得 token 用量與成本資料，而非產品分析資料嗎？請參閱[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-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" \ -H "anthropic-version: 2026-10-21" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` 關於可用的指標、請求參數與回應結構描述，請參閱 [Claude Code 分析 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 > 組織設定 > 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 方案） `/v1/organizations/analytics/` 下的成本與用量報告端點（`usage_report`、`cost_report`、`user_usage_report` 與 `user_cost_report`）為舊版端點，但仍受支援。對於新的整合，請使用[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api)。若要遷移現有整合，請參閱[從 Claude Enterprise 用量與成本報告遷移](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api#migrate-from-enterprise-analytics-reports)。其他 Claude Enterprise Analytics API 端點並非舊版端點。 如需端點詳細資訊、參數與回應結構描述，請參閱 [Claude Enterprise Analytics API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics)。以下各節涵蓋適用於這些端點的資料新鮮度、指標定義與操作指引。 ## 資料可用性與新鮮度 Claude Enterprise Analytics API 資料適用於 2026 年 1 月 1 日當天或之後的日期。 **參與度與採用端點**（使用者活動、摘要、專案、技能、連接器）會回傳您指定日期的每日快照。特定日期的資料通常會在隔天 UTC 時間約 13:00–13:30 前提供（1 天延遲）。在此之前，最近可用的日期通常是目前 UTC 日期的 2 天前。當上游資料管線延遲執行時，資料會較晚抵達，且確切的新鮮度會因查詢而異。請勿假設固定時間，而應檢查錯誤回應：請求尚未可用的日期會回傳 400 錯誤，並指出最近可用的日期。如果資料在遠超過一般延遲時間後仍無法使用，通常表示 Anthropic 端的資料管線發生故障；如果缺口持續存在，請聯繫支援團隊。 **成本與用量端點**採用不同的新鮮度模型。資料通常會在實際用量發生後 4 小時內提供，但最多可能需要 24 小時。在延遲事件抵達及對帳執行期間，數值可能會被修訂，直到日曆月結束後約 7 天為止。例如，10 月 1 日的數值可能會變動到約 11 月 7 日。若需要可用於開立發票的總計，請僅查詢已結束至少 7 天的月份。 成本與用量回應包含 `data_refreshed_at` 時間戳記。如果您省略 `ending_at`，其預設值為 `starting_at` 之後 31 天或目前時間，以較早者為準。該範圍可能超過 `data_refreshed_at`，而該時間之後的資料並不完整。若要在重複呼叫之間取得穩定的結果，請將 `ending_at` 設定為等於或早於先前回傳之 `data_refreshed_at` 的值。 ## 指標的定義方式 **活躍使用者。**若以下任一條件成立，使用者即被計為當天的活躍使用者： * 他們在 Claude 中至少傳送了一則聊天訊息。 * 他們至少有一個與您的 Claude Enterprise 組織相關聯、且包含工具使用或 git 活動的 Claude Code 工作階段（本機或遠端）。 * 他們至少有一個包含工具使用或訊息活動的 Cowork 工作階段。 **Chat and Cowork unified。**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 數據中。使用者開始使用 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：在未提供此功能的部署中，其欄位會從回應中省略。這些物件中的個別欄位可能為 `null`，表示該值無法取得。例如，當您依專案篩選使用者活動時，`chat_metrics` 中的 `distinct_skills_used_count` 為 `null`。[Claude Enterprise Analytics API 參考文件](https://platform.claude.com/docs/zh-TW/api/beta/organization/analytics)會標示哪些欄位可能為 `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` 標頭；如需可用版本，請參閱[版本](https://platform.claude.com/docs/zh-TW/api/versioning)。 ## 已知限制 ### 透過 Amazon Bedrock 使用的 Claude Code 如果您的組織透過 Amazon Bedrock 使用 Claude Code，Claude Enterprise Analytics API 不會回傳該用量的 Claude Code 活動。 ### 使用客戶管理加密金鑰的 Claude Code 與 Cowork 如果您的組織使用[客戶管理的加密金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)，Anthropic 會在其用量分析中省略部分 Claude Code 與 Cowork 使用細節，以保護您的資料。因此，請勿使用以下 Claude Enterprise Analytics API 數字來衡量您的組織使用 Claude Code 或 Cowork 的程度。這些數字可能為零或低於實際使用量： * **程式碼變更：**在使用者活動中，`claude_code_metrics.core_metrics` 中的這些欄位可能為零：`lines_of_code`（新增與移除的行數）和 `commit_count`。`pull_request_count` 欄位可能低於實際的拉取請求數量。 * **以斜線指令啟動的技能：**如果使用者在 Claude Code 或 Cowork 中輸入斜線指令（例如 `/skill-name`）來啟動技能，該次使用不會被計入。這適用於技能使用情況，以及使用者活動中的 Cowork 技能計數。Claude 在沒有斜線指令的情況下呼叫的技能仍會被計入。 關於使用客戶管理加密金鑰時的其他分析變更，請參閱 [CMEK 在 Claude Enterprise 上涵蓋的範圍](https://platform.claude.com/docs/zh-TW/manage-claude/cmek-coverage-claude-enterprise#turned-off-or-changed)。 ## 後續步驟 使用 Admin API 金鑰追蹤 Claude Code 工作階段、程式碼變更與工具使用情況。 追蹤您組織的 token 用量與成本。 參與度、採用與成本資料的端點參考文件。 稽核與合規資料使用其專屬的金鑰類型。