Claude Code на Windows 2026: нативно, WSL и PowerShell

Claude Code на Windows 2026: нативно, WSL2 и как побороть типичные ошибки

Claude Code на Windows стал реальностью с конца 2025 года. Раньше без WSL было не обойтись — теперь терминальный AI-агент от Anthropic работает напрямую через PowerShell и CMD. Но нюансов хватает: Git Bash обязателен, PATH обновляется не сразу, а ошибка «claude code on windows requires git bash» стала главным камнем преткновения у тысяч разработчиков.

В этом гайде — три рабочих способа установки, разбор ошибок с конкретными командами и честное сравнение: когда брать нативную версию, а когда WSL2 всё же лучше.

Что нужно до установки

Два обязательных условия. Без них ничего не заработает, поэтому начни именно отсюда.

Git for Windows — обязательное требование. Claude Code использует Git Bash внутренне для выполнения команд, даже если ты запускаешь его из PowerShell или CMD. Скачай с git-scm.com, установи с дефолтными настройками. Ключевой момент при установке — галочка «Add Git to PATH» должна стоять (она стоит по умолчанию, не убирай).

Платная подписка Claude — бесплатного плана недостаточно. Нужен один из вариантов:

• Claude Pro — $20/мес, включает Claude Code
• Claude Max — $100–200/мес, выше лимиты
• API-ключ с console.anthropic.com — оплата по токенам

Если живёшь в России, понадобится VPN при первом входе: авторизация через claude.ai блокируется с российских IP. После авторизации токен сохраняется локально в ~\.claude\session.json и при каждом запуске браузер открывать не нужно.

Способ 1: нативный установщик через PowerShell

Это официально рекомендованный метод. Работает на Windows 10 и Windows 11.

Открой PowerShell (не обязательно от администратора) и выполни:

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

Если видишь ошибку про политику выполнения скриптов:

Set-ExecutionPolicy RemoteSigned

После этого повтори команду установки.

Установщик кладёт бинарник в ~\.local\bin. Это стандартная папка пользователя, права администратора не нужны.

Важно: закрой терминал и открой новый. В текущем окне claude не сработает — PATH обновляется только в новой сессии.

Проверь установку:

claude --version

Если всё хорошо, увидишь номер версии. Можно запускать.

Самая частая ошибка — claude не распознается как команда

claude : The term 'claude' is not recognized as the name of a cmdlet, function, script file, or operable program.

Это не проблема установки. Это проблема PATH. Нативный установщик кладёт claude.exe в %USERPROFILE%\.local\bin, но эта папка не всегда прописана в системных переменных.

Быстрое решение через PowerShell:

[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", [EnvironmentVariableTarget]::User)

Или вручную:

1. Win + R → вводи sysdm.cpl → Enter
2. Вкладка «Дополнительно» → «Переменные среды»
3. В блоке «Переменные пользователя» найди Path → «Изменить»
4. «Создать» → вставь %USERPROFILE%\.local\bin
5. ОК везде → перезапусти терминал

После этого claude --version должен ответить нормально.

Ошибка «claude code on windows requires git bash»

Эта ошибка означает одно: Git for Windows не установлен или установлен, но не добавлен в PATH.

Claude Code на Windows использует Git Bash как внутренний shell для выполнения команд. Без него агент физически не может работать — не запустит скрипты, не выполнит команды терминала.

Решение:

1. Скачай Git for Windows с git-scm.com
2. При установке убедись, что выбрано «Add Git to PATH» (выбрано по умолчанию)
3. Перезапусти терминал

Если Git уже установлен, но ошибка остаётся — пропиши путь к bash вручную через настройки Claude Code. Создай или отредактируй файл %USERPROFILE%\.claude\settings.json:

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

Путь может отличаться. Проверь, где реально лежит bash.exe в твоей установке Git.

Способ 2: WinGet

WinGet встроен в Windows 11 и Windows 10 начиная с версии 22H2. Один из самых надёжных способов по отзывам пользователей — показывает прогресс установки и чётко сообщает об успехе.

winget install Anthropic.ClaudeCode

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

claude --version

Нюанс: WinGet не обновляет Claude Code автоматически. Нужно время от времени запускать:

winget upgrade Anthropic.ClaudeCode

Иногда новая версия появляется в репозитории WinGet с задержкой в несколько часов после релиза. Если upgrade ничего не находит — подожди и попробуй снова.

Максим: «Мы тестировали WinGet при запуске NanaBanana на Windows-машинах команды. Из трёх способов установки — нативный установщик, WinGet и WSL — WinGet дал наименьшее количество проблем у людей без опыта в терминале. Прогресс-бар видно, ошибка если есть — понятная. Для первого раза рекомендую именно его.»

Сравнение методов установки

npm-метод официально устарел. Anthropic рекомендует мигрировать на нативный установщик. Настройки из ~\.claude\ при миграции сохраняются.

Способ 3: WSL2 + Ubuntu

Для большинства Windows-разработчиков нативная установка закрывает все задачи. WSL2 стоит выбрать, если:

• твой проект требует Linux-окружения или Docker
• нужна изолированная песочница для выполнения команд (WSL2 поддерживает sandboxing, WSL1 — нет)
• ты уже работаешь в WSL и не хочешь два разных claude

Установка WSL2

Открой PowerShell от администратора:

wsl --install -d Ubuntu

Если Ubuntu после установки не запустился автоматически — найди его через поиск в Start Menu или запусти wsl из PowerShell.

Установка Node.js через NVM внутри Ubuntu

Claude Code в WSL устанавливается через npm и требует Node.js 20+. Самый надёжный способ поставить нужную версию — NVM:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20
node --version

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

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

Или через npm (если предпочитаешь):

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

Размещение проектов в WSL

Проекты лучше держать внутри WSL-файловой системы, а не на Windows-дисках. Доступ к Windows-файлам через /mnt/c/... работает, но медленнее:

# Оптимально: проект внутри WSL
mkdir -p ~/projects/my-app
cd ~/projects/my-app
claude

# Медленнее: проект на Windows-диске
cd /mnt/c/Users/username/projects/my-app
claude

Нативный vs WSL2: когда что выбирать

Нативная установка — дефолтный выбор для разработки на Windows. WSL2 берём под Linux-зависимые проекты или когда нужна изоляция.

Первый запуск и авторизация

После установки запусти:

claude

Откроется браузер для OAuth-авторизации через claude.ai. Войди с аккаунтом Claude Pro, Max, Teams или Enterprise. Токен сохранится — следующие запуски без браузера.

Если браузер не открывается автоматически (бывает в WSL) — авторизуйся через переменную окружения с API-ключом:

export ANTHROPIC_API_KEY=sk-ant-...
claude

Диагностика: claude doctor

Если что-то не работает, первым делом запускай:

claude doctor

Команда показывает:

• тип установки (нативный / WinGet / npm)
• текущую версию
• статус авторизации
• состояние Git
• проблемы с PATH

Большинство проблем диагностируется за 30 секунд. Выводы команды — самая точная отправная точка для решения.

Нюансы работы на Windows

Вставка изображений через буфер. В Windows нативный Ctrl+V вставляет только текст. Для изображений — Alt+V. Скриншот сделал Win+Shift+S, вставляешь в Claude Code через Alt+V. Или сохраняй файл и перетаскивай в окно терминала.

Переключение модели. По умолчанию Claude Code может запустить Opus. Для большего количества запросов переключись на Sonnet:

/model claude-sonnet-4-6

Соответственно, соотношение скорость/качество у Sonnet лучше для большинства задач кодинга.

Обновление нативной версии. Нативный установщик обновляется в фоне автоматически. Принудительно:

claude update

Два claude одновременно. Если установлен и нативный, и WSL-вариант, они не конфликтуют. В PowerShell проверь, какой активен: Get-Command claude. В WSL: which claude.

CLAUDE.md — проектные инструкции

Создай файл CLAUDE.md в корне проекта. Claude Code будет читать его при каждом запуске и учитывать твои правила:

# Мой проект

## Стиль кода
- TypeScript, ES Modules
- Комментарии на русском
- try/catch для всех async операций

## Запрещено
- console.log в production
- any-типы в TypeScript

## Команды
- `npm run dev` — запуск dev-сервера
- `npm run build` — production сборка

Это работает и в нативной версии, и в WSL. Один файл — постоянный контекст для агента.

Альтернатива без терминала: десктопное приложение

Anthropic выпустил десктопное приложение с Claude Code для Windows. Если терминал — не твоё, можно работать через GUI. Скачать на claude.ai. Функционально аналогично CLI-версии, но с графическим интерфейсом.

FAQ

Нужен ли Node.js для установки Claude Code на Windows?
Нет, начиная с нативного установщика (2025). Только для WSL-способа через npm Node.js 20+ обязателен. WinGet и PowerShell-установщик работают без него.

Почему нативный установщик завис и ничего не происходит?
Иногда irm https://claude.ai/install.ps1 | iex висит без прогресса. Попробуй WinGet как альтернативу: winget install Anthropic.ClaudeCode. Показывает прогресс, даёт понятные сообщения.

Можно ли использовать Claude Code бесплатно на Windows?
Нет. Бесплатный план Claude.ai не включает Claude Code. Нужен минимум Claude Pro ($20/мес).

Как использовать Claude Code с Ollama или локальными моделями?
После установки Claude Code можно подключить его к Ollama с облачными моделями через переменные окружения. Сначала выполни /login для привязки аккаунта, потом настрой Ollama отдельно через ANTHROPIC_BASE_URL. Ollama с суффиксом :cloud подключается к облачным моделям без локального скачивания.

WSL1 или WSL2 — какой выбирать?
WSL2. Поддерживает sandboxing для команд агента — более безопасная изоляция. WSL1 работает, но без этой защиты.

Claude Code видит файлы на Windows-дисках из WSL?
Да, через /mnt/c/.... Но производительность ниже, чем у проектов внутри WSL. Для основной работы лучше держать проекты в ~/projects/ внутри Ubuntu.

Как обновить Claude Code?
Нативная установка — автоматически в фоне, или claude update принудительно. WinGet — winget upgrade Anthropic.ClaudeCode. WSL/npm — npm update -g @anthropic-ai/claude-code.

Глоссарий

WSL (Windows Subsystem for Linux) — встроенная в Windows подсистема, которая запускает настоящее Linux-окружение прямо внутри Windows. WSL2 — более новая версия с полноценным Linux-ядром.

Git Bash — Unix-подобный терминал, который поставляется вместе с Git for Windows. Claude Code использует его внутри для выполнения команд на Windows.

PATH — системная переменная, которая содержит список папок, где Windows ищет исполняемые файлы. Если Claude Code не находится в PATH, команда claude не распознаётся как команда.

OAuth — стандартный протокол авторизации. Claude Code открывает браузер для безопасного входа через claude.ai без ввода пароля прямо в терминале.

NVM (Node Version Manager) — инструмент для управления версиями Node.js. В WSL позволяет установить нужную версию (20+) без конфликтов с системной.

claude doctor — встроенная команда диагностики. Проверяет установку, авторизацию, PATH и Git — выводит конкретные проблемы с подсказками.

WinGet — встроенный пакетный менеджер Windows (с версии 10 22H2 и Windows 11). Аналог apt/brew, но для Windows.

Sandboxing — изоляция выполнения команд. В WSL2 Claude Code может запускать команды в ограниченном окружении — снижает риск случайного изменения системных файлов.

Итог: какой способ выбрать

Если работаешь на Windows и хочешь запустить Claude Code прямо сейчас — начни с WinGet. Одна команда, прогресс виден, результат понятен. Если хочешь автообновлений — переходи на нативный установщик.

WSL2 берут осознанно: когда проект завязан на Linux-специфику или нужна дополнительная изоляция. Для большинства задач вайбкодинга нативная версия справляется на отлично.

Полный каталог AI-инструментов для вайбкодинга — в каталоге VibeCoderz. Там же обзоры Cursor, Windsurf, Aider и других инструментов, которые работают рядом с Claude Code.

Если нужна помощь с настройкой или выбором стека — запишись на консультацию к Максиму.

Обновлено: апрель 2026. Тестировалось на Windows 11, Claude Code v2.1.91.