Claude Platform Docs
管理Claude Platform OAuth

Claude Platform OAuth

让您的客户从其自己的 Claude 组织支付在您产品中产生的 Claude 用量费用。

Claude Platform OAuth 让您的用户可以将其在您应用内产生的用量计费到他们的 Claude 组织。

您可以构建什么

让客户为自己的 Claude 用量付费

当您的产品调用 Claude 时,用量可以计费到您客户自己的 Claude 组织。您的用户点击 Link your Claude organization 按钮,登录 Claude,并批准您的应用。对于 Linked billing,用户必须在其 Claude 组织中具有管理员或账单角色。

之后:

  • 您可以在每个 Claude API 请求上选择由客户付费还是由您付费。
  • 如果您标记为由客户付费的请求无法向客户计费,Claude API 会拒绝该请求,而不是向您计费。
  • 客户可以随时取消关联您的应用。
  • 您只能就客户指示您发出的请求向其计费,绝不能就您自己的用量向其计费。

您负责为您的客户提供支持:Anthropic 提供批准页面以及客户用于设置支出上限或取消关联您的应用的 Claude Console 页面,有关您的应用的所有其他问题都由您来处理。

Linked billing 适用于其 Claude 组织直接向 Anthropic 支付 API 用量费用的客户。它不适用于通过云市场计费的组织。请参阅 Linked billing。

工作原理

Linked billing 遵循一个简短的往返流程。用户离开您的产品,前往 Claude 的批准页面一次,在那里批准您的应用,然后返回:

浏览器
您的后端
auth.claude.com
点击“Link your Claude organization”
将用户​引导至 Claude 的批准页面
登录 Claude 并批准您的​应用
携带​一次性​授权码将​用户送回您的​产品
传递​授权码
交换​授权码
一个​连接 ID

批准页面会显示您应用的名称以及您的应用所请求的内容,让用户清楚自己正在批准什么。

一次性 OAuth 应用设置

Linked billing 从 Claude Console 中的以下一次性设置步骤开始。Linked billing 指南会引导您完成这些步骤。

  1. 创建应用。 您 Claude 组织中具有管理员角色的成员在 Claude Console 中创建一个 OAuth 应用并复制其客户端 ID。该应用包含用户在批准页面上看到的名称,以及他们返回到的您产品中的地址。
  2. 设置客户端身份验证。 您的后端不使用客户端密钥,而是使用来自您自己的身份提供商(例如 AWS、Google Cloud、Microsoft Entra ID 或 Kubernetes)的短期令牌来证明请求来自您的应用。您可以在应用的 Client authentication 选项卡上选择身份提供商以及要接受其哪些令牌。
  3. 设置您后端的身份。 使用工作负载身份联合创建一个服务账户和第二条联合规则,并将该服务账户选为应用的操作员服务账户。

后续步骤

Linked billing 指南会引导您完成设置,以及您的第一个已关联客户。

让您的客户从其自己的 Claude 组织支付在您产品中产生的 Claude 用量费用

端点、参数、令牌响应、有效期和错误

此页面对您有帮助吗?