Как установить Claude Code на Windows: пошагово через WSL

Почти все гайды по Claude Code написаны так, будто у каждого читателя Mac или Linux. А у тебя — обычный Windows, и уже на первом шаге начинаются вопросы: куда вводить команды, что такое bash и почему у всех в примерах какие-то другие окна. Из-за этого многие бросают установку, даже не дойдя до первого запуска.

На самом деле поставить Claude Code на Windows — задача минут на двадцать, и большая часть этого времени уйдёт на перезагрузку и скачивание Ubuntu. В этом гайде разберём два пути — нативный и через WSL, — а потом пройдём WSL-вариант по шагам: от одной команды в PowerShell до первого диалога с Claude в терминале.

Зачем вообще терминал

Claude Code — это не сайт и не приложение с кнопками. Это ассистент, который живёт в терминале: ты пишешь ему задачу обычным текстом, а он сам читает файлы проекта, правит код и запускает команды. Такой формат и делает его сильным: ассистент работает прямо там же, где работает твой код.

Поэтому без терминала никуда — но и бояться его не стоит. Для старта хватает пяти-семи команд уровня «покажи файлы» и «зайди в папку». Если терминал для тебя пока тёмный лес, начни с бесплатного курса «Код и терминал» — он учит всему этому прямо в браузере, ничего не устанавливая.

PowerShell или WSL: два пути

У Claude Code есть нативная поддержка Windows: он умеет работать в PowerShell и в Git Bash. Если тебе нужно «просто попробовать» — этот вариант сработает.

Но есть путь лучше — WSL, Windows Subsystem for Linux. По-простому это настоящий Linux внутри твоего Windows: не отдельный компьютер и не замена системе, а просто ещё одно окно терминала, в котором живёт Ubuntu. Все твои файлы и программы остаются на месте.

Почему для обучения WSL выигрывает: почти все учебники, курсы и ответы Claude рассчитаны на Unix-команды — ls, cd, mkdir, cat. В WSL они просто работают, и всё выученное один в один пригодится на любом сервере и в реальных проектах. В PowerShell половина примеров из интернета спотыкается о другие команды и пути, и силы уходят не на обучение, а на перевод.

Ставим через WSL: пошагово

Шаг 1. Включи WSL

Нажми «Пуск», набери «PowerShell», запусти его правой кнопкой — «Запуск от имени администратора» — и выполни:

wsl --install

Windows сам скачает и включит всё нужное, а заодно поставит Ubuntu — самый популярный дистрибутив Linux. Когда команда закончит работу, перезагрузи компьютер: это обязательный шаг.

Шаг 2. Настрой Ubuntu

После перезагрузки Ubuntu обычно открывается сама. Если нет — найди «Ubuntu» в меню «Пуск» или установи её из Microsoft Store и запусти вручную.

При первом запуске Ubuntu попросит придумать имя пользователя и пароль. Важный момент, о который спотыкаются все: когда ты вводишь пароль, на экране не появляется ничего — ни звёздочек, ни точек. Это нормально, так Linux прячет пароль. Набирай вслепую и жми Enter.

Шаг 3. Установи Node.js

Claude Code написан на JavaScript, поэтому ему нужна среда Node.js и менеджер пакетов npm. Ставим их внутри Ubuntu:

sudo apt update
sudo apt install -y nodejs npm

Команда sudo выполняет действие от имени администратора — Ubuntu спросит тот самый пароль, который ты придумал на прошлом шаге. Когда установка закончится, проверь версию:

node -v

Если видишь номер версии 18 или выше — всё в порядке, идём дальше.

Шаг 4. Установи Claude Code

Одна команда:

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

Флаг -g означает «глобально»: Claude Code будет доступен из любой папки, а не только из текущей.

Шаг 5. Первый запуск

Создай папку для экспериментов, зайди в неё и запусти Claude:

mkdir my-project
cd my-project
claude

При первом запуске Claude Code предложит войти в аккаунт: откроется браузер, ты подтвердишь вход — и вернёшься в терминал. Всё, можно писать первую задачу по-русски: «создай файл hello.js, который выводит приветствие».

Частые ошибки и как их чинить

«wsl не является командой» или установка не начинается. Скорее всего, у тебя старая сборка Windows 10. Зайди в «Центр обновления Windows», поставь все обновления и попробуй снова. И проверь, что PowerShell запущен именно от имени администратора.

«npm: command not found» в Ubuntu. Две типичные причины. Первая: Node.js установлен в Windows, а не внутри Ubuntu — это разные миры, и WSL твою «виндовую» установку не видит; повтори шаг 3 именно в окне Ubuntu. Вторая: ты только что поставил Node и не перезапустил терминал — закрой окно Ubuntu и открой заново.

«permission denied» или «EACCES» при установке Claude Code. npm пытается записать файлы в системную папку, куда обычному пользователю нельзя. Самое простое решение — выполнить ту же команду с sudo в начале: sudo npm install -g @anthropic-ai/claude-code. Более аккуратный вариант — настроить npm так, чтобы глобальные пакеты ставились в твою домашнюю папку, но для старта хватит и sudo.

«claude: command not found» после успешной установки. Терминал ещё не знает о новой команде. Закрой и снова открой окно Ubuntu — в девяти случаях из десяти этого достаточно. Если не помогло, переустанови пакет через sudo npm install -g — так он попадёт в папку, где терминал ищет команды.

Claude запускается, но не видит твои файлы. Проверь, в какой папке ты находишься: команда pwd покажет текущий путь. Claude Code работает с той папкой, из которой ты его запустил, — сначала cd в папку проекта, потом claude.

Что дальше

Установка — это только дверь. Дальше начинается самое интересное: научиться ставить Claude задачи так, чтобы он делал именно то, что ты хочешь. Для этого есть бесплатный курс «Claude 101» — от первого промпта до полноценной работы с проектами.

И не пропускай терминальную базу: чем увереннее ты ориентируешься в командах, тем проще проверять, что Claude сделал, и поправлять его. WSL, который ты только что настроил, — идеальная среда для такой практики: настоящий Linux, где всё работает как в учебниках, а сломать Windows невозможно.