跳转到主要内容

开始使用 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. 点击"+ Create key"生成新的 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 相关的数据。

这是否解答了您的问题?