管理监控

分析 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 产品
• 活动摘要： 组织级别的每日、每周和每月活跃用户、席位数量和待处理邀请
• 项目、技能和连接器使用情况： 聊天项目、技能和连接器的采用情况细分
• 成本和使用报告：每位用户和组织级别随时间变化的令牌使用量和成本（基于用量的 Enterprise 计划）

有关端点详情、参数和响应架构，请参阅 Claude Enterprise Analytics API 参考。以下各节介绍适用于这些端点的数据新鲜度、指标定义和操作指南。

数据可用性和新鲜度

Claude Enterprise Analytics API 数据适用于 2026 年 1 月 1 日及之后的日期。

参与度和采用情况端点（用户活动、摘要、项目、技能、连接器）返回您指定日期的每日快照。某一天的数据通常在次日 UTC 时间约 13:00–13:30 之前可用（1 天延迟）；在此之前，最近可用的日期通常是当前 UTC 日期的前两天。当上游数据管道运行延迟时，数据到达时间会更晚，且确切的 "data freshness"（数据新鲜度）因查询而异，因此请不要假定固定时间，而应检查错误响应：请求尚不可用的日期会返回 400 错误，其中会指明最近可用的日期。如果数据在远超常规延迟后仍不可用，通常表示 Anthropic 一侧的数据管道出现故障；如果缺口持续存在，请联系支持团队。

成本和使用端点遵循不同的新鲜度模型。数据通常在底层使用发生后四小时内可用，但最长可能需要 24 小时。随着延迟事件到达和对账运行，数值可能会被修订，直到日历月结束后约 7 天为止。例如，10 月 1 日的数值可能会变化到约 11 月 7 日。如需达到开票级别的总计，请仅查询至少 7 天前已结束的月份。

指标的定义方式

活跃用户。 如果满足以下任一条件，则用户在某一天被计为活跃：他们在 Claude 中发送了至少一条聊天消息；他们有至少一个与您的 Claude Enterprise 组织关联的、包含工具使用或 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 下。组织范围的数据（例如总令牌使用量、总成本和总体活跃用户数）不会改变。按产品筛选的成本和使用报告不包含 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。对于可能超过数百万美元的数值，请避免使用二进制浮点解析。

速率限制在组织级别应用，而非按密钥应用，此 API 中所有端点的默认限制为每分钟 60 个请求。如果这不足以满足您的用例，请联系您的 Anthropic 客户团队讨论调整限制。

版本控制

在每个请求中发送 anthropic-version 标头；有关可用版本，请参阅 API 版本。

已知限制

如果您的组织通过 Amazon Bedrock 使用 Claude Code，Claude Enterprise Analytics API 不会返回该使用情况的 Claude Code 活动。

后续步骤