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

Как подключить Claude Code к API через Relay

Как подключить Claude Code к API через Relay

Claude Code подключается к Relay по протоколу Anthropic Messages. Для него нужен адрес https://relay-llm.ru без /v1, API-ключ и точный идентификатор модели Claude из каталога.

Коротко

  • Для Claude Code используйте ANTHROPIC_BASE_URL=https://relay-llm.ru.

  • Ключ передавайте через ANTHROPIC_AUTH_TOKEN, а не через ANTHROPIC_API_KEY.

  • Идентификатор модели должен существовать в каталоге и поддерживать Anthropic Messages.

Что подготовить

Создайте отдельный ключ в кабинете. Не добавляйте ключ в репозиторий, .claude/settings.json проекта или код браузерного приложения. Для постоянной настройки Claude Code использует пользовательский файл ~/.claude/settings.json на macOS и Linux либо %USERPROFILE%\.claude\settings.json в Windows.

Откройте страницу интеграции Claude Code. Там Relay показывает актуальную форму настройки и свойства модели. Если модель не принимает Anthropic Messages, Claude Code получит ошибку маршрута. Для таких моделей нужен клиент с OpenAI-совместимым протоколом.

Запуск Claude Code на один сеанс

Сначала положите свой ключ в RELAY_API_KEY способом, подходящим для вашей оболочки. Затем выполните команду ниже, заменив MODEL_ID точным идентификатором Claude-модели из каталога.

bash
export ANTHROPIC_BASE_URL="https://relay-llm.ru"
export ANTHROPIC_AUTH_TOKEN="$RELAY_API_KEY"
export ANTHROPIC_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_OPUS_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_SONNET_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="MODEL_ID"
export ANTHROPIC_DEFAULT_FABLE_MODEL="MODEL_ID"
export CLAUDE_CODE_SUBAGENT_MODEL="MODEL_ID"
claude -p "Ответь одним словом: готово"

Не пропускайте ANTHROPIC_DEFAULT_HAIKU_MODEL. Claude Code использует его для фоновых задач, и отсутствующий идентификатор даст 404 уже после успешного запуска чата.

Первый запуск Claude Code через Relay

  1. Создайте ключ

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

  2. Выберите модель

    Откройте каталог, найдите модель Claude и скопируйте её идентификатор без изменений.

  3. Задайте адрес и модель

    Укажите https://relay-llm.ru в ANTHROPIC_BASE_URL, без /v1, затем задайте идентификатор модели во всех переменных Claude Code.

  4. Проверьте запрос

    Запустите claude -p с коротким вопросом. После ответа откройте журнал запросов и проверьте модель и статус вызова.

Постоянная настройка

Если вы запускаете Claude Code часто, добавьте блок env в пользовательский settings.json. Значения в нём сильнее переменных из оболочки. При смене ключа обновите оба места или удалите старое значение из файла.

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay-llm.ru",
    "ANTHROPIC_AUTH_TOKEN": "RELAY_API_KEY",
    "ANTHROPIC_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MODEL_ID",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "MODEL_ID",
    "CLAUDE_CODE_SUBAGENT_MODEL": "MODEL_ID"
  }
}

Вместо строки RELAY_API_KEY в JSON нужен ваш секрет. Не коммитьте этот файл и не отправляйте его целиком в поддержку. Если ключ должен жить вне настроек, оставьте его в переменной окружения и применяйте схему одноразового запуска выше.

Модель для Claude Code: с чего начать

Агент делает много вызовов за сессию, поэтому модель определяет и качество правок, и расход. Я начинал бы с модели класса Sonnet на каждый день и переходил на Opus только для длинных рефакторингов, где первая теряет нить. Вернуться обратно можно командой /model, ничего пересобирать не нужно.

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

Claude Opus 5.50,86 $ за 1 млн входных токенов

Цена и статус берутся из каталога в момент показа карточки. Подробнее о выборе: как выбрать модель для задач по коду и вызов Claude Opus 5.5. В текущем каталоге есть claude-haiku-5.5; для ANTHROPIC_DEFAULT_HAIKU_MODEL укажите его или тот же точный ID Claude, что и в остальных переменных.

Что хранить в проекте, а что в пользовательском файле

Адрес, ключ и модели лежат в пользовательском ~/.claude/settings.json: он читается до первого запуска. Файл проекта .claude/settings.json попадает в git и виден всей команде, поэтому в нём остаются общие правила, например разрешения и запреты для инструментов. Личные переопределения для одного проекта кладут в .claude/settings.local.json. Claude Code вносит его в глобальный gitignore, когда сам сохраняет туда настройку, но созданный руками файл добавьте в gitignore сами, прежде чем писать в него секрет. Ключ в файл проекта не кладут ни при каких условиях.

Частые ошибки

ANTHROPIC_BASE_URL не содержит /v1. Путь /v1/messages клиент добавляет сам. Обратная ошибка тоже встречается: модели GPT не становятся Anthropic-моделями из-за смены URL. Сверяйте протокол на странице модели и в описании Messages API.

Если Claude Code открывает экран входа вместо запроса, проверьте путь к пользовательскому settings.json и наличие ANTHROPIC_AUTH_TOKEN. Если команда отработала, а ответа нет, посмотрите код ошибки в документации API и запись в журнале кабинета.

Симптомы и проверки

СимптомВероятная причинаЧто проверить
claude: command not foundPATH не обновился после установкиоткройте новое окно терминала; на macOS и Linux файл лежит в ~/.local/bin/claude
401 с кодом invalid_api_keyключ не передан, отключён, удалён или набран с ошибкойзапрос GET /v1/key с тем же ключом покажет, принимает ли его шлюз
Запросы идут со старым ключомзначение в блоке env файла настроек сильнее переменной оболочкинайдите ключ в ~/.claude/settings.json и обновите там
В /status нет строки Anthropic base URLANTHROPIC_BASE_URL не дошла до процессаперезапустите терминал или редактор, в VS Code задайте claudeCode.environmentVariables
429 с кодом rate_limitedпревышен лимит запросов в минуту для ключа или аккаунтаподождите Retry-After секунд и снизьте число параллельных сессий

Где смотреть расход

Каждый запрос Claude Code попадает в журнал запросов: модель, токены входа, кэша и выхода, цена и маршрут. Карточка ключа в кабинете показывает остаток лимита и число запросов за 30 дней. Команда /usage внутри Claude Code даёт лишь оценку на стороне клиента, и по документации Anthropic она может расходиться со счётом. Чтобы расход не вышел за границу, задайте на ключе лимит на день или месяц. Запрос сверх лимита получит key_limit_exceeded, а средства за него не спишутся.

Нужен ли /v1 в адресе Claude Code?

Нет. Для Claude Code задайте https://relay-llm.ru. Путь /v1 нужен клиентам OpenAI-совместимого протокола.

Можно ли указать одну модель для всех переменных?

Да. Это надёжный стартовый вариант, пока вы не выбрали отдельные модели для обычной и фоновой работы.

Где проверить, дошёл ли запрос?

После запуска откройте журнал запросов. Там видны статус, модель и сведения о вызове.

Источники

Правила файлов настроек и проверка подключения к шлюзу описаны на странице Connect Claude Code to an LLM gateway, оценка расходов на стороне клиента на странице Run Claude Code programmatically. Сведения проверены на 14 октября 2026.

Модели из статьи

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