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 через безопасное хранилище вашей рабочей среды, а не в файле проекта.
$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 проекта не кладите.
{
"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
- Откройте новый терминал
Если вы меняли переменные через настройки Windows или
setx, закройте старый терминал и откройте новый. Старое окно не увидит новое значение. - Проверьте команду
Выполните
claude --version. Если Windows не находит команду, сначала завершите установку Claude Code. - Отправьте короткий запрос
Выполните
claude -p "Ответь одним словом: готово". Не начинайте с задачи, которая редактирует файлы. - Посмотрите журнал
Откройте журнал запросов. Успешная запись подтверждает адрес, ключ и выбранную модель.
Нативный 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:
{
"env": {
"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
}
}MCP-серверы на Windows
MCP-серверы подключает сам Claude Code, адрес модели на них не влияет. Синтаксис добавления локального сервера такой:
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-оболочки npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или установка нативным установщиком |
Обновление и удаление
Нативная установка обновляется в фоне. Принудительное обновление запускает claude update, для WinGet это winget upgrade Anthropic.ClaudeCode. Чтобы удалить нативную установку, выполните в 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.