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

Claude Code на Windows: настройка API Relay

Claude Code на Windows: настройка API Relay

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

Коротко

  • Откройте новый PowerShell после добавления постоянных переменных.

  • Передавайте ключ в ANTHROPIC_AUTH_TOKEN.

  • Для первой проверки используйте короткий запуск claude -p.

Настройка в PowerShell

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

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

Claude Code сам добавляет /v1/messages, поэтому ANTHROPIC_BASE_URL с /v1 даст неверный путь. Для OpenAI-совместимых клиентов правило другое: им нужен адрес https://relay-llm.ru/v1.

Настройка в settings.json

Когда пробный запуск дал ответ, перенесите адрес и модель в пользовательский файл %USERPROFILE%\.claude\settings.json. Этот путь относится к профилю Windows, а не к папке проекта. Ключ в репозиторий и .claude/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 из PowerShell с переменной окружения.

Проверка Claude Code на Windows

  1. Откройте новый терминал

    Если вы меняли переменные через настройки Windows или setx, закройте старый терминал и откройте новый. Старое окно не увидит новое значение.

  2. Проверьте команду

    Выполните claude --version. Если Windows не находит команду, сначала завершите установку Claude Code.

  3. Отправьте короткий запрос

    Выполните claude -p "Ответь одним словом: готово". Не начинайте с задачи, которая редактирует файлы.

  4. Посмотрите журнал

    Откройте журнал запросов. Успешная запись подтверждает адрес, ключ и выбранную модель.

Нативный Windows или WSL

Claude Code работает на Windows двумя способами, и от выбора зависит, какие функции доступны. Данные ниже сверены со страницей Advanced setup в документации Anthropic на 14 октября 2026.

ВариантЧто требуетсяПесочница для командКогда выбирать
Нативный Windowsничего, Git for Windows необязателенне поддерживаетсяпроекты и инструменты Windows
WSL 2включённый WSL 2поддерживаетсяинструменты Linux или нужна песочница
WSL 1включённый WSL 1не поддерживаетсятолько если WSL 2 недоступен

Если ваш проект живёт на Windows и использует её инструменты, начинайте с нативной установки. WSL 2 берут, когда сборка рассчитана на Linux или нужна песочница. В WSL свой домашний каталог, поэтому переменные Relay и ~/.claude/settings.json придётся настроить заново внутри дистрибутива: настройки из Windows туда не переходят. Установщик Linux запускают в терминале дистрибутива, а не в PowerShell.

Без Git for Windows Claude Code выполняет команды через инструмент PowerShell. С Git for Windows появляется Bash. Если Claude Code не находит Git Bash, укажите путь в settings.json:

json
{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

MCP-серверы на Windows

MCP-серверы подключает сам Claude Code, адрес модели на них не влияет. Синтаксис добавления локального сервера такой:

powershell
claude mcp add --transport stdio имя -- команда аргументы

Двойной дефис отделяет параметры самого Claude Code от команды сервера. По умолчанию сервер доступен только в текущем проекте и записывается в %USERPROFILE%\.claude.json. Параметр --scope project кладёт его в .mcp.json репозитория для всей команды, и такие серверы в интерактивной сессии требуют одобрения. Список серверов с состоянием показывает claude mcp list: рядом с каждым стоит Connected или Failed to connect. Если сервер не поднимается, запустите его команду вручную в том же окне PowerShell и посмотрите ошибку.

Что ломает подключение

Не используйте ANTHROPIC_API_KEY вместо ANTHROPIC_AUTH_TOKEN. Claude Code может запросить подтверждение такого ключа, а после отказа перестать его учитывать. Не указывайте модель без Anthropic Messages: совместимость определяется протоколом, а не названием модели.

Ещё одна причина путаницы: приложение, запущенное через меню «Пуск», не всегда наследует переменные текущего PowerShell. Для расширения VS Code задайте их в настройке claudeCode.environmentVariables; для терминала проще начать с команды из этой статьи.

Полные ограничения и конфиг для macOS и Linux собраны на странице Claude Code. Если запрос не доходит до Relay, пройдите проверки из статьи про диагностику подключения Claude Code. Формат запросов описан в документации Messages API.

Ошибки установки и запуска на Windows

СообщениеПричинаЧто сделать
Claude Code on Windows requires either Git for Windows (for bash) or PowerShellне найдены ни Git Bash, ни PowerShellдобавьте C:\Windows\System32\WindowsPowerShell\v1.0\ в PATH или поставьте Git for Windows
Claude Code does not support 32-bit Windowsвы открыли Windows PowerShell (x86)запустите Windows PowerShell без x86, разрядность ОС покажет [Environment]::Is64BitOperatingSystem
The process cannot access the file ... because it is being used by another processустановщик не может писать в %USERPROFILE%\.claude\downloadsзакройте другие окна установщика, дождитесь антивируса, удалите папку downloads и повторите
'claude' is not recognized сразу после обновленияна месте claude.exe пустонайдите в %USERPROFILE%\.local\bin файл claude.exe.old.*, переименуйте в claude.exe или переустановите
running scripts is disabled on this systemполитика выполнения блокирует .ps1-оболочки npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или установка нативным установщиком

Обновление и удаление

Нативная установка обновляется в фоне. Принудительное обновление запускает claude update, для WinGet это winget upgrade Anthropic.ClaudeCode. Чтобы удалить нативную установку, выполните в PowerShell:

powershell
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Для WinGet команда winget uninstall Anthropic.ClaudeCode. Переменные Relay программа не удаляет. Уберите их отдельно, например [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", $null, "User"), и не забудьте про блок env в %USERPROFILE%\.claude\settings.json: там тоже лежит ключ. Сама папка .claude хранит настройки и историю, удаляйте её только осознанно.

Где взять точный идентификатор модели?

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

Почему после setx Claude Code не видит ключ?

setx меняет переменную для новых процессов. Закройте PowerShell и откройте новое окно, затем повторите команду.

Можно ли использовать одну модель для субагентов?

Да. Укажите один идентификатор в CLAUDE_CODE_SUBAGENT_MODEL и остальных переменных, затем меняйте схему только после проверки.

Источники

Требования, команды обновления и удаления сверены со страницей Advanced setup, сообщения об ошибках с разделом Troubleshoot installation and login, синтаксис MCP со страницей MCP документации Claude Code. Проверено на 14 октября 2026.

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