Как получить 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 | раздел ключей |
| Адрес API | https://api.anthropic.com | https://relay-llm.ru |
| Кто списывает деньги | Anthropic | баланс аккаунта Relay, один на все ключи |
| Модели | семейство Claude | весь каталог Relay, Claude среди прочих |
| Защита при создании | тип ключа, срок действия, рабочее пространство | имя, лимиты на день, месяц и весь срок, срок действия, список моделей |
В консоли Anthropic при создании выбирают тип ключа. Личный ключ действует от вашего имени и перестаёт работать, когда вы уходите из организации. Ключ сервисного аккаунта подходит для CI и продакшена. По странице Anthropic на 14 октября 2026 личный ключ рекомендован для собственной разработки, а для всего общего лучше сервисный аккаунт.
Выбирать между консолью и Relay стоит по тому, где у вас уже есть аккаунт и баланс. Нужны модели нескольких вендоров на одном ключе: подойдёт Relay. Вся работа идёт у Anthropic напрямую: хватит консоли. Смешивать ключи не надо, ключ одного сервиса на адресе другого получает отказ 401.
Как выпустить ключ в Relay
Ключ Relay за пять шагов
- Зарегистрируйтесь и войдите в кабинет
Подтвердите адрес почты по письму со ссылкой. Если при создании ключа кабинет покажет сообщение о неподтверждённой почте, подтвердите адрес и повторите.
- Откройте раздел «API-ключи»
Дайте ключу имя от 1 до 64 знаков:
prod,staging, название сервиса. По имени вы потом узнаете его в журнале. - Задайте ограничения
Лимиты, срок и список моделей можно оставить пустыми. Тогда ключ тратит общий баланс без потолка. Что лучше задать сразу, описано ниже.
- Скопируйте секрет
Полный ключ показывается один раз. Закроете окно, не сохранив его, придётся перевыпускать ключ.
- Положите ключ в окружение
Не в код и не в репозиторий: ключ живёт в переменной
RELAY_API_KEYна машине, где запускается приложение.
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. Срок действия полезен для временных ключей: после даты ключ просто перестаёт приниматься, отзывать его вручную не придётся. Как устроены ключи в целом, показывает страница «Ключи и доступ».
Как проверить ключ без клиента
Один запрос показывает, принимает ли шлюз ключ и какие ограничения на нём стоят:
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 или apiKey | https://relay-llm.ru |
| OpenAI SDK | параметр api_key | https://relay-llm.ru/v1 |
| Claude Code | ANTHROPIC_AUTH_TOKEN | ANTHROPIC_BASE_URL=https://relay-llm.ru |
| Cursor | поле OpenAI API Key | Override OpenAI Base URL: https://relay-llm.ru/v1 |
| Codex CLI | переменная из env_key, например RELAY_API_KEY | base_url с /v1 в config.toml |
Relay принимает ключ в заголовке Authorization: Bearer и в x-api-key. SDK подставляют нужный заголовок сами, а вручную достаточно одного: два сразу без причины не отправляйте. Правила описаны в руководстве по авторизации.
Python-пример для Anthropic SDK. Идентификатор модели взят из каталога на 14 октября 2026, перед копированием сверьте его со страницей модели.
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.