Claude Code ставится на Windows одной командой в PowerShell и работает нативно, без WSL. Единственное, что реально теряется в нативном режиме, — песочница команд: она поддерживается только на macOS, Linux и WSL2.

Дальше — по шагам, с проверкой на каждом. Всё проверено на Windows 10 Pro 22H2 и версии Claude Code 2.1.241.

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

Официальные требования короткие:

  • Система: Windows 10 версии 1809 и новее или Windows Server 2019 и новее.
  • Железо: 4 ГБ памяти и больше, процессор x64 или ARM64.
  • Оболочка: Bash, Zsh, PowerShell или CMD — на Windows подойдут две последние.
  • Аккаунт: Pro, Max, Team, Enterprise или Console. Бесплатный тариф Claude.ai доступа к Claude Code не даёт.
  • Сеть: нужен доступ в интернет; Россия в список поддерживаемых стран Anthropic не входит.

Node.js обязателен только для установки через npm. Нативный установщик приносит готовый бинарник и Node не использует.

Установка: три способа

1. Нативный установщик (рекомендуемый)

В PowerShell:

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

В CMD команда другая:

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

Права администратора не нужны. Если вы перепутали оболочки, ошибка скажет об этом прямо: The token '&&' is not a valid statement separator означает, что вы в PowerShell, а не в CMD, а 'irm' is not recognized — наоборот. Отличить их можно по приглашению: PS C:\> — это PowerShell, C:\> без PS — CMD.

2. WinGet

winget install Anthropic.ClaudeCode

Важная оговорка: установки через WinGet не обновляются автоматически. Обновлять придётся руками: winget upgrade Anthropic.ClaudeCode. Если Claude Code в этот момент запущен, обновление может не пройти — Windows держит исполняемый файл заблокированным.

3. npm

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

Начиная с версии 2.1.198 пакет требует Node.js 22 и новее. На более старой версии установка не падает, а печатает предупреждение EBADENGINE и всё равно ставится, потому что пакет подтягивает нативный бинарник, который Node в работе не использует. Из Windows-платформ поддерживаются win32-x64 и win32-arm64.

Обновлять npm-установку нужно так: npm install -g @anthropic-ai/claude-code@latest. Команда npm update -g уважает диапазон версий из первоначальной установки и может не перевести вас на свежий релиз.

Не ставьте глобально через sudo/от администратора. Документация предупреждает об этом отдельно: это ведёт к проблемам с правами и к рискам безопасности.

Проверка: claude --version и claude doctor

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

claude --version

Рабочая установка печатает версию — например 2.1.241 (Claude Code).

Вторая команда полезнее и часто пропускается:

claude doctor

Она печатает диагностику установки и настроек, ничего не запуская и ничего не меняя. На нативной Windows вывод выглядит так:

Claude Code doctor

Running: npm-global (2.1.241)
Platform: win32-x64
Path: C:\Users\...\npm\node_modules\@anthropic-ai\claude-code\bin\claude.exe
Config install method: global
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: success

No installation issues found.

Три строки, на которые стоит смотреть: Platform (подтверждает, что вы в нативной Windows, а не в WSL), Auto-updates и Last update attempt. Если обновления выключены или последняя попытка провалилась — это видно здесь, а не в момент, когда что-то перестанет работать.

Git for Windows и какая оболочка достанется агенту

Git for Windows формально необязателен, но он определяет, чем агент будет выполнять команды.

Установлен Git for WindowsЧем агент выполняет команды
НетИнструмент PowerShell
ДаИнструмент Bash через Git Bash; PowerShell остаётся доступен рядом

Практически это значит вот что: без Git for Windows любая инструкция из интернета в POSIX-синтаксисе (ls, grep, пайпы, && в bash-стиле) будет выполняться в PowerShell, где часть этого просто не существует. С Git for Windows у агента появляется привычная оболочка.

Если Git Bash установлен, но не находится, путь задаётся в настройках:

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

Нативно или в WSL2

Документация даёт таблицу выбора, и в ней один действительно важный столбец — песочница.

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

Формулировка в документации по песочнице прямая: «Native Windows is not supported. On Windows, run Claude Code inside a WSL2 distribution». Песочница — это изоляция файловой системы и сети на уровне ОС, при которой агент выполняет команды без вопросов внутри заданных границ. В нативной Windows её нет, и защита держится на модели разрешений: в ручном режиме сессия стартует с правами только на чтение и спрашивает перед записью и перед командами, изменяющими систему.

Простое правило: проект лежит в Windows-путях и собирается Windows-инструментами — ставьте нативно. Проект уже в WSL или вам нужна изоляция — работайте внутри WSL2. Что именно теряется без изоляции, разобрано в статье про безопасность вайбкодинга.

Отдельное предупреждение из документации. На Windows не рекомендуется включать WebDAV и давать агенту доступ к путям вида \\*, которые могут содержать WebDAV-подкаталоги: это позволяет обойти систему разрешений через сетевые запросы. WebDAV объявлен устаревшим самой Microsoft.

Обновления и каналы

Нативные установки обновляются в фоне: проверка при запуске и периодически во время работы, установка — в фоне, применение — при следующем старте. Канал обновлений выбирается настройкой autoUpdatesChannel: "latest" (по умолчанию) отдаёт новые версии сразу, "stable" — версию примерно недельной давности, из которой исключены релизы с крупными регрессиями.

Применить обновление немедленно — claude update. Отключить фоновую проверку — DISABLE_AUTOUPDATER в env настроек. Установки через WinGet, Homebrew и пакетные менеджеры Linux сами не обновляются вообще.

Типовые проблемы

  • Команда не найдена после установки. Откройте новый терминал: PATH обновляется для новых процессов, а не для уже открытых.
  • && не работает. Вы в PowerShell, а взяли команду для CMD, или наоборот. Смотрите на приглашение строки.
  • Агент не понимает bash-команды. Не установлен Git for Windows — команды уходят в PowerShell.
  • Обновление через WinGet не проходит. Закройте все запущенные сессии: Windows блокирует исполняемый файл.
  • Приглашение доверия появляется каждый запуск. Так бывает, если запускать Claude Code прямо в домашнем каталоге: подтверждение доверия там держится только на текущую сессию и не пишется на диск. Запускайте из каталога проекта.
  • Не ищутся файлы. За поиск отвечает встроенный ripgrep; claude doctor показывает его состояние строкой Search.

Когда установка прошла и claude doctor молчит — дальше вопрос не инструмента, а формулировок: что именно и как просить. Это разобрано в промптах для вайбкодинга. Если вы только начинаете и хотите порядок действий с контрольными точками — вайбкодинг с нуля. Сравнение с альтернативой — в Claude Code или Codex.