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 и ⁠одобрите ваше приложение
Верните человека в ⁠ваш продукт с ⁠одноразовым кодом
Передайте код
Обменяйте код
Идентификатор подключения

Страница одобрения показывает название вашего приложения и то, что оно запрашивает, чтобы человек знал, что именно он одобряет.

Однократная настройка приложения OAuth

Linked billing начинается со следующих однократных шагов настройки в Claude Console. Руководство Linked billing проведёт вас через них.

  1. Создайте приложение. Участник вашей организации Claude с ролью «Администратор» создаёт приложение OAuth в Claude Console и копирует его “client ID” (идентификатор клиента). Приложение содержит название, которое люди видят на странице одобрения, и адрес в вашем продукте, на который они возвращаются.
  2. Настройте аутентификацию клиента. Вместо секрета клиента ваш бэкенд подтверждает, что запрос исходит от вашего приложения, с помощью краткосрочного токена от вашего собственного поставщика удостоверений, например AWS, Google Cloud, Microsoft Entra ID или Kubernetes. Вы выбираете поставщика удостоверений и то, какие из его токенов принимать, на вкладке Client authentication приложения.
  3. Настройте удостоверение вашего бэкенда. Создайте сервисную учётную запись и второе правило федерации с помощью Workload Identity Federation и выберите эту сервисную учётную запись в качестве операторской сервисной учётной записи приложения.

Следующие шаги

Руководство Linked billing проведёт вас через настройку и подключение вашего первого клиента.

Позвольте вашим клиентам оплачивать использование Claude в вашем продукте из своей собственной организации Claude

Эндпоинты, параметры, ответы с токенами, сроки действия и ошибки

Эта страница была полезной?