К содержимому
Блог

Как получить API-ключ Claude: консоль Anthropic или Relay

Как получить API-ключ Claude: консоль Anthropic или Relay

Ключ для Claude выдают в двух местах: в консоли Anthropic и в кабинете Relay. Ключ консоли привязан к аккаунту Anthropic и работает с их адресом. Ключ Relay выглядит как sk-rly-..., ходит на https://relay-llm.ru и тратит баланс аккаунта Relay. Клиенту всё равно, откуда ключ: меняются значение и базовый адрес.

Коротко

  • Консоль Anthropic: Settings, затем API keys. Секрет показывается один раз, начинается с sk-ant.

  • Кабинет Relay: раздел «API-ключи». Секрет sk-rly-... тоже виден один раз, а к ключу привязываются лимиты в долларах, срок и список моделей.

  • Anthropic-клиентам нужен адрес без /v1, OpenAI-клиентам с /v1.

Чем различаются два ключа

Консоль AnthropicКабинет Relay
Где выпускаетсяplatform.claude.com, Settings, API keysраздел ключей
Адрес APIhttps://api.anthropic.comhttps://relay-llm.ru
Кто списывает деньгиAnthropicбаланс аккаунта Relay, один на все ключи
Моделисемейство Claudeвесь каталог Relay, Claude среди прочих
Защита при созданиитип ключа, срок действия, рабочее пространствоимя, лимиты на день, месяц и весь срок, срок действия, список моделей

В консоли Anthropic при создании выбирают тип ключа. Личный ключ действует от вашего имени и перестаёт работать, когда вы уходите из организации. Ключ сервисного аккаунта подходит для CI и продакшена. По странице Anthropic на 14 октября 2026 личный ключ рекомендован для собственной разработки, а для всего общего лучше сервисный аккаунт.

Выбирать между консолью и Relay стоит по тому, где у вас уже есть аккаунт и баланс. Нужны модели нескольких вендоров на одном ключе: подойдёт Relay. Вся работа идёт у Anthropic напрямую: хватит консоли. Смешивать ключи не надо, ключ одного сервиса на адресе другого получает отказ 401.

Как выпустить ключ в Relay

Ключ Relay за пять шагов

  1. Зарегистрируйтесь и войдите в кабинет

    Подтвердите адрес почты по письму со ссылкой. Если при создании ключа кабинет покажет сообщение о неподтверждённой почте, подтвердите адрес и повторите.

  2. Откройте раздел «API-ключи»

    Дайте ключу имя от 1 до 64 знаков: prod, staging, название сервиса. По имени вы потом узнаете его в журнале.

  3. Задайте ограничения

    Лимиты, срок и список моделей можно оставить пустыми. Тогда ключ тратит общий баланс без потолка. Что лучше задать сразу, описано ниже.

  4. Скопируйте секрет

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

  5. Положите ключ в окружение

    Не в код и не в репозиторий: ключ живёт в переменной RELAY_API_KEY на машине, где запускается приложение.

bash
read -rs RELAY_API_KEY && export RELAY_API_KEY

В PowerShell то же самое делает $env:RELAY_API_KEY = Read-Host "API key".

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

Что задать в ключе до первого запроса

Я бы выпускал по одному ключу на пару «приложение и окружение». Причина практическая: утёкший ключ отзывается, не останавливая остальные сервисы, а журнал запросов фильтруется по ключу, и сразу видно, кто тратит.

Лимиты считаются в деньгах, а не в токенах. Их три: на весь срок, на день и на месяц. Запрос, который не помещается в лимит, получает key_limit_exceeded, и средства за него не списываются. Пополнение баланса лимит ключа не восстанавливает: нужно поднять его в настройках или дождаться нового дня или месяца.

Список разрешённых моделей нужен ключу, который уходит в CI или подрядчику. Запрос к модели вне списка получает model_not_allowed. Срок действия полезен для временных ключей: после даты ключ просто перестаёт приниматься, отзывать его вручную не придётся. Как устроены ключи в целом, показывает страница «Ключи и доступ».

Как проверить ключ без клиента

Один запрос показывает, принимает ли шлюз ключ и какие ограничения на нём стоят:

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

В ответе приходят is_active: true, имя и префикс ключа, блок limits с остатком, expires_at и allowed_models. Код 401 означает, что ключ не передан, отключён, удалён или набран с ошибкой.

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

Куда вставить ключ

КлиентКуда ключБазовый адрес
Anthropic SDKпараметр api_key или apiKeyhttps://relay-llm.ru
OpenAI SDKпараметр api_keyhttps://relay-llm.ru/v1
Claude CodeANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL=https://relay-llm.ru
Cursorполе OpenAI API KeyOverride OpenAI Base URL: https://relay-llm.ru/v1
Codex CLIпеременная из env_key, например RELAY_API_KEYbase_url с /v1 в config.toml

Relay принимает ключ в заголовке Authorization: Bearer и в x-api-key. SDK подставляют нужный заголовок сами, а вручную достаточно одного: два сразу без причины не отправляйте. Правила описаны в руководстве по авторизации.

Python-пример для Anthropic SDK. Идентификатор модели взят из каталога на 14 октября 2026, перед копированием сверьте его со страницей модели.

python
import os
from anthropic import Anthropic

client = Anthropic(base_url="https://relay-llm.ru", api_key=os.environ["RELAY_API_KEY"])
reply = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=256,
    messages=[{"role": "user", "content": "Ответь одним словом: готово"}],
)
print(reply.content[0].text)

Каталог моделей

Общую схему запроса показывает быстрый старт. Для Claude Code, Cursor и Codex CLI у Relay есть отдельные страницы интеграций с готовыми конфигами.

Ключ утёк или не принимается

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

Можно ли использовать ключ Anthropic с адресом Relay?

Нет. Каждый сервис проверяет только свои ключи. Ключ консоли на адресе Relay получит 401, и наоборот. Ключ и базовый адрес меняются вместе, по одному их менять нельзя.

Сколько ключей можно создать?

В кабинете Relay до 50 ключей на аккаунт. Когда лимит исчерпан, лишний ключ придётся отозвать, прежде чем создавать новый.

Что делать, если я не сохранил секрет?

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

Нужен ли отдельный ключ для Claude Code и для Cursor?

Технически один ключ подойдёт обоим. Отдельные ключи удобнее: в журнале сразу видно, какой клиент сколько потратил, а потерянный ноутбук отзывается одним ключом.

Источники

Условия консоли Anthropic проверены по странице Get your Claude API key на 14 октября 2026. Сведения о ключах Relay взяты из кабинета и документации Relay.

Создать аккаунт и ключ

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.