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

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

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

В этом гайде — три рабочих способа установки, разбор ошибок с конкретными командами и честное сравнение: когда брать нативную версию, а когда 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)

Или вручную:

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

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

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

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

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

Решение:

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

Если 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 дал наименьшее количество проблем у людей без опыта в терминале. Прогресс-бар видно, ошибка если есть — понятная. Для первого раза рекомендую именно его.»

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

Метод	Автообновление	Простота	Рекомендуется когда
Native Installer (PowerShell)	Да, фоново	Средняя	Основная рабочая машина
WinGet	Нет, вручную	Высокая	Первая установка, видимый прогресс
WSL2 + Ubuntu	Вручную (npm)	Низкая	Проект требует Linux-окружения
npm (устаревший)	Нет	Средняя	Не используй для новых установок

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 Ubuntu
Настройка	Быстро, 5 минут	Дольше, 20-30 минут
Windows-проекты	Идеально	Медленнее через /mnt/
Linux-скрипты в агенте	Ограниченно	Полностью
Docker интеграция	Нет	Да
Sandboxing	Нет	Да (WSL2 only)
Clipboard (изображения)	Alt+V	Ctrl+V

Нативная установка — дефолтный выбор для разработки на 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.