Claude Platform Docs
АдминистрированиеClaude Platform OAuth

Linked billing

Позвольте вашим клиентам связать свою организацию Claude Platform с вашим приложением с помощью OAuth и выставляйте счета за использование Claude организации клиента.

Linked billing позволяет вашим клиентам оплачивать использование Claude в вашем приложении через собственную организацию Claude. Клиент один раз связывает свою организацию Claude с вашим приложением. В API эта связь называется «connection» (подключение). После того как клиент выполнил связывание, вы в каждом запросе к Claude API выбираете, кто платит — клиент или вы. Клиент может отвязать ваше приложение в любой момент. Если запрос, который вы пометили для оплаты клиентом, невозможно выставить ему в счёт, Claude API отклоняет его, а не выставляет счёт вам.

Это руководство предназначено для разработчиков, пользователи приложений которых в основном являются клиентами Claude Platform. Вы добавляете в своё приложение кнопку «Link your Claude organization». Ваш пользователь нажимает её, входит в Claude и разрешает вашему приложению выставлять его организации Claude счета за запросы к Claude API, которые клиент поручает вам выполнять. Затем ваше приложение добавляет поле billing_policy в запросы, за которые платит клиент.

Подходящие клиенты и эндпоинты

Подходящие клиенты: выставлять счета клиенту таким образом можно только в том случае, если его организация Claude Platform платит Anthropic напрямую за использование API. Подходят как предоплаченные кредиты, так и оплата по выставленным счетам. Организациям, оплачивающим услуги через облачный маркетплейс (AWS, Google Cloud или Azure), нельзя выставлять счета через эту интеграцию. То же касается организаций, у которых есть только план подписки Claude. Запросы для них отклоняются с ошибкой 403 user_profile_not_billable.

Запросы выполняются в вашей организации, поэтому к ним применяются ваши «rate limits» (ограничения скорости), доступ к моделям, уровень обслуживания, хранение данных и ключи шифрования. Собственные договорённости вашего клиента в отношении данных не распространяются на эти запросы, включая «zero data retention» (нулевое хранение данных), или ZDR, «business associate agreement» (соглашение с деловым партнёром), или BAA, и «customer-managed encryption keys» (ключи шифрования, управляемые клиентом), или CMEK. Не связывайте с вашим приложением клиентов, которым для такого использования требуется защита в рамках HIPAA, FERPA или CMEK.

Поддерживаемые эндпоинты: billing_policy поддерживается в:

  • /v1/messages
    • Известное ограничение: запрос, за который выставляется счёт вашему клиенту (bill_to: "user_profile"), не может использовать платные функции выполнения кода (API возвращает ошибку 400), поэтому отправляйте такие запросы с bill_to: "self" или без billing_policy.
  • /v1/chat/completions
  • /v1/messages/count_tokens принимает поле billing_policy и игнорирует его, поэтому вы можете подсчитывать токены на точно том же теле запроса, которое собираетесь отправить.

Message Batches (/v1/messages/batches) пока не поддерживает выставление счетов вашему клиенту. Отправляйте запросы в пакете с bill_to: "self" или без billing_policy, и счета за них будут выставляться вам как обычно. Если в одном из запросов в пакете задано bill_to: "user_profile", этот запрос отклоняется: его результат — errored с ошибкой invalid_request_error, счёт за него не выставляется ни вам, ни вашему клиенту, а остальные запросы пакета выполняются как обычно.

Чтобы запросить поддержку другого эндпоинта, свяжитесь с вашей командой по работе с клиентами в Anthropic.

Какими кредитами можно оплачивать

Не всеми кредитами можно оплатить запрос, за который платформа выставляет счёт клиенту. Чем можно оплатить, зависит от организации, которой выставляется счёт: от клиента, если вы выставляете счёт клиенту, или от вашей организации, если счёт вам выставляет платформа.

Кредитами, купленными в Claude Console для этой организации, можно оплачивать эти запросы. Если эта организация оплачивает услуги по выставленным счетам, за эти запросы ей выставляется счёт.

Некоторыми промокредитами от Anthropic нельзя оплачивать эти запросы. К ним относятся ежемесячные кредиты API, входящие в планы Claude Max, Ultra и Team. Кредиты из партнёрских, венчурных (VC) и стартап-программ Anthropic не подходят для оплаты этих запросов.

Если в аккаунте этой организации нет ничего, чем можно оплатить запрос, Claude API может отклонить его с ошибкой 402. В ответе не указывается, что стало причиной отказа — нехватка кредитов или лимит расходов. См. Ожидаемые ошибки.

Процесс настройки

Эти три шага выполняются один раз. Они регистрируют ваше приложение в Anthropic. После них в разделе Какой профиль пользователя связывать объясняется правило, которое нужно учесть до создания профилей пользователей.

Шаг 1: Создайте приложение

Создайте OAuth-приложение в Claude Console. Это регистрация, которая идентифицирует ваш продукт для Anthropic: она связывает ваш URI перенаправления с идентификатором клиента, а её название — это то, что ваш пользователь видит на странице подтверждения.

Участник вашей организации с ролью «Администратор» открывает страницу OAuth-приложений в Console и нажимает Создать. Введите название вашего приложения и URI перенаправления (адрес в вашем приложении, на который браузер возвращается после подтверждения). В разделе What the app can do выберите Bill and link to organizations.

Откроется страница нового приложения. Скопируйте идентификатор клиента, который Console показывает для приложения. Ваше приложение отправляет его на шаге 5 при запросе страницы подтверждения, на шаге 6 при перенаправлении браузера и на шаге 8 при обмене кода, чтобы Anthropic знал, какое приложение делает запрос. Идентификатор клиента является публичным. На вкладке Внешний вид укажите название, домашнюю страницу и URL логотипа вашего приложения.

На вкладке Настройки для нового приложения, которое начинает работу в режиме тестирования, в Who can link указано Test users only. После того как вы опубликуете приложение и оно станет доступно, в настройке будет указано Any Claude user.

Шаг 2: Настройте аутентификацию клиента

Настройте, как ваш бэкенд доказывает auth.claude.com, что его запросы исходят от вашего приложения. Это заменяет секрет клиента: Anthropic не выдаёт секреты клиентов для OAuth-приложений.

На вкладке Client authentication приложения выберите ваш Поставщик удостоверений (издателя, который подписывает токены вашего бэкенда). Чтобы добавить его, нажмите Register a new issuer. Затем задайте Шаблон субъекта или условия для утверждений (claims) в разделе Дополнительные параметры соответствия, которым должны соответствовать эти токены. После сохранения на вкладке отображается ожидаемая аудитория. Утверждение aud в вашем «client assertion» (утверждении клиента) должно точно совпадать с этим значением.

Шаг 3: Настройте удостоверение вашего бэкенда

Вашему бэкенду нужно собственное удостоверение для вызовов Claude API. Создайте две вещи:

  • Сервисный аккаунт. Это нечеловеческий аккаунт в вашей организации Claude. Ваш бэкенд аутентифицируется от имени этого аккаунта при вызовах Claude API.
  • Второе правило федерации. Подобно правилу для аутентификации клиента приложения на шаге 2, оно позволяет вашему бэкенду аутентифицироваться с помощью токенов от вашего собственного поставщика удостоверений.

Чтобы настроить их в Claude Console, следуйте руководству Workload Identity Federation.

Затем на вкладке Client authentication приложения выберите этот сервисный аккаунт в качестве операторского сервисного аккаунта приложения. Только этот сервисный аккаунт имеет право отправлять запросы на инференс и относить выставление счетов на связанные профили пользователей. Сервисный аккаунт может быть оператором только одного OAuth-приложения.

По умолчанию любой аутентифицированный запрос от имени этого сервисного аккаунта может выставлять счета каждому связанному клиенту, задавая заголовок профиля пользователя и bill_to в Messages API. Чтобы получать токены аутентификации, ограниченные только конкретным подключением, см. раздел OAuth-токены для каждого подключения. Прежде чем связывать клиентов, задайте «workspace» (рабочую область) для вашего приложения. Шаг 8 возвращает такой токен для каждого клиента и требует, чтобы в приложении была указана рабочая область по умолчанию в вашей организации, в которой выполняется инференс. Если вам нужны «refresh tokens» (токены обновления) для каждого подключения, также включите Offline access для вашего приложения. Затем запрашивайте offline_access в процессе авторизации на шаге 5, прежде чем связывать клиентов.

«User profile» (профиль пользователя) — это запись в вашей собственной организации Claude, представляющая одного из ваших клиентов. Каждый запрос, за который выставляется счёт клиенту, включает идентификатор профиля, чтобы Anthropic знал, какому клиенту выставить счёт. Об остальных возможностях профилей см. в разделе Профили пользователей для атрибуции конечных клиентов.

Определите, какой профиль пользователя представляет каждого клиента, прежде чем связывать первого клиента. В пределах одного приложения подключения устанавливаются по принципу «один к одному»:

  • Организацию Claude клиента можно связать только с одним из ваших профилей пользователей.
  • Профиль пользователя можно связать только с одной организацией Claude.

Организация Claude клиента — это та, которую пользователь выбирает, когда подтверждает ваше приложение. Чтобы узнать, как команды клиента используют организации Claude, спросите клиента. Чтобы применить правило «один к одному» к записям ваших клиентов:

  • Несколько команд одного клиента используют одну организацию Claude: используйте для всех этих команд один профиль пользователя.
  • У каждой команды своя организация Claude: создайте профиль пользователя для каждой организации.

Связать можно любой активный профиль пользователя в вашей организации, если соблюдается правило «один к одному». Связывание не изменяет ни сам профиль, ни его идентификатор, ни историю его использования. Если вы связываете второй профиль пользователя с организацией Claude, которая уже связана, подтверждение отклоняется: см. user_profile_already_linked.

Профиль пользователя для каждого человека

Возможно, у вас уже есть профиль пользователя для каждого человека, который пользуется вашим продуктом. Несколько из этих людей могут работать на одного клиента. В этом случае Anthropic рекомендует создать ещё один профиль пользователя для организации Claude клиента и связать именно его.

Какой идентификатор профиля отправлять, зависит от того, кто платит за запрос:

  • Запросы, за которые вы выставляете счёт клиенту: отправляйте идентификатор профиля клиента. Чтобы также указать человека в запросе /v1/messages, задайте в metadata.user_idДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape. идентификатор этого человека. Этот идентификатор необязателен и помогает Anthropic обнаруживать злоупотребления со стороны отдельного человека. Используйте непрозрачное значение, а не имя, адрес электронной почты или номер телефона.
  • Запросы, которые оплачиваете вы: можно по-прежнему отправлять собственный идентификатор профиля этого человека.

Связывание каждого клиента

Шаги с 4 по 8 выполняются для каждого клиента, который связывает свою организацию. Для следующих фрагментов кода на Python требуются Anthropic SDK и несколько стандартных импортов; см. раздел Инициализация фрагментов кода. Примеры на других языках и CLI берут учётные данные из окружения. Убедитесь, что ANTHROPIC_API_KEY не задан, поскольку вашему приложению необходимо аутентифицироваться с помощью Workload Identity Federation.

Добавьте кнопку «Link your Claude organization» туда, где ваши клиенты управляют оплатой или интеграциями в вашем продукте (HTML, цвета и логотип кнопки см. в разделе Примеры брендинга). Сообщите им, что для связывания у них должна быть роль «Администратор» или «Оплата» в их организации Claude.

Чтобы сначала пройти эти шаги самостоятельно, см. раздел Тестирование в роли клиента.

Браузер
Ваш бэкенд
auth.claude.com
Нажать «Link your Claude organization»
5
Предварительно отправленный запрос авторизации с ⁠идентификатором профиля пользователя и ⁠утверждением клиента
request_uri
6
Перенаправить на страницу одобрения (конечную точку авторизации)
7
Пользователь входит в ⁠Claude, выбирает организацию и ⁠даёт одобрение
Перенаправить на ваш URI перенаправления с ⁠одноразовым кодом и ⁠state
Передать код и ⁠state
Проверить, что state совпадает
8
Запрос токена с ⁠кодом, верификатором кода PKCE и ⁠утверждением клиента
connection_id
Сохранить идентификатор подключения в ⁠записи клиента

Шаг 4: Создайте профиль пользователя для клиента

Создайте по одному профилю пользователя для каждой организации Claude клиента и сохраните идентификатор профиля в записи клиента в вашем продукте.

Если у вас уже есть профиль пользователя для организации Claude этого клиента, пропустите этот шаг и используйте идентификатор этого профиля. О том, как определить, какой это профиль, см. раздел Какой профиль пользователя связывать.

def create_user_profile(name: str, customer_id: str) -> str:
    profile = client.user_profiles.create(
        name=name,
        external_user_details={"reference_id": customer_id},
    )
    return profile.id  # "uprof_..."


user_profile_id = create_user_profile("Example Customer Inc.", "your-customer-id-123")

Если ваша организация перепродаёт доступ к API, при создании этого профиля также отправьте "access_type": "passthrough". В этих примерах access_type не указан, поэтому создаётся профиль application. О двух типах см. раздел Решите, кто получает профиль.

Ответ содержит id профиля, например uprof_01HV9Z.

Шаг 5: Создайте URL запроса авторизации с предварительной отправкой

Создайте «pushed authorization request» (запрос авторизации с предварительной отправкой), ссылающийся на профиль пользователя клиента из шага 4. Ответ содержит request_uri. На следующем шаге вы используете его, чтобы перенаправить пользователя на страницу подтверждения.

Перед отправкой запроса ваш бэкенд создаёт два случайных значения и сохраняет их в сеансе браузера и в записи клиента. Он снова использует оба на шаге 8:

  • Значение state, которое позволяет проверить, что браузер, вернувшийся в ваше приложение, — тот же, который инициировал этот запрос.
  • Верификатор кода PKCE — секрет, известный только вашему бэкенду. Запрос содержит его хеш (code challenge), а на шаге 8 отправляется сам верификатор, чтобы только ваш бэкенд мог использовать возвращённый код.
def push_authorization_request(user_profile_id: str) -> dict:
    state = secrets.token_urlsafe(32)
    code_verifier = secrets.token_urlsafe(64)
    code_challenge = create_s256_code_challenge(code_verifier)

    response = httpx.post(
        f"{AUTH}/v1/oauth/par",
        json={
            "response_type": "code",
            "client_id": CLIENT_ID,
            "redirect_uri": REDIRECT_URI,
            "scope": "billing:attribution",
            "connection_type": "organization_shared",
            "connection_auth_target": "platform",
            "user_profile_id": user_profile_id,
            "state": state,
            "code_challenge": code_challenge,
            "code_challenge_method": "S256",
            "client_assertion_type": JWT_BEARER,
            "client_assertion": client_assertion(),
        },
    )
    response.raise_for_status()  # on an error, do not redirect the browser

    return {
        "state": state,
        "code_verifier": code_verifier,
        "request_uri": response.json()["request_uri"],  # valid for 600 seconds
        "user_profile_id": user_profile_id,
    }


par = push_authorization_request(user_profile_id)

auth.claude.com отвечает кодом HTTP 201, значением request_uri и expires_in, равным 600 секундам. request_uri идентифицирует страницу подтверждения для этого запроса. scope должен быть точно billing:attribution или billing:attribution offline_access. Подробности см. в разделе Области (scopes) для подключения для выставления счетов. В примерах отправляется billing:attribution. Если у вашего приложения нет этой области, добавьте её в разделе Billing на вкладке Permissions приложения.

connection_auth_target должен иметь значение platform: запросы на инференс выполняются в вашей собственной организации и аутентифицируются от имени операторского сервисного аккаунта, но счёт за них может выставляться клиенту.

user_profile_id должен быть идентификатором активного профиля пользователя в вашей организации. Если запрос авторизации с предварительной отправкой завершается ошибкой, auth.claude.com возвращает вашему бэкенду ответ с ошибкой OAuth. В этом случае не перенаправляйте браузер.

Шаг 6: Отправьте пользователя на страницу подтверждения Claude

Сначала покажите пользователю, какой аккаунт в вашем продукте он связывает, и попросите его проверить аккаунт Claude, который показывает страница подтверждения. Страница показывает, в какой аккаунт Claude выполнен вход, и позволяет пользователю переключиться на другой. Страница подтверждения предлагает только организации того аккаунта Claude, в который выполнен вход в браузере, поэтому через не тот аккаунт может быть связана не та организация. Платит та организация, которую связывает пользователь.

Затем перенаправьте пользователя на эндпоинт авторизации, который показывает страницу подтверждения. Укажите только ваш client_id и request_uri из шага 5.

def authorize_url(par: dict) -> str:
    query = urlencode({"client_id": CLIENT_ID, "request_uri": par["request_uri"]})
    return f"{AUTH}/oauth/authorize?{query}"


redirect_to = authorize_url(par)  # answer the click with a 302 to this URL

Шаг 7: Пользователь подтверждает

На этом шаге ваше приложение ничего не делает. Пользователь проходит следующие шаги на auth.claude.com:

  1. Пользователь входит в Claude, если в браузере ещё не выполнен вход.
  2. Страница подтверждения показывает следующие экраны, на каждом из которых отображается название вашего приложения. О том, что пользователь делает на каждом экране, см. раздел Связывание.
    1. Select an organization — только если пользователь может выбрать организацию.
    2. How billing works.
    3. Set a monthly spend limit.
    4. Последний экран с кнопкой Link and authorize.
  3. Когда пользователь нажимает Link and authorize, auth.claude.com возвращает браузер в ваше приложение. Страница подтверждения не показывает экрана с подтверждением.

Если пользователь отменяет подтверждение или не может подтвердить, подключение не создаётся: см. раздел Если связывание не завершено.

Шаг 8: Обработайте обратный вызов и сохраните подключение

После подтверждения auth.claude.com возвращает браузер на ваш URI перенаправления с одноразовым кодом и вашим значением state. Этот запрос к вашему URI перенаправления называется «callback» (обратный вызов). Ваш бэкенд обменивает код на идентификатор подключения и сохраняет его в записи клиента. На этом подключение завершено. Обратный вызов может содержать параметр error и не содержать кода. В этом случае подключение не создано: см. раздел Если связывание не завершено.

Убедитесь, что state совпадает со значением, сохранённым на шаге 5, а затем немедленно обменяйте код со своего бэкенда вместе с верификатором кода PKCE. Код одноразовый и истекает через 5 минут.

def handle_callback(par: dict, params: dict) -> str:
    if not secrets.compare_digest(
        params.get("state", "").encode(), par["state"].encode()
    ):
        raise ValueError("state does not match")
    if "error" in params:  # for example access_denied
        raise PermissionError(params["error"])
    code = params["code"]  # single-use, expires after 5 minutes
    response = httpx.post(
        f"{AUTH}/v1/oauth/token",
        json={
            "grant_type": "authorization_code",
            "code": code,
            "code_verifier": par["code_verifier"],
            "redirect_uri": REDIRECT_URI,
            "client_id": CLIENT_ID,
            "client_assertion_type": JWT_BEARER,
            "client_assertion": client_assertion(),
        },
        timeout=10,  # a response that times out loses the tokens in it
    )
    response.raise_for_status()
    tokens = response.json()
    # Чтобы использовать токены подключения, сохраните tokens["access_token"], время его
    # истечения (из tokens["expires_in"]) и, при offline_access,
    # tokens["refresh_token"] как секреты: код нельзя обменять повторно.
    # "ocon_..."; сохраните его в записи клиента
    return tokens["connection_id"]

Ответ содержит идентификатор подключения и токен доступа подключения, с помощью которого можно аутентифицироваться и выставлять счета подтвердившему клиенту. Если клиент подтвердил offline_access, ответ также содержит токен обновления. Сохраните connection_id и токены сейчас: обмен возвращает токены только один раз. Ответ описан в разделе Сохраните токены.

Примеры на этой странице, которые вызывают Claude API, аутентифицируются как сервисный аккаунт из шага 3, а не с помощью токена из этого ответа. О том, как использовать токен вместо него, см. раздел Вызов Claude с токеном доступа подключения.

Ответ не указывает, какую организацию Claude связал пользователь.

Завершённое подключение не гарантирует, что Anthropic сможет выставить счёт клиенту. Например, организация клиента может не входить в число подходящих клиентов. О том, как Claude API это проверяет, см. разделы Обновление вызовов к Claude и Ожидаемые ошибки. Из-за этой проверки формулируйте сообщение об успехе как «связано», а не «оплата активна».

Если обмен отклоняется с unauthorized_client, см. раздел Обмен кода возвращает unauthorized_client.

Тестирование в роли клиента

Чтобы проверить, что связывание работает, свяжите одну из своих организаций. Для этого сначала понадобится следующее:

  • Вторая ваша организация Claude, которая будет выступать в роли клиента. Нельзя связать приложение с организацией, которой оно принадлежит. Страница подтверждения не предлагает эту организацию. Вторая организация должна быть одним из подходящих клиентов.
  • Человек с ролью «Администратор» или «Оплата» в этой организации, который подтвердит связывание.
  • Пока ваше приложение не опубликовано, этот человек должен быть в списке Test users вашего приложения. Список находится на вкладке Настройки приложения в разделе Who can link. Добавьте человека по адресу электронной почты его аккаунта Claude и нажмите Save changes. В разделе Пока ваше приложение находится в тестировании указан действующий предел расходов. Удаление человека из списка прекращает подключения, которые он подтвердил.

Затем выполните шаги с 4 по 8 и попросите этого человека подтвердить связывание на шаге 7. Когда связывание выполнено, профиль пользователя отображается как Linked на вашей странице User profiles в Console.

Если связывание не завершено

Если пользователь не завершает подтверждение или auth.claude.com отклоняет его, подключение не создаётся. В этих пунктах описаны исходы, характерные для Linked billing. Обо всех остальных ошибках см. раздел Ошибки в справочнике по OAuth.

Ваш URI перенаправления получает error=access_denied

Запрос также содержит ваше значение state. Ваш URI перенаправления получает эту ошибку, например, в следующих случаях:

  1. Пользователь нажимает Cancel на любом из экранов подтверждения.
  2. Страница подтверждения не может предложить пользователю ни одной организации, и пользователь нажимает кнопку возврата в ваше приложение. Например:
    • У пользователя нет роли «Администратор» или «Оплата» ни в одной организации Claude Platform.
    • Единственная организация пользователя — та, которой принадлежит ваше приложение. См. раздел Тестирование в роли клиента.
    • Профиль пользователя уже связан с другой организацией Claude, а у пользователя нет роли «Администратор» или «Оплата» в этой организации.
    • Пока ваше приложение не опубликовано, пользователь отсутствует в его списке Test users.

Во всех случаях из этого списка error_description содержит текст the user declined the request, поэтому по нему эти случаи нельзя различить.

Ещё одна причина связана с настройками вашего приложения. Если приложение опубликовано, а в Who can link указана только ваша организация, никто за пределами вашей организации не сможет связать приложение. Выберите Any Claude user и нажмите Save changes.

Сообщите пользователю, что связывание не завершено, и не считайте, что он отказался. Попросите его проверить, в какой аккаунт Claude он вошёл, и свою роль в организации, которую он хочет связать. После того как пользователь отменил подтверждение или вернулся, request_uri нельзя использовать снова, поэтому, чтобы пользователь мог повторить попытку, начните заново с шага 5.

Ваше приложение получает user_profile_already_linked

Организация Claude клиента уже связана с вашим приложением через другой из ваших профилей пользователей. auth.claude.com просит пользователя связаться с вами. Если пользователь возвращается в ваше приложение, ваш URI перенаправления получает error=user_profile_already_linked и ваше значение state. Эндпоинт токенов также может вернуть эту ошибку при обмене кода на шаге 8. Так бывает, например, если за это время организация была связана через другой профиль пользователя.

Anthropic не сообщает вам, какую организацию Claude связывает клиент, поэтому заранее увидеть это нельзя. Запрос авторизации с предварительной отправкой на шаге 5 выполняется успешно, а auth.claude.com отклоняет подключение только тогда, когда пользователь подтверждает.

Ошибка не указывает, какому профилю пользователя принадлежит подключение. Скорее всего, это другой связанный профиль того же клиента. Anthropic не показывает, с какой организацией связан профиль, поэтому, прежде чем что-либо делать, уточните это у клиента. Если подключение принадлежит этому профилю, выполните одно из следующих действий:

  • В запросах, за которые вы выставляете счёт этому клиенту, отправляйте идентификатор этого профиля пользователя.
  • Прекратите это подключение, как описано в разделе Отвязывание клиента, а затем повторите шаги с 5 по 8 с профилем пользователя, для которого было получено отклонение.

Если ни один из профилей этого клиента не связан, возможно, пользователь выбрал организацию, принадлежащую другому вашему клиенту. Начните заново с шага 5 и попросите пользователя проверить, какую организацию он выбирает.

Ваш URI перенаправления ничего не получает

Ваше приложение не может обнаружить следующие два случая:

  • Пользователь закрывает страницу подтверждения.
  • Срок действия request_uri истёк, или он уже был использован. В этом случае страница подтверждения показывает ошибку и не возвращает браузер в ваше приложение.

Если пользователь возвращается в ваш продукт без обратного вызова, начните заново с шага 5. Неиспользованный request_uri истекает через 10 минут после создания.

Обмен кода возвращает unauthorized_client

Ваше приложение не настроено для этого запроса. Если проблема связана с рабочей областью, error_description указывает причину. Если отсутствует операторский сервисный аккаунт, в нём содержится только текст the client is not registered for this grant. Отказ не расходует код, поэтому вы можете снова обменять тот же код до истечения его срока действия. Сначала проверьте в Claude Console следующее:

ПроверкаГдеИсправление
У приложения есть операторский сервисный аккаунтOperator service account на вкладке Client authentication приложенияВыберите аккаунт и нажмите Save. О том, как его настроить, сказано на шаге 3.
Рабочая область приложения не отсутствует и не архивированаНастройка приложенияВыберите рабочую область. Пока её у приложения нет, обмен также отклоняется с unauthorized_client.

Сохранённый сервисный аккаунт может доходить до auth.claude.com минуту-две, поэтому, если обмен снова отклонён, подождите столько же и повторите попытку. Если к тому моменту срок действия кода истёк, попросите пользователя подтвердить снова (шаги с 5 по 8). О причинах, которые error_description указывает для токенов подключения, см. разделы Сохраните токены и Обновление токенов.

В любом другом случае свяжитесь с вашей командой по работе с клиентами в Anthropic. Сделайте то же самое, если Console сообщает, что сервисный аккаунт больше не существует.

Опубликуйте приложение

Пока ваше приложение не опубликовано, связать его могут только люди из его списка Test users, поэтому ваши клиенты этого сделать не могут. Чтобы опубликовать приложение, нажмите Publish app на странице приложения в Claude Console. Откроется диалоговое окно.

  • Если ваша организация оплачивает услуги по выставленным счетам, приложение становится доступным сразу после подтверждения в этом диалоговом окне.
  • В противном случае вы сначала подтверждаете в этом диалоговом окне, что контролируете домен приложения, а затем Anthropic проверяет приложение.

Подтверждение домена: домен — это домен домашней страницы вашего приложения. Каждый URI перенаправления должен находиться в этом домене или в его поддомене, за исключением URI на localhost, 127.0.0.1 или [::1]. Подтверждение выполняется с помощью записи DNS TXT. Изменения DNS могут вступать в силу до 48 часов, поэтому начните заранее, до того как клиентам понадобится выполнять связывание. Если ваша организация уже подтвердила домен, охватывающий домашнюю страницу и эти URI перенаправления, диалоговое окно пропускает этот шаг. Подтверждённый домен охватывает свои поддомены.

Публикацию вы подтверждаете на последнем шаге диалогового окна. Если на этом шаге есть флажок для принятия Linked Billing Terms, установите его. Затем нажмите Publish app в диалоговом окне.

Проверка: во время проверки статус приложения в Console — In review. Приложение становится доступным, когда Anthropic его одобряет. Если Anthropic его не одобряет, статус — Not approved, и вы не можете снова опубликовать приложение самостоятельно. Чтобы задать вопрос об этом решении, обратитесь в службу поддержки.

Если ваша организация не оплачивает услуги по выставленным счетам, изменение названия, логотипа, домашней страницы или URI перенаправления опубликованного приложения снова отправляет его на проверку. Уже связанные клиенты остаются связанными и сохраняют установленный ими предел. Пока Anthropic не одобрит изменение, связать приложение могут только люди из списка Test users.

Обновление вызовов к Claude

Отправляйте заголовок anthropic-user-profile-id в каждом вызове к /v1/messages и /v1/chat/completions для связанного клиента. В запросе, за который вы выставляете счёт клиенту, значением заголовка является идентификатор профиля пользователя, которому принадлежит подключение этого клиента. Вызовы, в которых задан billing_policy, также должны отправлять бета-заголовок user-profiles-billing-2026-10-01.

Счёт за каждый запрос для связанного клиента выставляется либо клиенту, либо вам, и вы выбираете, кому именно, в каждом запросе. В следующих примерах показаны оба варианта.

В разделе OAuth-токены для каждого подключения описан другой способ аутентификации запросов клиента: токен доступа, с помощью которого можно выставлять счета только этому клиенту. В /v1/messages и /v1/chat/completions счёт за запрос с таким токеном не может быть выставлен вам. Счёт за него выставляется этому клиенту даже без billing_policy или заголовка anthropic-user-profile-id там, где они необязательны: см. примечание в разделе Вызов Claude с токеном доступа подключения. Если в запросе указан другой профиль пользователя или задано bill_to: "self", он отклоняется. Никогда не используйте такой токен для запроса, за который платите вы.

Платит ваш клиент

Добавьте в тело запроса billing_policy с bill_to: "user_profile" и отправьте бета-заголовок для выставления счетов и заголовок с идентификатором профиля.

Устанавливайте bill_to: "user_profile" только в запросах, которые клиент поручает вам выполнять: это использование Claude, которое клиент и его пользователи инициируют в вашем продукте. Не выставляйте клиенту счета за ваше собственное использование, например за тестирование, оценки или работу для других клиентов. Claude API не может проверить это за вас, поэтому ответственность лежит на вас.

def message_billed_to_user(user_profile_id: str, prompt: str) -> BetaMessage:
    return client.beta.messages.create(
        model="claude-opus-5-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": prompt}],
        betas=[BILLING_BETA],
        extra_headers={"anthropic-user-profile-id": user_profile_id},
        extra_body={
            "billing_policy": {"type": "billing_policy", "bill_to": "user_profile"}
        },
    )

Если запрос отклонён, см. раздел Ожидаемые ошибки.

Платите вы

Чтобы платить самостоятельно, либо полностью опустите billing_policy (в этом случае бета-заголовок для выставления счетов необязателен):

def message_billed_to_you(user_profile_id: str, prompt: str) -> Message:
    return client.messages.create(
        model="claude-opus-5-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": prompt}],
        user_profile_id=user_profile_id,
    )

либо используйте bill_to: "self":

def message_billed_to_self(user_profile_id: str, prompt: str) -> BetaMessage:
    return client.beta.messages.create(
        model="claude-opus-5-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": prompt}],
        betas=[BILLING_BETA],
        extra_headers={"anthropic-user-profile-id": user_profile_id},
        extra_body={"billing_policy": {"type": "billing_policy", "bill_to": "self"}},
    )

OAuth-токены для каждого подключения

Ваш бэкенд вызывает Claude API как операторский сервисный аккаунт вашего приложения (шаг 3). По умолчанию любой аутентифицированный запрос от имени этого сервисного аккаунта может выставлять счета каждому связанному клиенту, передавая заголовок с идентификатором профиля пользователя и включая bill_to в запросы к Messages API. Такое поведение по умолчанию называется «operator-only tokenless authentication» (бестокенной аутентификацией только через оператора).

Для работы с однотенантными развёртываниями вашего продукта или управляемыми клиентом изолированными средами (sandbox) вы можете получать привязанные к подключению OAuth-токены доступа и обновления вместо бестокенной аутентификации только через оператора.

Для каждого подключения обмен кода на шаге 8 возвращает собственный токен доступа этого подключения. Токен аутентифицируется как ваш операторский сервисный аккаунт, но позволяет выставлять счета только клиенту этого подключения. Срок его действия истекает в течение 1 часа.

Чтобы аутентифицировать каждое подключение отдельно:

  • Используйте офлайн-доступ. Включите Offline access для вашего приложения и запросите offline_access на шаге 5. Тогда каждое подключение также получает токен обновления, с помощью которого ваш бэкенд запрашивает новые токены доступа. Без него клиенту придётся снова подтвердить приложение, чтобы выдать вам новый токен доступа: повторите шаги с 5 по 8 с тем же scope.
  • Задайте рабочую область по умолчанию. Выберите рабочую область в вашей организации, в которой будут выполняться запросы с этими токенами.
  • При необходимости отключите бестокенную аутентификацию только через оператора. По умолчанию вы по-прежнему можете выставлять счёт связанному клиенту от имени вашего операторского сервисного аккаунта (передавая заголовок профиля пользователя и bill_to) даже после истечения срока действия токена доступа клиента. После того как вы отключите аутентификацию только оператора, каждый запрос, за который выставляется счёт клиенту, должен аутентифицироваться с токеном доступа этого клиента.
  • Используйте billing:attribution. Только эта область даёт подключению собственные токены. Вы по-прежнему можете выставлять счёт связанному клиенту от имени вашего операторского сервисного аккаунта, как и с областью org:billing_attribution, которая устарела. См. раздел Области (scopes) для подключения для выставления счетов.

Настройка приложения

Запросы с токеном доступа подключения выполняются в одной рабочей области вашей организации. Она нужна каждому приложению, даже если вы не используете эти токены: пока у приложения нет рабочей области, обмен кода на шаге 8 отклоняется с ошибкой unauthorized_client.

Участник вашей организации с ролью «Администратор» открывает вкладку Client authentication приложения в Console. Под операторским сервисным аккаунтом найдите Default workspace for platform auth mode OAuth tokens (параметр приложения connection_token_workspace_id) и нажмите Choose workspace. Выберите рабочую область, участником которой является операторский сервисный аккаунт (шаг 3). Рабочая область не должна быть архивирована.

Чтобы получать токены обновления, включите Offline access на вкладке Permissions приложения. Изменение областей приложения доходит до auth.claude.com за несколько минут.

Области (scopes) для подключения для выставления счетов

На шаге 5 передайте scope со значением billing:attribution. Чтобы также получить «refresh token» (токен обновления), передайте billing:attribution offline_access.

Чтобы изменить области уже связанного клиента, например добавить offline_access, повторите шаги с 5 по 8 с существующим профилем пользователя клиента и новым scope. Предварительно отвязывать клиента не нужно. Обмен кода возвращает новый connection_id, и новое подключение заменяет прежнее. См. примечание на шаге 8.

Приложение может одновременно иметь billing:attribution и устаревшую область org:billing_attribution. Область billing:attribution добавляется в разделе Billing на вкладке Permissions приложения. Если удалить там org:billing_attribution, добавить её снова будет нельзя. Подключение, которое клиент подтвердил с org:billing_attribution, продолжает выставлять счета через ваш операторский сервисный аккаунт, пока подключение не будет прекращено или пока вы не отключите аутентификацию только оператора.

Сохраните токены

Обмен кода возвращает токены только один раз, поэтому сохраните их на шаге 8. Ответ содержит access_token, expires_in (не более 1 часа, в секундах) и connection_id. Если клиент подтвердил offline_access, ответ также содержит refresh_token и refresh_token_expires_in. Токен обновления действует не более 1 года, и обновление не продлевает этот срок. По его истечении свяжите клиента снова.

Храните токены и время их истечения в хранилище секретов, которое может читать только сервис, выполняющий обновление.

Если обмен отклоняется с unauthorized_client, error_description указывает причину, например отсутствующую или архивированную рабочую область. Код при этом не расходуется: устраните причину и отправьте тот же код снова до истечения его срока действия.

Вызов Claude с токеном доступа подключения

Отправляйте токен доступа подключения как «bearer token» (токен предъявителя) в заголовке Authorization вместо собственных учётных данных вашего операторского сервисного аккаунта. Не отправляйте заголовок x-api-key. В Anthropic SDK передайте токен как auth_token или задайте переменную окружения ANTHROPIC_AUTH_TOKEN.

В /v1/messages и /v1/chat/completions счёт за запрос выставляется клиенту этого подключения. Заголовок anthropic-user-profile-id и billing_policy необязательны. Бета-заголовок для выставления счетов нужен только вместе с billing_policy.

На этих двух эндпоинтах вы не можете оплатить запрос с этим токеном сами. Используйте токен только на этих двух эндпоинтах, на /v1/messages/count_tokens и на эндпоинтах Models. Все остальные запросы, а также все запросы, которые оплачиваете вы, отправляйте от имени вашего операторского сервисного аккаунта со своего бэкенда. Это относится и к запросам, использующим платные функции выполнения кода, за которые нельзя выставить счёт клиенту.

Claude API отклоняет следующие запросы:

  • 400 invalid_request_error, без кода ошибки: запрос указал другой профиль пользователя или задал bill_to: "self".
  • 403 permission_error, без кода ошибки: запрос был отправлен на эндпоинт Message Batches.
  • 401 authentication_error: срок действия токена истёк, его заменило обновление или его подключение прекращено. После прекращения подключения ответом также может быть 403 user_profile_not_billable.

Обновление токенов

Чтобы обновить токен доступа подключения, отправьте его токен обновления на эндпоинт токенов https://auth.claude.com/v1/oauth/token с аутентификацией клиента вашего приложения. Не отправляйте параметр scope.

connection_locks: defaultdict[str, threading.Lock] = defaultdict(threading.Lock)


def error_body(response: httpx.Response) -> dict:
    try:
        body = response.json()
    except ValueError:
        return {}
    return body if isinstance(body, dict) else {}


def is_lost(response: httpx.Response) -> bool:
    """True for a 5xx response that can follow a refresh that took effect."""
    if response.status_code < 500:
        return False
    # Ответ 503 в формате Claude API с заголовком retry-after — это отказ,
    # не использующий refresh-токен. Любой другой ответ 5xx считается потерянным.
    paused = (
        response.status_code == 503
        and error_body(response).get("type") == "error"
        and "retry-after" in response.headers
    )
    return not paused


def hold_error(connection_id: str, reason: str) -> RefreshOnHold:
    return RefreshOnHold(
        f"Connection {connection_id} is on hold. {reason} Don't send its refresh token"
        ' again: that can end the connection. See "Link a customer again" in the'
        " Linked billing guide."
    )


def refresh_connection(connection_id: str, *, force: bool = False) -> tuple[str, int]:
    """Refreshes the connection if its access token is close to its expiry.

    Returns the current access token and its expiry time in Unix seconds. Call
    this from your schedule, and pass force=True to refresh a token that isn't
    close to its expiry. Raises RefreshOnHold when the refresh token can't be sent
    again, now and on every later call, and httpx.HTTPStatusError for a refusal
    that keeps the refresh token. After RefreshOnHold for a lost refresh, pause
    your schedule. Resume with one connection, and resume the others only after
    that refresh succeeds or gets a 4xx.
    """
    # Эта блокировка работает в пределах одного процесса. При наличии реплик используйте
    # общую для всех них блокировку.
    with connection_locks[connection_id]:
        tokens = load_tokens(connection_id)
        if tokens.on_hold:
            raise hold_error(
                connection_id, "An earlier refresh might have used its refresh token."
            )
        if not force and tokens.expires_at - time.time() > REFRESH_MARGIN_SECONDS:
            return tokens.access_token, tokens.expires_at  # not close to expiry
        request = {
            "grant_type": "refresh_token",
            "refresh_token": tokens.refresh_token,
            "client_id": CLIENT_ID,
            "client_assertion_type": JWT_BEARER,
            "client_assertion": client_assertion(),
        }
        url = f"{AUTH}/v1/oauth/token"
        # Приостановите подключение до того, как refresh-токен покинет этот процесс.
        # Если процесс остановится до сохранения новых токенов, приостановка сохранится.
        save_tokens(connection_id, replace(tokens, on_hold=True))
        issued_at = int(time.time())
        started = time.monotonic()
        # httpx сам не выполняет повторы. Не добавляйте повторы: поздний повтор завершает
        # подключение.
        try:
            response = httpx.post(url, json=request, timeout=REQUEST_TIMEOUT)
            lost = is_lost(response)
        except (httpx.ConnectError, httpx.ConnectTimeout):
            # Подключение не установлено, значит refresh-токен не покидал этот процесс.
            save_tokens(connection_id, tokens)
            raise
        except httpx.TransportError:
            lost = True
        if lost:
            # Первый запрос мог использовать refresh-токен. Второй запрос
            # безопасен только в пределах указанного выше лимита, поэтому отправьте его сразу или не
            # отправляйте вовсе.
            if time.monotonic() - started > SECOND_REQUEST_DEADLINE_SECONDS:
                raise hold_error(connection_id, "A refresh got no usable answer.")
            try:
                response = httpx.post(url, json=request, timeout=REQUEST_TIMEOUT)
            except httpx.TransportError:
                raise hold_error(
                    connection_id, "Two refreshes got no answer."
                ) from None
            if response.status_code != 200:
                # После любого ответа, кроме новых токенов, нельзя понять,
                # сработал ли первый запрос, и последующий запрос небезопасен.
                raise hold_error(connection_id, "The second refresh failed.")
        if error_body(response).get("error") == "invalid_grant":
            # Истёк, уже использован или подключение завершено. Повторная отправка
            # может завершить подключение.
            raise hold_error(connection_id, "The refresh returned invalid_grant.")
        if response.status_code != 200:
            # Отказ, сохраняющий refresh-токен, поэтому снимите приостановку.
            save_tokens(connection_id, tokens)
            response.raise_for_status()
        body = response.json()
        tokens = ConnectionTokens(
            refresh_token=body["refresh_token"],
            access_token=body["access_token"],
            expires_at=issued_at + body["expires_in"],
            refresh_expires_at=issued_at + body["refresh_token_expires_in"],
        )
        # Если запись не удалась, повторите запись. Не выполняйте обновление повторно.
        for attempt in range(5):
            try:
                save_tokens(connection_id, tokens)
                return tokens.access_token, tokens.expires_at
            except OSError:  # your secret store's error type
                if attempt < 4:
                    time.sleep(2**attempt)
        # Новые токены есть только в этом процессе, а сохранённый refresh-токен
        # израсходован. Сохранённая запись всё ещё приостановлена. Ошибка содержит новые
        # токены, чтобы вызывающий код мог сохранить их, когда хранилище секретов восстановится.
        error = hold_error(
            connection_id,
            "The refresh succeeded, but the new tokens could not be saved.",
        )
        error.new_tokens = tokens
        raise error

Ответ содержит новый access_token и новый refresh_token. Отправленный вами токен обновления заменён: не отправляйте его снова, за исключением случаев, указанных в приведённом ниже списке сбоев. Прежний токен доступа перестаёт действовать в течение нескольких минут. Функции, которые вызывает пример, определены в разделе Инициализация фрагментов кода для токенов OAuth.

  • Сохраняйте новый токен обновления до того, как начнёте использовать новый токен доступа.
  • Обновляйте токены каждого подключения из одного сервиса, по одному обновлению за раз. Если у сервиса есть реплики, используйте блокировку, общую для всех них. Использованный токен обновления, поступивший повторно более чем через 30 секунд после первого использования, прекращает подключение. Все токены отзываются, клиент отображается как Unlinked, и никакие учётные данные не могут выставлять ему счета, пока он не выполнит связывание снова.
  • Отключите автоматические повторные попытки для запроса обновления — в вашем HTTP-клиенте и в любом прокси.

Если первый запрос с токеном обновления завершается неудачей:

  • Не удалось установить соединение: токен обновления не был отправлен. Повторите попытку позже.
  • Обрыв соединения или любой ответ 5xx, кроме 503 из этого списка: вы не можете определить, вступил ли запрос в силу, поэтому отправьте тот же токен обновления ещё один раз.
    1. Отправьте его немедленно и только если с момента отправки первого запроса прошло менее 30 секунд.
    2. Если этот запрос возвращает новые токены, сохраните их и используйте только их. Если первый запрос всё же вступил в силу, его токены, которые так и не дошли до вас, отзываются.
    3. Если он возвращает что-либо другое или не получает ответа либо если 30 секунд уже прошли, не отправляйте этот токен обновления снова. Прекратите обновлять это подключение и свяжите клиента снова.
  • Тайм-аут: запрос может всё ещё выполняться. Не отправляйте этот токен обновления снова. Прекратите обновлять это подключение и свяжите клиента снова.
  • 429 или 503 с заголовком retry-after и "type": "error" на верхнем уровне тела: ничего не отозвано. Подождите не меньше, чем указано в заголовке, и отправьте тот же токен обновления снова.
  • unauthorized_client или invalid_client: ничего не отозвано. error_description указывает причину, например отсутствующую рабочую область, то, что offline_access больше не зарегистрирована для вашего приложения, или неудачное утверждение клиента. Устраните её и отправьте тот же токен обновления снова.
  • invalid_scope: запрос отправил параметр scope, или billing:attribution больше не зарегистрирована для вашего приложения. Ничего не отозвано. Устраните причину и отправьте тот же токен обновления снова.
  • invalid_grant: срок действия токена обновления истёк или он уже был использован, подключение прекращено либо организация клиента приостановлена. Прекратите обновлять это подключение и следуйте разделу Повторное связывание клиента, который начинается с проверки на приостановку.

Если из-за обрыва соединения, ответа 5xx или тайм-аута вы прекратили обновлять подключение, приостановите также обновление остальных подключений. При возобновлении сначала обновите одно подключение и возобновляйте остальные только после того, как это обновление завершится успешно или получит ответ 4xx.

Запуск агента в песочнице

Передавайте в «sandbox» (песочницу) только токен доступа и никогда — токен обновления. Обновление выполняет ваш бэкенд, и он отправляет каждый новый токен доступа в песочницу. Какого клиента обслуживает песочница, бэкенд определяет по собственному удостоверению песочницы, например по удостоверению её пода, и никогда — по значению, которое отправляет песочница. Он отправляет песочнице только токен этого клиента. Песочница не должна иметь возможности получить JWT, соответствующий одному из ваших правил федерации или аутентификации клиента вашего приложения. Не предоставляйте ей ни смонтированный токен удостоверения, ни доступ к серверу метаданных облака.

Claude Code, Claude Agent SDK и Anthropic SDK могут считывать токен из файла учётных данных в профиле конфигурации (см. Файл конфигурации профиля). В песочнице создайте каталог конфигурации с этим профилем. Не добавляйте в него client_id: если он указан, SDK пытается обновить токен самостоятельно.

configs/customer.json
{
  "version": "1.0",
  "authentication": {
    "type": "user_oauth"
  }
}

Записывайте токен доступа в файл credentials/customer.json в том же каталоге — до запуска агента и после каждого обновления. expires_at — время истечения срока действия в секундах Unix. Записывайте новый файл с режимом 0600 и переименовывайте его поверх старого:

credentials/customer.json
{
  "type": "oauth_token",
  "access_token": "sk-ant-oat01-...",
  "expires_at": 1793635200
}

Задайте для ANTHROPIC_CONFIG_DIR каталог конфигурации, а для ANTHROPIC_PROFILE — значение customer. Удалите в песочнице все остальные учётные данные, такие как ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN и настройку apiKeyHelper в Claude Code, поскольку любые из них могут иметь приоритет над профилем. Агент повторно считывает файл в последние 2 минуты перед expires_at и после ответа 401.

def write_credentials_file(
    config_dir: Path, profile: str, token: str, expires_at: int
) -> None:
    credentials_dir = config_dir / "credentials"
    credentials_dir.mkdir(mode=0o700, parents=True, exist_ok=True)
    body = {"type": "oauth_token", "access_token": token, "expires_at": expires_at}
    # Переименуйте готовый файл на место, чтобы агент никогда не читал файл наполовину.
    # mkstemp задаёт режим 0600 с текущим пользователем в качестве владельца, поэтому запускайте от
    # пользователя агента.
    handle, temporary_path = tempfile.mkstemp(dir=credentials_dir)
    with os.fdopen(handle, "w") as temporary_file:
        json.dump(body, temporary_file)
    os.replace(temporary_path, credentials_dir / f"{profile}.json")

Повторное связывание клиента

Свяжите клиента снова в следующих случаях:

  • Обновление вернуло invalid_grant.
  • Вы потеряли токен обновления или он утёк.
  • Вы потеряли ответ на шаге 8 для billing:attribution offline_access либо шаг 8 вернул invalid_grant для такого подключения.
  • Срок действия токена обновления подходит к концу.

Выполните следующие действия:

  1. На вашей странице User profiles проверьте, отображается ли клиент как Linked. После invalid_grant сначала узнайте у вашей команды по работе с клиентами в Anthropic, не приостановлена ли организация клиента: после окончания приостановки имеющийся у вас токен обновления снова работает. Если все подключения одновременно возвращают invalid_grant, ищите причину на своей стороне, например архивированную рабочую область, прежде чем отвязывать кого-либо.
  2. Если клиент отображается как Linked, отвяжите его, как описано в разделе Отвязывание клиента. Отвязывание отзывает токены подключения. Делайте это, когда администратор организации клиента готов подтвердить связывание, поскольку выставление счетов через подключение прекращается до тех пор, пока он этого не сделает.
  3. Повторите шаги с 5 по 8 с существующим профилем пользователя клиента. Сохраните новый идентификатор подключения и новые токены вместо прежних.

Отключение аутентификации только оператора

Чтобы запросы, аутентифицирующиеся только как ваш операторский сервисный аккаунт, не могли выставлять счета клиентам, включите Disable operator-only tokenless authentication (настройка приложения disable_operator_only_auth). Она находится на вкладке Client authentication приложения, под операторским сервисным аккаунтом. У вашего приложения должны быть области billing:attribution и offline_access, а также рабочая область для его OAuth-токенов. Прежде чем включать её, убедитесь, что каждый связанный клиент подтвердил billing:attribution offline_access и что ваши запросы с их токенами доступа работают. Пока настройка включена, выставлять счёт клиенту подключения billing:attribution может только токен доступа этого подключения. Запрос, который аутентифицируется только как сервисный аккаунт и задаёт bill_to: "user_profile", отклоняется с 403 user_profile_not_billable. Клиент при этом по-прежнему отображается как Linked, поэтому отслеживайте эту ошибку в журналах. Сервисный аккаунт по-прежнему может управлять профилями пользователей и отправлять запросы, которые оплачиваете вы. Настройку можно снова отключить.

Инициализация фрагментов кода для токенов OAuth

Примеры в этом разделе используют следующую общую настройку. Она определяет:

  • импорты, включая пакет httpx
  • идентификатор клиента вашего приложения и тип утверждения клиента
  • ConnectionTokens, который хранит токены подключения, время их истечения и его отметку on_hold
  • RefreshOnHold — ошибку, которую refresh_connection() выбрасывает, когда токен обновления нельзя отправлять снова: возможно, он уже был использован, или эндпоинт токенов ответил invalid_grant. refresh_connection() выбрасывает её и при каждом последующем вызове, пока вы не снимете on_hold в сохранённых токенах, например после окончания приостановки. Если обновление прошло успешно и только ваше хранилище секретов отказало в записи, её new_tokens содержит токены, которые нужно сохранить.
  • client_assertion(), которая считывает JWT вашего поставщика удостоверений из файла, указанного в ANTHROPIC_IDENTITY_TOKEN_FILE. Утверждение aud в JWT должно совпадать с аудиторией в настройках аутентификации клиента вашего приложения.
  • load_tokens() и save_tokens(), которые вы пишете для своего хранилища секретов
import json
import os
import tempfile
import threading
import time
from collections import defaultdict
from dataclasses import dataclass, field, replace
from pathlib import Path

import httpx

AUTH = "https://auth.claude.com"
# скопируйте с platform.claude.com после регистрации вашего OAuth-приложения.
CLIENT_ID = "YOUR_CLIENT_ID"
JWT_BEARER = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
REFRESH_MARGIN_SECONDS = 600
# Обновление, прервавшееся здесь по тайм-ауту, теряет новые токены, поэтому дайте 10 секунд на
# ответ. Не удавшееся подключение завершается ошибкой в течение 2.
REQUEST_TIMEOUT = httpx.Timeout(10, connect=2)
# Второй запрос должен начаться вскоре после первого или не начинаться вовсе.
# Страница даёт 30 секунд, но держите значение ниже тайм-аута чтения REQUEST_TIMEOUT:
# запрос, прерванный по тайм-ауту, нельзя отправлять повторно.
SECOND_REQUEST_DEADLINE_SECONDS = 4


@dataclass
class ConnectionTokens:
    refresh_token: str = field(repr=False)
    access_token: str = field(repr=False)
    expires_at: int  # the access token's expiry time, in Unix seconds
    refresh_expires_at: int  # the refresh token's expiry time, in Unix seconds
    # True: refresh-токен мог быть использован. Не отправляйте его повторно.
    on_hold: bool = False


class RefreshOnHold(Exception):
    """The refresh token might have been used, so a person decides what to do next.

    Don't catch this to try again. If new_tokens is set, the refresh succeeded and
    only the write failed: store those tokens.
    """

    new_tokens: ConnectionTokens | None = None


def client_assertion() -> str:
    """Reads your identity provider's JWT on every call, because its file rotates."""
    return Path(os.environ["ANTHROPIC_IDENTITY_TOKEN_FILE"]).read_text().strip()


def load_tokens(connection_id: str) -> ConnectionTokens:
    """Reads the connection's newest tokens from your secret store."""
    raise NotImplementedError("Read the tokens from your secret store.")


def save_tokens(connection_id: str, tokens: ConnectionTokens) -> None:
    """Writes the connection's newest tokens to your secret store."""
    raise NotImplementedError("Write the tokens to your secret store.")

Управление подключениями

Просмотр клиентов в Console

Помимо страницы OAuth-приложений, вы можете просмотреть все ваши профили пользователей на странице User profiles в Console. В этом списке и на странице сведений о каждом профиле пользователя Your spend показывает ваши собственные расходы на запросы этого профиля пользователя. Это стоимость до применения Anthropic каких-либо кредитов. На этих страницах подключение называется связью: профиль пользователя с активным подключением помечен как Linked, а профиль, подключение которого прекращено, — как Unlinked.

Нажмите на профиль пользователя, чтобы увидеть более подробные сведения о его использовании за последние 7, 28 или 90 дней.

Отслеживание использования каждого клиента

И Claude Console, и Usage and Cost Analytics API показывают использование по каждому профилю пользователя. Оба учитывают как запросы, которые оплачиваете вы, так и запросы, которые оплачивает ваш клиент. Ни один из них не показывает, сколько заплатил клиент и по каким тарифам.

В Console страница User profiles показывает Requests, Tokens и Your spend для каждого профиля пользователя за последние 28 дней. Запрос, который оплачивает ваш клиент, увеличивает Requests и Tokens профиля и ничего не добавляет к Your spend.

Вызывайте API с учётными данными Admin API, например с OAuth-токеном доступа с областью org:admin или с ключом Admin API. Не используйте ваш операторский сервисный аккаунт (шаг 3). Его правило федерации по умолчанию предоставляет workspace:developer, а не org:admin. Область org:admin охватывает весь Admin API, поэтому не добавляйте её операторскому сервисному аккаунту.

Чтобы получить отчёт по профилям пользователей через API, вызовите его конечную точку использования или конечную точку затрат. Чтобы получить одну строку для каждого профиля пользователя, группируйте только по user_profile_id и не указывайте time_bucket_width. Строку получает только тот профиль пользователя, у которого есть использование в запрошенном вами диапазоне времени. Ещё одна строка содержит user_profile_id со значением null. В ней учитывается использование, для которого не был указан профиль, и использование, которое измеряется вне запросов, например время работы контейнера выполнения кода.

На конечной точке затрат запрос, который оплачивает ваш клиент, добавляет 0 к amount и свою прейскурантную цену к list_amount. Поле amount — это та же величина, что и Your spend. В API нет поля, фильтра или значения group_by[], указывающего, кто заплатил. Строка, в которой amount равен 0, а list_amount больше 0, обычно означает, что клиент оплатил каждый запрос в этой строке.

Не используйте эти данные, чтобы останавливать использование клиента при достижении выбранной вами суммы. Ни Console, ни API не предоставляют данные в реальном времени. Данные в Console обновляются примерно раз в час, и запрос может появиться в них лишь через несколько часов. О задержке данных в API см. раздел Актуальность данных. О том, как действуют собственные лимиты клиента, сказано в разделе Пределы расходов.

Отвязывание клиента

Чтобы отвязать клиента в Console, используйте список на странице User profiles или кнопку Unlink в правом верхнем углу страницы сведений профиля пользователя.

Чтобы отвязать клиента со своего бэкенда, отправьте идентификатор подключения, сохранённый на шаге 8, на эндпоинт отзыва с той же аутентификацией клиента, что и при обмене кода. Чтобы вместо этого указать подключение по его профилю пользователя, отправьте user_profile_id вместо connection_id.

def revoke_connection(connection_id: str) -> list[str]:
    response = httpx.post(
        f"{AUTH}/v1/oauth/revoke",
        json={
            "connection_id": connection_id,
            "client_id": CLIENT_ID,
            "client_assertion_type": JWT_BEARER,
            "client_assertion": client_assertion(),
        },
    )
    response.raise_for_status()
    # ID подключений, завершённых этим запросом. Список пуст, если
    # подключение уже было завершено или ID неизвестен.
    return response.json()["revoked_connection_ids"]

auth.claude.com отвечает кодом HTTP 200 и revoked_connection_ids — идентификаторами подключений, прекращённых этим запросом. Список пуст, если подключение уже прекращено, поэтому запрос, отправляющий connection_id, можно безопасно повторять. Он также пуст, если идентификатор неизвестен, поэтому пустой список не доказывает, что подключение существовало. Другие параметры описаны в разделе Отзыв, а ошибки — в разделе Ошибки эндпоинта отзыва.

После прекращения подключения профиль пользователя отображается как Unlinked, а запрос, в котором для этого клиента задано bill_to: "user_profile", получает user_profile_not_billable. Вы по-прежнему можете обслуживать клиента за свой счёт с bill_to: "self". Что видит ваш клиент, описано в разделе После связывания, а о том, при каком способе отвязывания клиенту отправляется письмо, сказано в разделе Письма о связывании и отвязывании.

Связывание клиента с другой организацией Claude

Чтобы связать профиль пользователя клиента с другой организацией Claude, отвяжите клиента, а затем свяжите его снова.

После отвязывания запросы, за которые вы выставляете счёт этому клиенту, отклоняются. Так продолжается, пока пользователь не подтвердит приложение для другой организации и вы не обменяете код на шаге 8. Выполните следующие действия, когда этот пользователь будет готов подтвердить:

  1. Пропустите этот шаг, если ваш клиент уже отвязал ваше приложение на своей странице Linked platforms. В противном случае отвяжите клиента, как описано в разделе Отвязывание клиента. После этого профиль пользователя отображается как Unlinked на вашей странице User profiles.
  2. Повторите шаги с 5 по 8 с тем же профилем пользователя. Для шага 7 пользователю нужен аккаунт с ролью «Администратор» или «Оплата» в другой организации. Попросите пользователя подтвердить приложение для этой организации.
  3. Сохраните новый идентификатор подключения вместо прежнего. Если вы используете токены подключения, сделайте то же самое с новыми токенами.

Пока клиент не отвязан, страница подтверждения позволяет пользователю подтвердить приложение только для уже связанной организации.

Предел расходов относится к одной организации клиента и вашему приложению, поэтому предел первой организации не переносится. Правила описаны в разделе Пределы расходов.

Ожидаемые ошибки

Когда в запросе задано bill_to: "user_profile", Anthropic либо выставляет счёт вашему клиенту, либо отклоняет запрос. Он никогда не выставляет счёт вам вместо этого незаметно. В /v1/messages код из следующего списка находится в error.details.error_code. В /v1/chat/completions вы получаете тот же HTTP-статус и сообщение в формате OpenAI, но без кода:

  • 403 permission_error, user_profile_not_billable: Anthropic не может выставить этому клиенту счёт за этот запрос, и в ответе не указывается причина. Повторять не следует, за исключением первых 10 секунд после нового подключения. Прежде чем просить клиента выполнить связывание снова, см. раздел Причины ошибки user_profile_not_billable: повторное связывание устраняет лишь некоторые из них. Вы по-прежнему можете обслуживать клиента за свой счёт, повторно отправив запрос с bill_to: "self". В Anthropic SDK обрабатывайте user_profile_not_billable по классу ошибки для статуса 403 — это PermissionDeniedError. Ему соответствуют и другие ошибки 403, поэтому проверяйте также код ошибки.
  • 402 billing_error, linked_organization_billing_unavailable: Anthropic в настоящее время не может выставить счёт организации клиента (например, она приостановлена или её кредиты закончились после того, как Claude начал формировать ответ). В ответе не указывается причина. Клиент, у которого на момент поступления запроса нет кредитов, вместо этого получает linked_organization_spend_limit_reached. Повторять не следует. Попросите клиента проверить свой аккаунт Claude Platform. Вы по-прежнему можете обслуживать его за свой счёт, повторно отправив запрос с bill_to: "self".
  • 402 billing_error, linked_organization_spend_limit_reached: организация клиента достигла установленного ею лимита расходов. Это либо предел расходов, который действует для вашего приложения, либо ежемесячный лимит расходов для всей организации. Claude API отправляет тот же код, когда у организации нет кредитов, которыми можно оплатить запрос. В ответе не указывается, что именно из этого произошло. Запрос был отклонён до того, как Claude начал формировать ответ. Повторять не следует. Вы по-прежнему можете обслуживать клиента за свой счёт, повторно отправив запрос с bill_to: "self". Попросите клиента проверить в Claude Console следующее:
    • Предел расходов для вашего приложения: на странице вашего приложения в разделе Linked platforms он может установить или повысить предел расходов. Установленный там предел заменяет любой предел по умолчанию, заданный им для всех связанных платформ.
    • Месячный лимит расходов организации: в разделе Лимиты расходов он может его повысить.
    • Баланс кредитов: на своей странице Оплата он может увидеть баланс кредитов и купить кредиты. Некоторыми кредитами нельзя оплачивать такие запросы: см. раздел Какими кредитами можно оплачивать.
  • 503 overloaded_error: Anthropic не удалось сейчас подтвердить, можно ли выставить счёт клиенту. Повторите запрос с задержкой (backoff) и соблюдайте заголовок retry-after. Запрос не был обработан, и счёт за него не выставлен.
  • 400 invalid_request_error, user_profile_required: вы задали bill_to: "user_profile" без заголовка anthropic-user-profile-id. Такому запросу нужен этот заголовок. Исключение: запрос использует токен доступа подключения, и заголовок для него необязателен. Чтобы узнать, является ли заголовок необязательным, см. примечание в разделе Вызов Claude с токеном доступа подключения.
  • 400 invalid_request_error, без кода ошибки: заголовок anthropic-user-profile-id содержит идентификатор, который имеет неверный формат или не является профилем пользователя вашей организации.
  • 400 invalid_request_error, без кода ошибки: запрос аутентифицировался с помощью токена доступа подключения и либо задал bill_to: "self", либо указал профиль пользователя, отличный от того, которым ограничен токен. См. раздел Вызов Claude с токеном доступа подключения.

В /v1/messages и /v1/chat/completions токен доступа подключения не может отправить запрос, который оплачиваете вы. Чтобы повторно отправить отклонённый запрос с bill_to: "self", аутентифицируйтесь со своего бэкенда с собственными учётными данными вашего операторского сервисного аккаунта. Отказы, связанные с самим токеном, перечислены в разделе Вызов Claude с токеном доступа подключения.

Успешный ответ не сообщает, кому был выставлен счёт, поэтому ведите собственный учёт того, какие запросы вы отправили с bill_to: "user_profile".

Причины ошибки user_profile_not_billable

Проверьте их по порядку:

  • Ваш запрос. Запрос должен аутентифицироваться как операторский сервисный аккаунт вашего OAuth-приложения (шаг 3). Токен доступа подключения также аутентифицируется как этот сервисный аккаунт. Запрос, аутентифицированный любым другим способом, отклоняется. Например, это другой сервисный аккаунт или ключ API, не привязанный к этому сервисному аккаунту. Если заголовок anthropic-user-profile-id указывает один из ваших профилей, который не связан, запрос отклоняется. Если неверны учётные данные или заголовок, исправьте запрос. Новое подключение не поможет.
  • Подключение. Клиент не выполнил связывание через это приложение, либо подключение прекращено: его прекратил администратор организации клиента или вашей организации либо ваш бэкенд. Прекращённое подключение отображается как Unlinked на вашей странице User profiles. Профиль, связанный только через ваше тестовое приложение, не связан с вашим продакшен-приложением. Прекратите выставлять счета этому клиенту, пока он не выполнит связывание. Токен доступа подключения ограничен этим подключением, поэтому после повторного связывания клиента используйте токен доступа нового подключения. Если в вашем приложении отключена аутентификация только оператора, выставлять счёт клиенту можно только с токеном доступа его подключения. В этом случае клиент, для которого у вас нет действующего токена подключения billing:attribution, отображается как Linked, но должен подтвердить подключение снова, как описано в разделе Повторное связывание клиента.
  • Организация клиента. Она должна быть подходящим клиентом. Со своей стороны вы не можете это увидеть, поэтому обратитесь к вашей команде по работе с клиентами в Anthropic.

Новое подключение обычно начинает работать сразу, но это может занять около 10 секунд после обмена на шаге 8. Если в течение этих 10 секунд запрос отклоняется с user_profile_not_billable, отправьте его снова. После этого ожидание или повторные попытки не меняют результат. Записывайте в журнал полное error.message и заголовок ответа request-id для каждого отклонённого запроса. Если запросы для клиента, подключение которого отображается как Linked, по-прежнему отклоняются, а ваш запрос корректен, отправьте request-id отклонённого запроса вашей команде по работе с клиентами в Anthropic, чтобы Anthropic мог выяснить, почему он был отклонён.

Что видит ваш клиент

Связывание

Ваш пользователь подтверждает подключение на auth.claude.com после того, как ваше приложение перенаправит его на шаге 6. На шаге 7 перечислены экраны страницы подтверждения. На каждом экране отображается название вашего приложения и есть кнопка Cancel. Что пользователь делает на каждом экране:

  • Select an organization: пользователь выбирает, какую из своих организаций Claude связать. Страница показывает этот экран, только если у пользователя есть выбор организации.
  • How billing works: пользователь читает экран и нажимает Continue.
  • Set a monthly spend limit: пользователь вводит лимит для вашего приложения в целых долларах США и нажимает Continue. Поле суммы изначально пустое, поэтому страница не выбирает лимит за пользователя. Continue without a limit не сохраняет новый лимит, и предел или значение по умолчанию, которые клиент сохранил ранее, продолжают действовать. Введённый пользователем лимит — это предел расходов, описанный в разделе Пределы расходов. Пока ваше приложение находится в тестировании, этот экран выглядит иначе: см. раздел Пока ваше приложение находится в тестировании.
  • Последний экран: на этом экране перечислено, что ваше приложение сможет делать, включая выбранный пользователем лимит. Пользователь нажимает Link and authorize.

Страница подтверждения использует тот аккаунт Claude, в который выполнен вход в браузере, и предлагает только организации Claude этого аккаунта. Это может оказаться не тот аккаунт, который ожидает ваш пользователь, например личный вместо рабочего. Ваше приложение не может выбрать аккаунт. Параметры OpenID Connect prompt=select_account и login_hint не меняют аккаунт, который использует страница.

После связывания

Ваши клиенты управляют своими подключениями на странице Linked platforms в Claude Console. Они могут отвязать ваше приложение в любой момент. Anthropic не уведомляет вас, когда они это делают: вы не получаете ни события вебхука, ни письма по электронной почте.

После того как клиент отвязал приложение, запросы, за которые вы выставляете счёт этому клиенту, отклоняются с ошибкой 403 user_profile_not_billable (см. Причины ошибки user_profile_not_billable). Профиль пользователя клиента отображается как Unlinked на вашей странице User profiles в Console. Чтобы выполнить связывание снова, повторите шаги с 5 по 8 с существующим профилем пользователя клиента.

Письма о связывании и отвязывании

Письма Anthropic о связывании и отвязывании получают участники организации вашего клиента с ролью «Администратор» или «Оплата». Каждое письмо содержит ссылку на страницу Linked platforms клиента. Отправит ли Anthropic письмо, зависит от события:

  • Когда клиент связывает ваше приложение: Anthropic отправляет письмо, когда вы обмениваете код на шаге 8. За подтверждение, код которого вы так и не обменяли, письмо не отправляется. Оно также не отправляется, когда пользователь повторно подтверждает приложение, пока клиент ещё связан.
  • Когда клиент отвязывает ваше приложение: Anthropic отправляет письмо. В нём не указывается, кто отвязал ваше приложение.
  • Когда вы отвязываете клиента со своего бэкенда: Anthropic отправляет письмо.
  • Когда вы отвязываете клиента в Console: Anthropic не отправляет письмо.

Anthropic не гарантирует, что письмо будет отправлено или доставлено. Когда вы отвязываете клиента, сообщайте ему об этом сами. Не полагайтесь на эти письма, чтобы сообщить клиенту, что он связан.

Пределы расходов

Ваш клиент может установить для вашего приложения ежемесячный «spend cap» (предел расходов) в долларах США (USD). На странице подтверждения этот предел называется ежемесячным лимитом расходов, и пользователь, выполняющий связывание, может установить его там (см. Связывание). Он не зависит от Месячного лимита расходов организации, который действует для всей организации. Вы не можете узнать предел клиента или то, какая его часть уже израсходована.

Когда расходы клиента через ваше приложение достигают предела, Claude API отклоняет запросы, за которые вы выставляете ему счёт, с ошибкой 402. См. Ожидаемые ошибки. Отказы продолжаются до 00:00 UTC первого дня следующего месяца или до тех пор, пока клиент не повысит или не удалит предел. Изменение предела может вступить в силу примерно через минуту.

После связывания участник организации клиента с ролью «Администратор» или «Оплата» управляет пределами на странице Linked platforms в Console:

  • Установка или изменение предела: участник нажимает на ваше приложение, затем на Set spend cap или Edit spend cap.
  • Установка значения по умолчанию: в разделе Default spend cap участник нажимает Set default или Edit. Каждое связанное приложение без собственного предела может ежемесячно расходовать сумму до значения по умолчанию. Приложения не делят его между собой.
  • Удаление предела: участник нажимает на ваше приложение, затем на Edit spend cap и Remove cap. После этого ваше приложение использует значение по умолчанию. Если значение по умолчанию не задано, у вашего приложения нет предела.

Наименьший предел — $0 USD, при котором отклоняется каждый запрос, за который вы выставляете счёт этому клиенту. Console принимает целые суммы в долларах, практически без максимума. Предел учитывает стоимость токенов и плату за веб-поиск по прейскурантным ценам, без учёта каких-либо согласованных скидок. Счёт клиента может отличаться от суммы, которую учитывает предел.

Предел может быть выше Месячного лимита расходов организации, который клиент устанавливает в разделе Лимиты расходов. Claude API отклоняет запросы, за которые вы выставляете счёт клиенту, при достижении любого из них.

Пока ваше приложение находится в тестировании

Следующие ограничения действуют каждый раз, когда кто-либо связывает ваше приложение или изменяет его предел, пока приложение находится в тестировании, на проверке или не одобрено:

В тестировании, на проверке или не одобреноПосле запуска приложения
Ежемесячный лимит расходов на странице подтвержденияОбязателен, $50 USD или меньшеНеобязателен
Поле суммы на странице подтвержденияИзначально $50 USDИзначально пустое
Continue without a limit на странице подтвержденияНе предлагаетсяПредлагается
Удаление предела в ConsoleНевозможноВозможно
Наибольший предел, который может установить клиент$50 USDПрактически без максимума

После запуска вашего приложения предел, который клиент сохранил до этого, остаётся в силе. Затем клиент может повысить или удалить его.

Поддержка ваших клиентов

Вы оказываете своим клиентам поддержку по всем вопросам, связанным с вашим приложением, включая использование Claude, за которое вы выставляете им счета. Anthropic предоставляет вашим клиентам страницу подтверждения и страницу Linked platforms в Claude Console. На странице Linked platforms участник с ролью «Администратор» или «Оплата» может увидеть, во сколько ваше приложение обошлось организации в этом месяце. Он также может установить для вашего приложения ежемесячный предел расходов и отвязать его. Все остальные вопросы о вашем приложении должны адресоваться вам, поэтому сообщите своим клиентам, как с вами связаться.

Инициализация фрагментов кода

Примеры на Python на этой странице используют следующую общую настройку, которую вы пишете один раз. Она определяет:

  • импорты
  • идентификатор клиента и URI перенаправления вашего приложения
  • значение бета-заголовка для выставления счетов
  • клиент Claude API, который аутентифицируется как ваш сервисный аккаунт
  • client_assertion, который возвращает утверждение клиента, отправляемое вашим бэкендом в auth.claude.com
# В примерах на Python предполагаются следующая инициализация и переменные
import secrets
from urllib.parse import urlencode

import anthropic
import httpx
from anthropic.lib.credentials import IdentityTokenFile
from anthropic.types import Message
from anthropic.types.beta import BetaMessage
from authlib.oauth2.rfc7636 import create_s256_code_challenge

AUTH = "https://auth.claude.com"
# скопируйте с platform.claude.com после регистрации вашего OAuth-приложения.
CLIENT_ID = "YOUR_CLIENT_ID"
REDIRECT_URI = "https://app.example.com/claude/billing/callback"
JWT_BEARER = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
BILLING_BETA = "user-profiles-billing-2026-10-01"

# Клиент API. SDK обменивает JWT удостоверения вашей рабочей нагрузки на токен
# доступа и обновляет его, так что вам не нужно самим работать с "Bearer <access token>".
client = anthropic.Anthropic()

# Client assertion для auth.claude.com: сам JWT удостоверения, читается заново при
# каждом вызове, так как файл ротируется. Если в настройках аутентификации клиента
# вашего приложения указана иная аудитория, чем в правиле федерации, укажите здесь
# второй файл токена: IdentityTokenFile("/path/to/other/token").
client_assertion = IdentityTokenFile()

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