Установка Claude Code на Windows: пошаговый гайд
До 2025 года запустить Claude Code на Windows без WSL было невозможно. Сейчас он работает нативно — но всё равно падает при установке у каждого второго. Причина почти всегда одна и та же. Разберёмся по порядку.
Что нужно до того, как запускать установщик
Бесплатного доступа к Claude Code нет. Нужно либо активная подписка — Pro ($20/мес.) или Max ($100–200/мес.) — либо API-ключ с console.anthropic.com, где платишь за потреблённые токены.
Второй обязательный компонент — Git. Claude Code использует Git Bash как внутреннюю оболочку для выполнения команд. Это справедливо независимо от того, запускаете вы инструмент из PowerShell, CMD или напрямую. Без Git либо сам установщик остановится, либо после запуска claude ничего не будет работать.
Берите Git на git-scm.com, устанавливайте с настройками по умолчанию. Единственное, что важно проверить вручную: галочка «Add Git to PATH» — она включена по умолчанию, просто не снимайте её случайно.
Node.js при нативной установке не нужен — это частое заблуждение из старых гайдов.
Три пути установки
PowerShell — то, что рекомендует Anthropic
Официальный способ. Устанавливает бинарный файл claude в папку ~\.local\bin без какихлибо внешних зависимостей. Команду установки берите напрямую с официальной документации: code.claude.com/docs/en/setup.
Запустите PowerShell (Win+X → Terminal или Win+R → powershell), вставьте команду, дождитесь завершения. После этого обязательно закройте терминал и откройте новый — без перезапуска переменная PATH не обновится и claude останется «не найденной командой».
WinGet
Встроен в Windows 11 и Windows 10 начиная с версии 22H2. Если winget не реагирует — поищите «App Installer» в Microsoft Store и установите оттуда.
Команда: winget install Anthropic.ClaudeCode
Важный нюанс: WinGet не обновляет пакеты автоматически. Чтобы получать новые версии, придётся периодически запускать winget upgrade Anthropic.ClaudeCode вручную.
npm — устаревший метод, не используйте
Команда npm install -g @anthropic-ai/claude-code всё ещё гуляет по половине гайдов в интернете, но официально признана устаревшей. Если встречаете её в инструкции — инструкция старая.
Почему пишет «claude не является командлетом»
Это самая частая проблема после установки через PowerShell. Сама установка прошла корректно — просто папка C:\Users\ВашеИмя\.local\bin не попала в PATH.
Исправить можно двумя способами.
Вручную: Win+R → sysdm.cpl → вкладка «Дополнительно» → «Переменные среды» → в пользовательских переменных найти PATH → «Изменить» → «Создать» → вставить C:\Users\ВашеИмя\.local\bin. Перезапустить терминал.
Командой в PowerShell:
[Environment]::SetEnvironmentVariable(«PATH», «$env:PATH;$env:USERPROFILE\.local\bin», [EnvironmentVariableTarget]::User)
Первый запуск
При первом вызове claude автоматически откроется браузер — нужно войти в аккаунт через OAuth на claude.ai. Авторизационный токен сохраняется локально в ~\.claude\session.json, повторно входить не придётся.
После авторизации перейдите в папку с нужным проектом и запустите claude. Инструмент сам проиндексирует структуру файлов и готов к работе.
Чтобы убедиться, что всё установлено правильно: claude doctor — покажет версию, тип установки и подсветит типичные проблемы конфигурации.
WSL: когда это лучший вариант
Если проекты живут внутри WSL, имеет смысл поставить Claude Code туда, а не в нативный Windows. Файловые операции в этом случае будут заметно быстрее. Главное — держите проекты в линуксовой файловой системе (~/projects/), а не на смонтированных дисках Windows (/mnt/c/…): разница в скорости ощутима.
Обновления
Нативная установка через PowerShell обновляется в фоне автоматически — делать ничего не нужно. WinGet-версия обновляется только вручную командой winget upgrade Anthropic.ClaudeCode.
Коротко
Три шага: поставить Git → запустить установщик через PowerShell → при необходимости добавить ~\.local\bin в PATH. Если что-то пошло не так после — claude doctor укажет на проблему.
