Claude Code на Windows: установка нативно или в WSL и настройка Zukko

Claude Code на Windows ставится одной командой, но новички часто путаются: какой терминал открыть, нужен ли WSL, куда прописать ключ. Ниже — официальные способы установки (сверено со страницей Advanced setup в документации Claude Code), выбор между нативным режимом и WSL и настройка переменных окружения для работы через Zukko.

Требования

• Windows 10 версии 1809 и новее или Windows Server 2019 и новее;
• 4 ГБ оперативной памяти и больше, процессор x64 или ARM64;
• оболочка: PowerShell или CMD (в WSL — Bash или Zsh).

Права администратора для установки не нужны.

Установка Claude Code на Windows

Официальный установщик (рекомендуемый способ). В PowerShell:

irm https://claude.ai/install.ps1 | iex

В CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Через WinGet:

winget install Anthropic.ClaudeCode

Через npm (ставит тот же нативный бинарник):

npm install -g @anthropic-ai/claude-code

После установки откройте новое окно терминала и проверьте:

claude --version
claude doctor

claude doctor выводит диагностику установки и настроек, не запуская сессию. Версия, поставленная официальным установщиком, обновляется сама в фоне. Версию из WinGet обновляйте командой winget upgrade Anthropic.ClaudeCode.

MSI-пакета и пакета Chocolatey в официальной документации нет. Ставьте одним из способов выше.

Git Bash или PowerShell

На нативной Windows рекомендуется поставить Git for Windows↗. Тогда Claude Code выполняет команды через Git Bash (инструмент Bash). Без Git for Windows команды идут через инструмент PowerShell. Если Git установлен, но Claude Code не находит Git Bash, укажите путь в %USERPROFILE%\.claude\settings.json:

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

Нативная Windows или WSL

Для WSL откройте терминал дистрибутива и выполните установщик для Linux:

curl -fsSL https://claude.ai/install.sh | bash

В WSL claude устанавливается и запускается внутри Linux-терминала, а не из PowerShell. Переменные окружения Windows и WSL — это разные окружения: ключ нужно прописать там, где вы запускаете claude.

Подключение к Zukko: переменные окружения

Claude Code работает через Zukko при трёх переменных:

• ANTHROPIC_BASE_URL=https://api.zukko.pro — без /v1, Claude Code добавляет его сам;
• ANTHROPIC_AUTH_TOKEN=fetch_... — ваш ключ. Он отправляется как Authorization: Bearer;
• ANTHROPIC_MODEL=claude-sonnet-5 — модель по умолчанию.

Ключ создаётся в кабинете Zukko↗. Полный ключ показывается один раз, сохраните его сразу.

Только для текущего окна PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.zukko.pro"
$env:ANTHROPIC_AUTH_TOKEN = "fetch_ваш_ключ"
$env:ANTHROPIC_MODEL = "claude-sonnet-5"
claude

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

Постоянно для пользователя: setx

setx ANTHROPIC_BASE_URL "https://api.zukko.pro"
setx ANTHROPIC_AUTH_TOKEN "fetch_ваш_ключ"
setx ANTHROPIC_MODEL "claude-sonnet-5"

setx сохраняет переменные для пользователя, но текущее окно их не увидит. Откройте новый терминал. То же самое делается через графический интерфейс: в поиске Windows найдите редактор переменных среды и добавьте три переменные в раздел пользователя.

В файле настроек Claude Code

Вместо системных переменных можно использовать блок env в %USERPROFILE%\.claude\settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

Так настройка действует только для Claude Code и не видна другим программам. Не кладите ключ в .claude/settings.json проекта, который коммитится в git. Файл .env в папке проекта Claude Code сам не читает.

Проверить, что переменные видны в PowerShell:

$env:ANTHROPIC_BASE_URL
$env:ANTHROPIC_MODEL

Пошаговая инструкция с проверкой подключения — в документации Zukko по Claude Code↗. Актуальный список моделей — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете. На одной сессии модель можно сменить флагом: claude --model claude-opus-5-5.

Сколько стоит

В Zukko claude-sonnet-5 и claude-opus-5-5 стоят $0.3 за 1M входных и $0.3 за 1M выходных токенов. Пример: сессия отправила 2 000 000 входных токенов и получила 100 000 выходных. Стоимость: 2 × $0.3 + 0.1 × $0.3 = $0.63. Агенты много раз пересылают один и тот же контекст. У вендора чтение из кэша промптов стоит около 10% входной цены, а в Zukko кэшированные токены оплачиваются по обычной входной цене. Поэтому для длинных сессий реальная разница с официальным прайсом меньше, чем при прямом сравнении цен. Оплата из России доступна: СБП, карта РФ, криптовалюта.

Частые проблемы

«claude» не распознаётся как команда

Каталог установки ещё не попал в PATH текущего окна. Откройте новый терминал. Если не помогло — в документации Claude Code есть раздел Troubleshoot installation с инструкцией по PATH.

Ошибка 'irm' is not recognized или The token '&&' is not a valid statement separator

Первая значит, что вы в CMD, а запускаете команду для PowerShell. Вторая — наоборот. В PowerShell приглашение начинается с PS C:\.

Переменные не применились

После setx нужно новое окно терминала. Проверьте, не задана ли переменная с тем же именем в блоке env файла настроек. И помните: переменные Windows не видны внутри WSL.

Ошибка 401 или 402

401 — неверный ключ: проверьте ANTHROPIC_AUTH_TOKEN без лишних пробелов и кавычек. 402 — на балансе не хватает средств, пополните его в кабинете.

Частые вопросы

Где лежат настройки Claude Code на Windows?

В %USERPROFILE%\.claude\, в том числе settings.json. Это аналог ~/.claude на macOS и Linux.

Нужен ли WSL обязательно?

Нет. Claude Code работает нативно. WSL 2 стоит выбрать, если у вас Linux-тулчейн или нужна песочница для команд.

Можно ли запускать Claude Code из терминала VS Code?

Да, это обычный терминал. Переменные окружения должны быть видны в нём. После setx перезапустите VS Code.

Как обновить Claude Code?

Версия из официального установщика обновляется автоматически. Вручную — claude update. Для WinGet — winget upgrade Anthropic.ClaudeCode.