分析 API

Anthropic 提供两种分析 API，您应使用哪一种取决于您的组织所管理的 Claude 产品：

• Claude Code 分析 API 为使用 Claude Platform 的组织报告每日 Claude Code 生产力指标。它是 Admin API 的一部分，使用 Admin API 密钥。
• Claude Enterprise 分析 API 为 Claude Enterprise 组织报告跨 Claude 产品（聊天、项目、Claude Code 等）的组织级参与度、采用情况和成本数据。它使用在 claude.ai 中创建的分析 API 密钥。

这两种 API 使用不同的密钥类型，由不同角色在不同位置创建。本页介绍哪种 API 适合您的组织，以及如何创建正确的密钥。



您需要哪种 API？

这两种密钥类型不可互换：Admin API 密钥无法调用 Claude Enterprise 分析 API，分析 API 密钥也无法调用 Admin API。这两种 API 都列在 Admin API 参考文档下，但它们是使用不同密钥类型的独立 API。如果您的组织同时使用 Claude Platform 和 Claude Enterprise，您可以配置两种密钥，并分别使用各自的 API 获取相应数据。



获取 Claude Code 分析 API 的访问权限

Claude Code 分析 API 对所有可访问 Admin API 的组织开放，且免费使用。

有关可用指标、请求参数和响应架构，请参阅 Claude Code 分析 API 指南和 API 参考文档。



获取 Claude Enterprise 分析 API 的访问权限

Claude Enterprise 分析 API 面向 Claude Enterprise 组织提供。参与度和采用情况数据在所有 Enterprise 套餐中均可用。成本和用量端点适用于基于用量的 Enterprise 套餐；对于基于席位的 Enterprise 套餐，这些端点仅反映用量额度。

Claude Enterprise 分析 API 提供以下内容：

• 用户活动： 每位用户在聊天（对话、消息、项目、文件、Artifacts）、Claude Code（会话、提交、拉取请求、代码行数、工具操作）及其他 Claude 产品中的每日指标
• 活动摘要： 组织级的每日、每周和每月活跃用户数、席位数和待处理邀请数
• 项目、技能和连接器使用情况： 聊天项目、技能和连接器的采用情况细分
• 成本和用量报告： 每位用户和组织级的令牌用量及随时间变化的成本（适用于基于用量的 Enterprise 套餐）

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



数据可用性和新鲜度

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

参与度和采用情况端点（用户活动、摘要、项目、技能、连接器）返回您指定日期的每日快照。给定日期的数据会在次日 10

成本和用量端点遵循不同的新鲜度模型。数据通常在底层用量发生后四小时内可用，但最长可能需要 24 小时。随着延迟事件的到达和对账的运行，给定日期的数值可能在最长 30 天内被修订。如需获取发票级别的总计数据，请查询至少 30 天前的日期。



指标定义方式

活跃用户。 如果满足以下任一条件，则用户在当天被计为活跃：他们在 Claude 中发送了至少一条聊天消息；他们有至少一个与您的 Claude Enterprise 组织关联的 Claude Code 会话（本地或远程），且该会话包含工具使用或 git 活动；或者他们有至少一个包含工具使用或消息活动的 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 分析 API 不会返回该用量对应的 Claude Code 活动。



后续步骤