Как подключить 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-модели из каталога.
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
- Создайте ключ
Откройте раздел ключей, создайте ключ для рабочего окружения и сохраните его там, где он не попадёт в git.
- Выберите модель
Откройте каталог, найдите модель Claude и скопируйте её идентификатор без изменений.
- Задайте адрес и модель
Укажите
https://relay-llm.ruвANTHROPIC_BASE_URL, без/v1, затем задайте идентификатор модели во всех переменных Claude Code. - Проверьте запрос
Запустите
claude -pс коротким вопросом. После ответа откройте журнал запросов и проверьте модель и статус вызова.
Постоянная настройка
Если вы запускаете Claude Code часто, добавьте блок env в пользовательский settings.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.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 found | PATH не обновился после установки | откройте новое окно терминала; на macOS и Linux файл лежит в ~/.local/bin/claude |
401 с кодом invalid_api_key | ключ не передан, отключён, удалён или набран с ошибкой | запрос GET /v1/key с тем же ключом покажет, принимает ли его шлюз |
| Запросы идут со старым ключом | значение в блоке env файла настроек сильнее переменной оболочки | найдите ключ в ~/.claude/settings.json и обновите там |
В /status нет строки Anthropic base URL | ANTHROPIC_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.