跳至主要內容

開始使用 Claude Enterprise Analytics API

Analytics API 為 Enterprise 方案的主要擁有者提供對其組織的參與度、採用率、使用情況和成本資料的程式設計存取。使用它來建立內部儀表板、追蹤採用趨勢、根據您的月度帳單調和支出,以及將 Claude 資料匯入您現有的報告工具。

Analytics API 適用於 Enterprise 方案。主要擁有者可以產生 API 金鑰以開始使用。

這與分析儀表板和 Compliance API 有何不同?

這三個選項都能讓您以不同的方式查看組織的資料:

Analytics 儀表板(透過 Analytics 存取)在產品中顯示視覺化的使用資料。當您不需要在其他地方整合資料時,這是日常監控的合適工具。

Analytics API 以程式設計方式傳回相同的彙總指標 — 因此您可以將它們拉入 BI 工具、對應到組織結構圖、自動化報告工作流程,以及根據內部記錄調和成本資料。參與度和採用率資料按組織、按日期彙總。使用情況和成本資料可用於更細粒度的按使用者和時間分組的細目。

Compliance API 用於治理和稽核用例。它讓您可以存取個別使用者操作、原始活動事件和對話內容。如果您需要用於儀表板的彙總參與度指標,而不是用於稽核的原始事件,請使用 Analytics API。


開始使用

若要存取 Analytics API,您需要對 Enterprise 組織具有主要擁有者存取權限。

請遵循以下步驟:

  1. Analytics API 下找到 Access 切換開關並將其打開。

  2. 按一下「+ 建立金鑰」以產生新的 API 金鑰。保持此金鑰私密 — 將其視為密碼。

  3. 在您的請求中使用帶有 x-api-key 標頭的金鑰。

如需完整的驗證詳細資訊、端點參考和程式碼範例,請參閱我們的 Claude Enterprise Analytics API 參考指南


有哪些資料可用?

Analytics API 包括跨兩個類別的九個端點。

參與度和採用率

這些端點傳回彙總的參與度指標,按組織、按日期。資料可用於過去 90 天內(不早於 2026 年 1 月 1 日)。

  • 使用者活動:跨 Claude 表面的按使用者參與度指標。包括對話計數、已傳送的訊息、建立的專案、上傳的檔案、建立的成品、使用的技能、使用的連接器、Claude Code 指標(如提交、拉取請求和程式碼行),以及 Cowork 指標(如已啟動的工作階段、工具操作、分派輪次,以及技能和連接器叫用)。

  • 活動摘要:跨 Claude、Claude Code 和 Cowork 的組織範圍內每日、每週和每月活躍使用者計數,以及座位使用率和待處理邀請計數。支援每個請求最多 31 天的日期範圍。

  • Chat 專案使用情況:按專案細分的對話和使用者計數,適用於 Claude 專案。

  • 技能使用情況:有多少使用者在使用每項技能,並分別針對 Claude、Claude Code 和 Cowork 工作階段進行細目。

  • 連接器使用情況:您的組織正在使用哪些連接器,以及有多少唯一使用者使用過每個連接器,並分別針對 Claude、Claude Code 和 Cowork 工作階段進行細目。

使用情況和成本

注意:成本和使用情況端點適用於基於使用量的 Enterprise 方案。對於基於座位的 Enterprise 方案,這些端點將僅反映額外使用情況。

這些端點(目前以測試版提供)傳回跨 Claude 表面的代幣使用情況和美元成本資料。使用它們來追蹤月度發票之間的使用情況、根據內部成本中心調和 Anthropic 帳單,以及根據實際使用者行為通知支出限制。

  • 按使用者的代幣使用情況:按日期範圍內的代幣使用情況排名的使用者,可選擇按產品、模型、內容視窗、推論區域或速度進行細目。

  • 按使用者的成本:按日期範圍內的美元支出排名的使用者,可選擇按產品、模型、成本類型(代幣、網路搜尋、程式碼執行)或代幣類型進行細目。

  • 一段時間內的代幣使用情況:按分鐘、小時或日期分組的代幣使用情況,可選擇按產品、模型、內容視窗、推論區域或速度進行細目。

  • 一段時間內的成本:按分鐘、小時或日期分組的美元成本,具有相同的分組選項加上成本類型和代幣類型。

資料每四小時重新整理一次,可能需要長達 24 小時。值可在 30 天內進行修訂,因為延遲事件會進行調和,因此對於發票級別的總計,請查詢至少 30 天前的日期。


資料限制

參與度和採用率端點傳回單一日期或日期範圍的資料。資料僅在 2026 年 1 月 1 日之後可用,以及三天前的日期。

使用情況和成本端點讓您查詢最多 31 天的視窗,可回溯至今天之前 365 天。對於發票級別的總計,請查詢至少 30 天前的日期,以便延遲事件有時間進行調和。

API 的預設速率限制為每分鐘 60 個請求。如果這不符合您組織的需求,請聯絡您的 Anthropic 聯絡人或我們的 銷售團隊

重要:如果您透過 Amazon Bedrock 使用 Claude Code,Analytics API 將不會傳回與 Claude Code 相關的資料。

是否回答了您的問題?