Claude в России: как подключить модель через API Relay
Claude в России можно подключить к приложению через API Relay: зарегистрироваться, создать ключ Relay и отправить запрос к модели Claude. Этот способ даёт программный доступ, а не подписку на сайт Claude и не аккаунт Anthropic. Для Anthropic SDK используйте базовый адрес https://relay-llm.ru без /v1. Если вам нужен именно веб-чат Claude AI в России, ключ Relay не предоставит вход в него.
Коротко
Создайте ключ и проверьте баланс Relay до подключения клиента.
Для Anthropic SDK нужен адрес без
/v1, для прямого curl полный путь/v1/messages.Оплачиваются запросы Relay; чужая подписка этим не пополняется.
Как пользоваться Claude в России через Relay
Сначала определите, где должна работать модель. Для своего сервера подойдёт SDK или прямой HTTP-запрос. Для работы с кодом проверьте инструкцию Claude Code. Приложение должно позволять настроить адрес API и подходящий протокол. Ключ Relay не заменяет логин в клиенте, который принимает только вход в чужой аккаунт.
Порядок подключения такой:
Зарегистрируйтесь в Relay и подтвердите почту, чтобы создавать ключи.
Откройте каталог Claude и выберите модель. Скопируйте её точный идентификатор.
Создайте ключ для своего приложения в разделе «API-ключи». Сохраните секрет при создании.
Проверьте доступный баланс и условия пополнения в кабинете и на странице цен.
Задайте ключ и базовый адрес в клиенте. Отправьте короткий запрос без дополнительных инструментов.
Сверьте модель, ключ и стоимость в истории запросов Relay.
Relay не создаёт аккаунты Anthropic, не продаёт подписку на Claude и не пополняет чужой баланс. Не переносите сюда инструкции по оплате Claude Pro: это другой продукт. Способы и условия пополнения Relay проверяйте перед платежом на его страницах, без предположений о валюте или платёжном методе.
Как отправить запрос через Anthropic SDK
Пример рассчитан на Python с установленным пакетом anthropic. Модель claude-opus-4-6 есть в каталоге Relay и поддерживает Anthropic Messages. В этом протоколе предел ответа max_tokens обязателен; здесь он задан для короткой проверки.
from anthropic import Anthropic
client = Anthropic(
api_key="sk-demo-not-a-real-key",
base_url="https://relay-llm.ru",
max_retries=0,
)
message = client.messages.create(
model="claude-opus-4-6",
max_tokens=300,
messages=[{"role": "user", "content": "Объясни HTTP одним предложением."}],
)
for block in message.content:
if block.type == "text":
print(block.text)
print(message.usage)Демонстрационный ключ не авторизует запрос. В приложении импортируйте os, передайте api_key=os.environ["RELAY_API_KEY"] и задайте секрет в окружении серверного процесса. Сохраните пример в claude_check.py и запустите python3 claude_check.py.
SDK сам добавляет /v1/messages. Если включить /v1 в base_url, путь может получиться неверным. Правило относится к Anthropic SDK: OpenAI SDK, напротив, настраивают с /v1. Подробнее об адресах и форматах читайте в документации Messages.
Как проверить подключение без SDK
Прямой HTTP-вызов помогает отделить ошибку клиента от ошибки адреса или ключа. Для него указывают полный маршрут и обязательные заголовки. Не вставляйте базовый адрес SDK вместо полного URL запроса.
curl -i "https://relay-llm.ru/v1/messages" \
-H "x-api-key: $RELAY_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 300,
"messages": [{"role": "user", "content": "Ответь одним предложением."}]
}'Для рабочего вызова передайте свой ключ через окружение. Сохраните заголовок x-request-id ответа. Если прямой запрос работает, а клиент нет, сравните адрес, выбранную модель и окружение клиента. Не добавляйте новые параметры до устранения расхождения.
Что делать при отказе или неожиданном расходе
При 401 проверьте секрет и состояние ключа. При 404 проверьте путь и идентификатор модели. При 503 model_unavailable возможна недоступность модели или выбранного протокола. В формате ошибок Anthropic ориентируйтесь на HTTP-статус, error.type и x-request-id: поля error.code там нет.
Для 402 различайте нехватку доступного баланса и исчерпанный лимит ключа. Пополнение не восстанавливает его дневной или месячный лимит. Для повторов проверяйте x-should-retry и выдерживайте Retry-After, когда заголовок присутствует. Разбор есть в справочнике ошибок.
Все ключи аккаунта расходуют общий баланс. Задайте отдельному ключу приложения лимит и список разрешённых моделей. Итоговую стоимость смотрите в записи запроса: поля токенов помогают объяснить расход, но не заменяют сумму списания. При утечке отзовите раскрытый секрет и обновите настройки клиента.
Claude в России через Relay работает как сайт Claude?
Это доступ по API для приложения или совместимого клиента. Вход в сайт и подписка Claude остаются отдельными услугами.
Нужно ли оплачивать Claude Pro для этих запросов?
Показанный сценарий использует ключ и баланс Relay. Подписка Claude Pro не служит оплатой запросов Relay.
Почему адрес в curl содержит /v1, а в Python нет?
В curl записан полный путь. Anthropic SDK добавляет /v1/messages к своему базовому адресу автоматически.
Можно ли подставить этот ключ в Claude Code?
Используйте руководство интеграции Relay и сверьте настройки с документацией своей версии клиента. Поле входа в аккаунт не заменяет настройку API.