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

Claude в России: как подключить модель через API Relay

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 не заменяет логин в клиенте, который принимает только вход в чужой аккаунт.

Порядок подключения такой:

  1. Зарегистрируйтесь в Relay и подтвердите почту, чтобы создавать ключи.

  2. Откройте каталог Claude и выберите модель. Скопируйте её точный идентификатор.

  3. Создайте ключ для своего приложения в разделе «API-ключи». Сохраните секрет при создании.

  4. Проверьте доступный баланс и условия пополнения в кабинете и на странице цен.

  5. Задайте ключ и базовый адрес в клиенте. Отправьте короткий запрос без дополнительных инструментов.

  6. Сверьте модель, ключ и стоимость в истории запросов Relay.

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

Как отправить запрос через Anthropic SDK

Пример рассчитан на Python с установленным пакетом anthropic. Модель claude-opus-4-6 есть в каталоге Relay и поддерживает Anthropic Messages. В этом протоколе предел ответа max_tokens обязателен; здесь он задан для короткой проверки.

python
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 запроса.

bash
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.

Создать аккаунт

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