---
title: Справочник по OAuth
url: https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference
description: Конечные точки, аутентификация клиента, параметры запросов, области доступа, ответы с токенами, отзыв, сроки действия, правила для URI перенаправления и ошибки.
---

<Warning>
  Claude Platform OAuth — это Beta Service: программное обеспечение предварительного выпуска, предоставляемое в рамках вашего соглашения с Anthropic, например [Коммерческих условий обслуживания](https://www.anthropic.com/legal/commercial-terms) и [Условий для отдельных сервисов](https://www.anthropic.com/legal/service-specific-terms). Конечные точки, параметры и поведение могут меняться в период бета-тестирования. Сервис может не подходить для использования в продакшене.
</Warning>

На этой странице собраны конечные точки, параметры, правила проверки и соответствия ошибок для [Claude Platform OAuth](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/overview). Пошаговую инструкцию см. в разделе [Linked billing](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections).

## Конечные точки

| Конечная точка                                                                                        | URL                                                                         |
| ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Издатель (issuer)                                                                                     | `https://identity.anthropic.com/users`                                      |
| Документ обнаружения (discovery document)                                                             | `https://identity.anthropic.com/users/.well-known/openid-configuration`     |
| Ключи подписи (JWKS)                                                                                  | `jwks_uri` в документе обнаружения, размещённый на `identity.anthropic.com` |
| Конечная точка авторизации (страница входа и согласия)                                                | `https://auth.claude.com/oauth/authorize`                                   |
| Конечная точка «pushed authorization request» (предварительно переданный запрос авторизации), или PAR | `https://auth.claude.com/v1/oauth/par`                                      |
| Конечная точка токенов                                                                                | `https://auth.claude.com/v1/oauth/token`                                    |
| Конечная точка отзыва                                                                                 | `https://auth.claude.com/v1/oauth/revoke`                                   |
| Claude API (профили пользователей и запросы, по которым выставляется счёт клиенту)                    | `https://api.anthropic.com`                                                 |

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

## Значения документа обнаружения

| Поле                                    | Значение                                         |
| --------------------------------------- | ------------------------------------------------ |
| `issuer`                                | `https://identity.anthropic.com/users`           |
| `authorization_endpoint`                | `https://auth.claude.com/oauth/authorize`        |
| `token_endpoint`                        | `https://auth.claude.com/v1/oauth/token`         |
| `jwks_uri`                              | `https://identity.anthropic.com/users/jwks.json` |
| `response_types_supported`              | `code`                                           |
| `grant_types_supported`                 | `authorization_code`, `refresh_token`            |
| `code_challenge_methods_supported`      | `S256`                                           |
| `token_endpoint_auth_methods_supported` | `private_key_jwt`                                |
| `id_token_signing_alg_values_supported` | `ES256`                                          |
| `scopes_supported`                      | `openid`, `email`                                |
| `subject_types_supported`               | `public`, `pairwise`                             |

`auth.claude.com` возвращает токен обновления для Linked billing, только если клиент одобрил `offline_access` вместе с `billing:attribution`: см. раздел [OAuth-токены для подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection).

## Аутентификация клиента

`auth.claude.com` аутентифицирует конфиденциального клиента методом `private_key_jwt` ([RFC 7523](https://www.rfc-editor.org/rfc/rfc7523)). Отправляйте эти параметры в каждом запросе к конечной точке PAR, конечной точке токенов и конечной точке отзыва. Никогда не передавайте учётные данные в строке запроса URL: `auth.claude.com` их отклоняет.

| Параметр                | Значение                                                                                                                                                                                                                   |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `client_id`             | Идентификатор клиента вашего приложения OAuth                                                                                                                                                                              |
| `client_assertion_type` | `urn:ietf:params:oauth:client-assertion-type:jwt-bearer`                                                                                                                                                                   |
| `client_assertion`      | JWT от вашего поставщика удостоверений с утверждениями, указанными в разделе [Утверждения клиентского подтверждения](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#client-assertion-claims) |

### Утверждения клиентского подтверждения

Клиентское подтверждение (client assertion) должно содержать все следующие утверждения (claims), а его заголовок должен содержать `kid` ключа из вашего JWKS.

| Утверждение | Требование                                                                                                                                                                                                      |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `iss`       | URL издателя вашего поставщика удостоверений, точно в том виде, в каком он зарегистрирован через [Workload Identity Federation](https://platform.claude.com/docs/ru/manage-claude/workload-identity-federation) |
| `sub`       | Значение, соответствующее шаблону субъекта в настройках аутентификации клиента вашего приложения, если вы его задали                                                                                            |
| `aud`       | Ровно одна аудитория: значение из настроек аутентификации клиента вашего приложения. `auth.claude.com` отклоняет подтверждение, в котором указано более одной аудитории.                                        |
| `iat`       | Время, когда ваш поставщик удостоверений выпустил JWT                                                                                                                                                           |
| `exp`       | Время истечения срока действия, не более чем через 1 час после `iat`. По возможности используйте более короткий срок действия: любой, кто перехватит подтверждение, сможет использовать его до истечения срока. |

Пример полезной нагрузки подтверждения:

```json
{
  "iss": "https://idp.example.com",
  "sub": "workload:prod:claude-integration-backend",
  "aud": "YOUR_CONFIGURED_AUDIENCE",
  "iat": 1791230000,
  "exp": 1791230300
}
```

Делайте шаблон субъекта и условия утверждений настолько узкими, насколько позволяет ваш бэкенд. `auth.claude.com` принимает любой JWT от вашего поставщика удостоверений, соответствующий им, в качестве аутентификации вашего приложения.

## Параметры запроса авторизации

Отправляйте эти параметры, кроме `request_uri`, в JSON-теле предварительно переданного запроса авторизации.

| Параметр                 | Linked billing | Описание                                                                                                                                                                                                                    |
| ------------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `response_type`          | Обязательный   | Значение `code`                                                                                                                                                                                                             |
| `client_id`              | Обязательный   | Идентификатор клиента вашего приложения OAuth                                                                                                                                                                               |
| `redirect_uri`           | Обязательный   | URI, точно совпадающий с зарегистрированным URI перенаправления, длиной до 2048 символов                                                                                                                                    |
| `scope`                  | Обязательный   | Для подключения для выставления счетов — `billing:attribution` или `billing:attribution offline_access`. См. раздел [Области доступа](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#scopes). |
| `state`                  | Обязательный   | Случайное одноразовое значение длиной до 2048 символов, которое вы проверяете при обратном вызове                                                                                                                           |
| `code_challenge`         | Обязательный   | `BASE64URL(SHA256(code_verifier))`, где `code_verifier` имеет длину от 43 до 128 символов                                                                                                                                   |
| `code_challenge_method`  | Обязательный   | Значение `S256`                                                                                                                                                                                                             |
| `connection_type`        | Обязательный   | Значение `organization_shared`. Это значение запрашивает подключение организации для выставления счетов.                                                                                                                    |
| `connection_auth_target` | Обязательный   | В какую организацию направляются запросы подключения. Для Linked billing отправляйте `platform` (владелец приложения OAuth).                                                                                                |
| `user_profile_id`        | Обязательный   | Идентификатор активного профиля пользователя в вашей организации, представляющего клиента                                                                                                                                   |
| `request_uri`            | Обязательный   | Значение, которое вернула конечная точка PAR. Отправьте его в конечную точку авторизации вместе с `client_id` и без других параметров.                                                                                      |

Конечная точка PAR возвращает HTTP 201 с `request_uri` и `expires_in` (600 секунд).

## Области доступа

| Категория          | Область доступа           | Описание                                                                                                                                                                                                                                                                                                                                                                                                                       | Тип подключения       | Тип клиента      |
| ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- | ---------------- |
| Общие              | `offline_access`          | Предоставляет приложению токен обновления, представляющий другие запрошенные области доступа. В подключении `organization_shared` отправляйте её только вместе с `billing:attribution`.                                                                                                                                                                                                                                        | `organization_shared` | Конфиденциальный |
| Выставление счетов | `billing:attribution`     | Подключение, которое позволяет выставлять организации Claude клиента счета за запросы к Claude API, которые клиент поручает вам выполнять. Отправляйте её отдельно или вместе с `offline_access`, чтобы также получить токен обновления. См. раздел [OAuth-токены для подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection). | `organization_shared` | Конфиденциальный |
| Выставление счетов | `org:billing_attribution` | Устарела: используйте `billing:attribution`.                                                                                                                                                                                                                                                                                                                                                                                   | `organization_shared` | Конфиденциальный |

## Запрос и ответ токена

Отправляйте запросы токенов на `https://auth.claude.com/v1/oauth/token` с JSON-телом.

| Параметр                                                 | Значение                                                                                                                                   |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `grant_type`                                             | `authorization_code`                                                                                                                       |
| `code`                                                   | Код из обратного вызова                                                                                                                    |
| `redirect_uri`                                           | Тот же `redirect_uri`, который вы отправили в запросе авторизации                                                                          |
| `code_verifier`                                          | Верификатор кода PKCE                                                                                                                      |
| `client_id`, `client_assertion_type`, `client_assertion` | Как в разделе [Аутентификация клиента](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#client-authentication) |

Ответ с токеном содержит следующие поля:

| Поле ответа                | Linked billing                                                                                                                                  |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `access_token`             | [Токен доступа подключения](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection) |
| `token_type`               | `Bearer`                                                                                                                                        |
| `expires_in`               | Не более `3600`                                                                                                                                 |
| `scope`                    | `workspace:inference`                                                                                                                           |
| `connection_id`            | Идентификатор подключения, например `ocon_EXAMPLE`. Сохраните его.                                                                              |
| `refresh_token`            | Возвращается, только если клиент одобрил `offline_access`                                                                                       |
| `refresh_token_expires_in` | Количество секунд до истечения срока действия `refresh_token`. Отсутствует, если `refresh_token` нет.                                           |

Для обновления отправьте `grant_type` со значением `refresh_token`, ваш `refresh_token` и параметры из раздела [Аутентификация клиента](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#client-authentication). Обновление для подключения для выставления счетов выполняется по правилам из раздела [OAuth-токены для подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection).

## OAuth-токены для подключения для выставления счетов

Для подключения для выставления счетов конечная точка токенов возвращает токен доступа подключения. Этот токен аутентифицирует как [сервисный аккаунт оператора](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#terms) (operator service account) вашего приложения в рабочей области, указанной в настройке `connection_token_workspace_id` приложения. В `/v1/messages` и `/v1/chat/completions` счёт за запрос с этим токеном выставляется клиенту этого подключения и никому другому. Если клиент также одобрил `offline_access`, конечная точка токенов возвращает и токен обновления, а grant `refresh_token` обновляет оба токена. Настройку и пошаговую инструкцию см. в разделе [OAuth-токены для каждого подключения](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#oauth-tokens-for-each-connection) на странице Linked billing.

Оба grant принимают параметры из раздела [Запрос и ответ токена](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#token-request-and-response) вместе с параметрами из раздела [Аутентификация клиента](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#client-authentication). Запрос обновления не должен содержать параметр `scope`. Ответ с токеном содержит следующие поля:

| Поле ответа                | Значение                                                                                                |
| -------------------------- | ------------------------------------------------------------------------------------------------------- |
| `access_token`             | Токен доступа подключения                                                                               |
| `token_type`               | `Bearer`                                                                                                |
| `expires_in`               | Количество секунд до истечения срока действия токена доступа, не более `3600`                           |
| `scope`                    | Всегда `workspace:inference`                                                                            |
| `connection_id`            | Идентификатор подключения, например `ocon_EXAMPLE`. Возвращается только при grant `authorization_code`. |
| `refresh_token`            | Токен обновления подключения. Возвращается, только если клиент одобрил `offline_access`.                |
| `refresh_token_expires_in` | Количество секунд до истечения срока действия `refresh_token`                                           |

Каждое обновление возвращает новый `access_token` и новый `refresh_token`. Отправленный вами токен обновления заменяется, а предыдущий токен доступа перестаёт работать в течение нескольких минут. Вы можете отправить заменённый токен обновления ещё один раз, в течение 30 секунд после обновления, которое его заменило, чтобы повторить запрос, ответ на который вы потеряли. Этот второй запрос возвращает ещё одну новую пару и аннулирует пару из потерянного ответа: используйте только самую новую пару. Третий запрос с заменённым токеном получает `invalid_grant`, как и второй запрос, поступивший по истечении 30 секунд. В течение 30 секунд такой запрос ничего не аннулирует. По истечении 30 секунд он аннулирует все токены подключения и завершает подключение. Правила и ошибки обновления приведены в разделе [Обновление токенов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection).

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

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

О том, как Claude API выставляет счёт за запрос с токеном доступа подключения, см. раздел [Вызов Claude с токеном доступа подключения](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#call-claude-with-a-connections-access-token).

## Отзыв

Отправляйте запросы на отзыв на `https://auth.claude.com/v1/oauth/revoke` с телом в формате JSON или form-encoded. Конечная точка соответствует [RFC 7009](https://www.rfc-editor.org/rfc/rfc7009) и также принимает идентификаторы подключений и профилей пользователей.

Отправляйте параметры из раздела [Аутентификация клиента](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#client-authentication) и ровно один из параметров из этой таблицы. `aud` утверждения клиента — это значение из настроек аутентификации клиента вашего приложения, а не URL отзыва.

| Параметр          | Что завершается                                                                                                                            |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `connection_id`   | Одно из подключений вашего приложения, указанное как идентификатор `ocon_`                                                                 |
| `user_profile_id` | Все подключения вашего приложения для одного профиля пользователя, указанного как идентификатор `uprof_`                                   |
| `token`           | Для Linked billing вместо этого отправляйте `connection_id` или `user_profile_id`: отправка токена доступа может не завершить подключение. |

`auth.claude.com` принимает `token_type_hint` и игнорирует его.

Конечная точка возвращает HTTP 200 и идентификаторы подключений, которые завершил запрос:

```json
{
  "revoked_connection_ids": ["ocon_EXAMPLE"]
}
```

Список пуст, если токен или идентификатор неизвестен или принадлежит другому приложению, если подключение уже завершено или если запрос аннулировал токен, но не завершил ни одного подключения. В ответе не указывается, какая именно причина.

После завершения подключения для выставления счетов Claude API отклоняет запросы, по которым выставляется счёт этому клиенту, с ошибкой `user_profile_not_billable`, а OAuth-токены подключения перестают работать. После этого не полагайтесь на токен доступа от подключения, одобренного с устаревшей областью доступа `org:billing_attribution`: он может перестать работать сразу или продолжать работать до истечения срока действия.

## Сроки действия

| Элемент                             | Срок действия                                                  |
| ----------------------------------- | -------------------------------------------------------------- |
| `request_uri` от конечной точки PAR | 10 минут, однократное использование                            |
| Код авторизации                     | 5 минут, однократное использование                             |
| `access_token`                      | До 1 часа                                                      |
| `refresh_token`                     | До 1 года с момента обмена кода. Обновление не продлевает его. |

Это текущие значения. Считывайте `expires_in` и `refresh_token_expires_in` из каждого ответа, а не полагайтесь на фиксированные значения.

## Правила для URI перенаправления

* Каждый `redirect_uri` должен точно совпадать с URI, зарегистрированным в вашем приложении. `auth.claude.com` не использует сопоставление по шаблону или префиксу.
* Каждый URI перенаправления должен использовать HTTPS и не должен содержать фрагмент. URI для локальной разработки на `localhost`, `127.0.0.1` или `[::1]` могут использовать HTTP.
* URI для локальной разработки, зарегистрированный со звёздочкой в качестве порта, например `http://localhost:*/callback`, соответствует любому порту.
* Для каждого приложения можно зарегистрировать до 10 URI перенаправления.
* `auth.claude.com` отправляет ошибки на ваш URI перенаправления, только если `redirect_uri` совпадает с зарегистрированным URI. Для любого другого `redirect_uri` `auth.claude.com` не перенаправляет браузер.

## Ошибки

### Ошибки при перенаправлении

`auth.claude.com` возвращает ошибки в виде параметров запроса `error`, `error_description` и `state` в вашем URI перенаправления. Это стандартные ошибки OAuth 2.0 ([RFC 6749](https://www.rfc-editor.org/rfc/rfc6749)), за исключением `user_profile_already_linked`, которая специфична для Anthropic.

| Ошибка                        | Когда возникает                                                                                                                                                                                                                                                   | Что показать пользователю                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `access_denied`               | Человек отказался или не может одобрить этот запрос. Для подключения для выставления счетов человек должен быть администратором организации Claude.                                                                                                               | Объясните, что подключение не завершено, и не предполагайте, что человек отказался. Для подключения для выставления счетов следуйте инструкциям из раздела [Ваш URI перенаправления получает `error=access_denied`](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#access-denied) руководства по Linked billing, где перечислены причины и то, что следует сообщить человеку. В остальных случаях попросите человека связаться с вами. |
| `server_error`                | `auth.claude.com` не удалось обработать запрос.                                                                                                                                                                                                                   | Попросите пользователя повторить попытку.                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `user_profile_already_linked` | Только для Linked billing. Организация клиента уже подключена к вашему приложению через другой профиль пользователя. Каждая организация клиента может иметь одно подключение к вашему приложению. `auth.claude.com` уже попросил администратора связаться с вами. | Объясните, что их организация уже подключена к вашему приложению.                                                                                                                                                                                                                                                                                                                                                                                                                     |

Если срок действия `request_uri` истёк или вы уже использовали его, `auth.claude.com` показывает страницу ошибки и не перенаправляет браузер обратно в ваше приложение. Начните поток заново с новым предварительно переданным запросом авторизации.

### Ошибки конечных точек PAR и токенов

Эти конечные точки возвращают JSON-тело с `error` и `error_description`.

| Ошибка                        | Когда возникает                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `invalid_request`             | Обязательный параметр отсутствует или недопустим, например отсутствует `state` или вызов PKCE, либо `user_profile_id` не является идентификатором активного профиля пользователя в вашей организации.                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `invalid_client`              | `auth.claude.com` не удалось аутентифицировать ваше приложение: идентификатор клиента неизвестен или клиентское подтверждение не прошло проверку. Сверьте `iss`, `sub` и `aud` подтверждения с настройками аутентификации клиента вашего приложения и убедитесь, что ваш поставщик удостоверений подписал его ключом из вашего JWKS.                                                                                                                                                                                                                                                                                                                         |
| `invalid_scope`               | Запрошенная область доступа не разрешена для этого приложения или этого типа подключения. Для [токенов подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection) это также означает, что запрос обновления отправил параметр `scope`, который он не принимает, или что `billing:attribution` больше не зарегистрирована для вашего приложения. При обмене кода вторая причина приводит к расходованию кода.                                                                                                                                                    |
| `invalid_grant`               | Срок действия кода истёк, вы уже использовали его, или он не соответствует `redirect_uri` или `code_verifier`. При обновлении — срок действия токена обновления истёк или он больше недействителен: следуйте инструкциям из раздела [Обновление токенов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection).                                                                                                                                                                                                                                                                              |
| `unauthorized_client`         | Ваше приложение не настроено для этого запроса. Для Linked billing сначала проверьте сервисный аккаунт оператора приложения и его рабочую область: см. раздел [Обмен кода возвращает `unauthorized_client`](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#code-exchange-unauthorized-client). Для [токенов подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection) `error_description` указывает причину, например отсутствие рабочей области. Этот отказ не расходует код и не аннулирует токен обновления. |
| `user_profile_already_linked` | Только для Linked billing, от конечной точки токенов. Между одобрением и этим запросом профиль пользователя был подключён к вашему приложению через другую организацию клиента, или организация клиента была подключена через другой профиль пользователя.                                                                                                                                                                                                                                                                                                                                                                                                   |

Если `auth.claude.com` применяет к запросу ограничение скорости, испытывает сбой или получает неизвестный `grant_type` либо параметр, длина которого превышает допустимый предел, он возвращает ошибку в другом формате, который может не быть JSON. Повторяйте запрос только при ответах HTTP 429 и 5xx, с экспоненциальной задержкой. Считайте любой другой статус ошибкой в запросе. Для обновления подключения для выставления счетов следуйте инструкциям из раздела [Обновление токенов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection) вместо общей экспоненциальной задержки. Если ответ содержит заголовок `retry-after`, подождите как минимум указанное время. Отправляйте следующий запрос из собственного кода и не полагайтесь на автоматические повторы библиотеки HTTP-клиента: для такого ответа они могут не сработать. В разделе [Обновление токенов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#refresh-the-connection) также описано, когда повтор безопасен, поскольку уже использованный токен обновления может завершить подключение при повторной отправке.

### Ошибки конечной точки отзыва

Для большинства запросов, которые отклоняет `auth.claude.com`, конечная точка отзыва возвращает HTTP 400 и JSON-тело с `error` и `error_description`.

| Ошибка                | Когда возникает                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `invalid_request`     | Обязательный параметр отсутствует или недопустим, например отсутствует `client_id`. Запрос не содержит ни одного из параметров `token`, `connection_id` и `user_profile_id` или содержит более одного из них. Идентификатор имеет неверный формат, например неверный префикс. Учётные данные или `token` находятся в строке запроса URL. У профиля пользователя слишком много подключений для одного запроса: запрос мог завершить некоторые из них, поэтому завершите остальные с помощью `connection_id`. |
| `invalid_client`      | `auth.claude.com` не удалось аутентифицировать ваше приложение. Что проверить, см. в описании `invalid_client` в разделе [Ошибки конечных точек PAR и токенов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#errors-from-the-par-and-token-endpoints).                                                                                                                                                                                                                       |
| `unauthorized_client` | Ваше приложение не настроено для этого запроса. Свяжитесь с вашей командой по работе с клиентами Anthropic.                                                                                                                                                                                                                                                                                                                                                                                                 |

Ответы из следующей таблицы используют другой формат, который может не быть JSON. Если тело представлено в формате JSON, `error` является объектом, а не строкой.

| Статус | Когда возникает                                                                     | Что делать                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------ | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | Длина параметра превышает допустимый предел.                                        | Исправьте запрос. Не повторяйте его.                                                                                                                                                                                                                                                                                                                                                                                   |
| 429    | С вашего IP-адреса поступило слишком много неудачных запросов.                      | Повторите запрос с экспоненциальной задержкой.                                                                                                                                                                                                                                                                                                                                                                         |
| 500    | `auth.claude.com` не удалось обработать запрос.                                     | Повторите запрос с экспоненциальной задержкой. Если ошибка повторяется, свяжитесь с вашей командой по работе с клиентами Anthropic.                                                                                                                                                                                                                                                                                    |
| 501    | Anthropic не включила эту конечную точку для вашей организации.                     | Не повторяйте запрос. Свяжитесь с вашей командой по работе с клиентами Anthropic.                                                                                                                                                                                                                                                                                                                                      |
| 503    | Запрос не был выполнен до конца. Всё, что он успел завершить, остаётся завершённым. | Повторите запрос с экспоненциальной задержкой, с теми же параметрами и новым утверждением клиента. Повтор завершает оставшееся, и его список не включает подключения, которые завершил предыдущий запрос. Если вы отправляли `user_profile_id`, повторите запрос в течение суток: после этого повтор может вернуть 200 с пустым списком и ничего не завершить. Повтор с каждым `connection_id` работает в любое время. |

### Ошибки выставления счетов

Эти ошибки относятся к запросам к Claude API, в которых `billing_policy.bill_to` имеет значение `"user_profile"` или которые аутентифицируются с помощью [токена доступа подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection). Claude API не выставляет счёт ни одной из организаций за отклонённый запрос. Ни один из ответов 402 и 403 не подлежит повтору, за исключением отказа `user_profile_not_billable` в течение первых 10 секунд после нового подключения.

| Статус | Тип и код ошибки                                           | Когда возникает                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------ | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 400    | `invalid_request_error`                                    | Запрос отправляет `billing_policy` без бета-заголовка `user-profiles-billing-2026-10-01`. Или в объекте `billing_policy` отсутствует или недопустимо какое-либо поле. С токеном доступа подключения для выставления счетов `bill_to` можно не указывать. Или запрос использует выполнение кода вне разрешённой комбинации.                                                                                                                                                                                                                                                                                                                                                                                    |
| 400    | `invalid_request_error`, `user_profile_required`           | `bill_to` имеет значение `"user_profile"`, запрос не содержит идентификатор профиля пользователя и не аутентифицируется с помощью токена доступа подключения для выставления счетов.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 400    | `invalid_request_error`, без кода ошибки                   | Запрос аутентифицируется с помощью токена доступа подключения для выставления счетов и либо задаёт для `bill_to` значение `"self"`, либо указывает профиль пользователя, отличный от того, которым ограничен токен. В каждом из этих двух отказов причина указывается в `error.message`.                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 401    | `authentication_error`                                     | Запрос аутентифицируется с помощью токена доступа подключения для выставления счетов, срок действия которого истёк, который был заменён при обновлении или подключение которого завершено. В сообщении указывается, истёк ли срок действия токена или он был аннулирован. Отправьте запрос повторно с текущим токеном доступа или подключите клиента заново, если подключение завершено. После завершения подключения каждый новый запрос с его токеном доступа может получить этот ответ 401 или ответ 403 `user_profile_not_billable`, в произвольном порядке.                                                                                                                                              |
| 402    | `billing_error`, `linked_organization_spend_limit_reached` | Организация клиента достигла установленного ею лимита расходов — для вашего приложения OAuth или для всей организации. Claude API отправляет тот же код, когда у организации нет кредитов, которыми можно оплатить запрос. В ответе не указывается, какой именно случай. Попросите клиента проверить оба лимита и баланс кредитов. В разделе [Ожидаемые ошибки](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#expected-errors) для Linked billing описано, где задаётся каждый из них и что следует изменить.                                                                                                                                                 |
| 402    | `billing_error`, `linked_organization_billing_unavailable` | Anthropic в настоящее время не может выставить счёт организации клиента из-за проблемы с собственным аккаунтом Anthropic этой организации. Тот же код завершает ответ, который Claude уже начал, когда у организации заканчиваются кредиты. Попросите клиента проверить статус оплаты в Anthropic.                                                                                                                                                                                                                                                                                                                                                                                                            |
| 403    | `permission_error`, без кода ошибки                        | Anthropic не выставляет счета вашей организации напрямую, поэтому не может выставлять счета клиентам от вашего имени.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| 403    | `permission_error`, `user_profile_not_billable`            | У профиля пользователя нет подключения к организации клиента, администратор или ваш бэкенд завершил подключение, организация клиента не платит Anthropic напрямую за использование API (учитываются как предоплаченные кредиты, так и оплата по выставленным счетам), или запрос не аутентифицируется как сервисный аккаунт вашего приложения. В ответе не указывается, какая именно причина. Токен доступа подключения также может получить эту ошибку после завершения подключения. В разделе [Причины ошибки `user_profile_not_billable`](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/organization-billing-connections#user-profile-not-billable) описано, что проверить в каждом случае. |
| 503    | `overloaded_error`                                         | Claude API временно не может подтвердить, может ли он выставить счёт клиенту. Повторите запрос. Если ответ содержит заголовок `retry-after`, подождите указанное время перед повтором.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

В `/v1/messages` код ошибки находится в `error.details.error_code`. В `/v1/chat/completions` `error.type` всегда имеет значение `invalid_request_error`, `error.code` содержит тип ошибки Anthropic (например, `permission_error` или `billing_error`), а код ошибки в ответе отсутствует, поэтому ориентируйтесь на статус HTTP и `error.code`.

## Стандарты

| Стандарт                                                                                           | Где применяется                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [OAuth 2.0 (RFC 6749)](https://www.rfc-editor.org/rfc/rfc6749)                                     | Поток кода авторизации, конечная точка токенов и ответы с ошибками                                                                                                             |
| [PKCE (RFC 7636)](https://www.rfc-editor.org/rfc/rfc7636)                                          | Обязателен с `S256` в каждом запросе авторизации                                                                                                                               |
| [Предварительно переданные запросы авторизации (RFC 9126)](https://www.rfc-editor.org/rfc/rfc9126) | Обязательны для Linked billing.                                                                                                                                                |
| [Отзыв токенов (RFC 7009)](https://www.rfc-editor.org/rfc/rfc7009)                                 | Конечная точка отзыва, которая также принимает идентификаторы подключений и профилей пользователей и возвращает идентификаторы завершённых ею подключений                      |
| [Аутентификация клиента с помощью JWT (RFC 7523)](https://www.rfc-editor.org/rfc/rfc7523)          | Аутентификация клиента `private_key_jwt` на конечных точках PAR, токенов и отзыва, а также обмен токена сервисного аккаунта для запросов, по которым выставляется счёт клиенту |

## Термины, используемые на этих страницах

Следующие значения применяются только к Claude Platform OAuth.

| Термин                                             | Значение                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Организация Claude                                 | Аккаунт организации в Anthropic. Он есть у вашей компании, а также у каждого клиента, который подключает свою организацию для выставления счетов.                                                                                                                                                                                                                                                                                                                                                                  |
| Администратор                                      | Участник организации Claude с ролью «Администратор» или «Оплата».                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Приложение OAuth                                   | Регистрация в вашей организации Claude, которая идентифицирует ваш продукт для `auth.claude.com`. Она имеет идентификатор клиента, название, логотип, URL домашней страницы, URI перенаправления и поддерживаемые типы подключения.                                                                                                                                                                                                                                                                                |
| Тип подключения                                    | Кто одобряет подключение: администратор от имени всей организации (`organization_shared`, для Linked billing).                                                                                                                                                                                                                                                                                                                                                                                                     |
| Поставщик удостоверений                            | Сервис в вашей собственной инфраструктуре, который подписывает краткосрочные JWT для вашего бэкенда и публикует свои открытые ключи в виде набора JSON Web Key Set (JWKS), например сервис идентификации рабочих нагрузок вашего облачного провайдера или ваш собственный OIDC-совместимый издатель. На этих страницах «ваш поставщик удостоверений» всегда означает этот сервис, а не Anthropic.                                                                                                                  |
| Клиентское подтверждение                           | Краткосрочный JWT, который подписывает ваш поставщик удостоверений и отправляет ваш бэкенд для аутентификации вашего приложения OAuth. Это метод аутентификации клиента `private_key_jwt` (RFC 7523).                                                                                                                                                                                                                                                                                                              |
| Предварительно переданный запрос авторизации (PAR) | Запрос, в котором ваш бэкенд отправляет параметры авторизации напрямую в `auth.claude.com` и получает `request_uri` для использования при перенаправлении браузера (RFC 9126).                                                                                                                                                                                                                                                                                                                                     |
| Workload Identity Federation                       | Функция Claude Console, с помощью которой ваша организация регистрирует вашего поставщика удостоверений, чтобы Anthropic принимала JWT, подписанные ключами из вашего JWKS.                                                                                                                                                                                                                                                                                                                                        |
| Документ обнаружения                               | Документ OIDC, в котором перечислены издатель, конечные точки и ключи подписи Anthropic.                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Профиль пользователя                               | Запись, которую вы создаёте в своей собственной организации Claude для представления одного из ваших клиентов. Подключение для выставления счетов связывает профиль пользователя с организацией Claude клиента.                                                                                                                                                                                                                                                                                                    |
| Сервисный аккаунт                                  | Аккаунт в вашей организации Claude, не принадлежащий человеку. Для Linked billing ваше приложение OAuth связано с одним сервисным аккаунтом — его сервисным аккаунтом оператора, и ваш бэкенд аутентифицируется как этот сервисный аккаунт, когда отправляет запрос, по которому выставляется счёт клиенту.                                                                                                                                                                                                        |
| OAuth-токены подключения                           | Токен доступа, который `auth.claude.com` возвращает для подключения для выставления счетов, и токен обновления, который он возвращает, если клиент также одобрил `offline_access`. Токен доступа аутентифицирует как сервисный аккаунт оператора и позволяет выставлять счета только профилю пользователя этого подключения. См. раздел [OAuth-токены для подключения для выставления счетов](https://platform.claude.com/docs/ru/manage-claude/oauth-apps/oauth-reference#oauth-tokens-for-a-billing-connection). |
