# Как установить Claude Code на Windows: пошагово через WSL
Канонический URL: https://zero2claude.ru/blog/claude-code-windows-wsl
Дата: 2026-08-04
Теги: claude-code, терминал, новичкам
Пошагово: включаешь WSL, ставишь Ubuntu и Node.js, ставишь Claude Code через npm — и запускаешь claude. Плюс разбор типичных ошибок новичка.
Почти все гайды по Claude Code написаны так, будто у каждого читателя Mac или Linux. А у тебя — обычный Windows, и уже на первом шаге начинаются вопросы: куда вводить команды, что такое bash и почему у всех в примерах какие-то другие окна. Из-за этого многие бросают установку, даже не дойдя до первого запуска.
На самом деле поставить Claude Code на Windows — задача минут на двадцать, и большая часть этого времени уйдёт на перезагрузку и скачивание Ubuntu. В этом гайде разберём два пути — нативный и через WSL, — а потом пройдём WSL-вариант по шагам: от одной команды в PowerShell до первого диалога с Claude в терминале.
Открой PowerShell от имени администратора и выполни `wsl --install`, перезагрузись и заведи пользователя в Ubuntu. Внутри Ubuntu установи Node.js, затем выполни `npm install -g @anthropic-ai/claude-code`. Набери `claude`, войди в аккаунт — и можно работать.
## Зачем вообще терминал
Claude Code — это не сайт и не приложение с кнопками. Это ассистент, который живёт в [терминале](/glossary/terminal): ты пишешь ему задачу обычным текстом, а он сам читает файлы проекта, правит код и запускает команды. Такой формат и делает его сильным: ассистент работает прямо там же, где работает твой код.
Поэтому без терминала никуда — но и бояться его не стоит. Для старта хватает пяти-семи команд уровня «покажи файлы» и «зайди в папку». Если терминал для тебя пока тёмный лес, начни с бесплатного курса [«Код и терминал»](/learn/code-terminal) — он учит всему этому прямо в браузере, ничего не устанавливая.
## PowerShell или WSL: два пути
У Claude Code есть нативная поддержка Windows: он умеет работать в PowerShell и в Git Bash. Если тебе нужно «просто попробовать» — этот вариант сработает.
Но есть путь лучше — WSL, Windows Subsystem for Linux. По-простому это настоящий Linux внутри твоего Windows: не отдельный компьютер и не замена системе, а просто ещё одно окно терминала, в котором живёт Ubuntu. Все твои файлы и программы остаются на месте.
| | Нативно (PowerShell / Git Bash) | WSL (Ubuntu) |
| --- | --- | --- |
| Установка | Чуть быстрее | Плюс 10 минут на WSL |
| Команды | Смесь Windows- и Unix-команд | Стандартные Unix-команды |
| Совместимость с гайдами и курсами | Примеры часто «не сходятся» | Всё работает как в примерах |
| Окружение для разработки | Урезанное | То же, что у большинства разработчиков |
| Для обучения | Терпимо | Лучший вариант |
Почему для обучения WSL выигрывает: почти все учебники, курсы и ответы Claude рассчитаны на Unix-команды — `ls`, `cd`, `mkdir`, `cat`. В WSL они просто работают, и всё выученное один в один пригодится на любом сервере и в реальных проектах. В PowerShell половина примеров из интернета спотыкается о другие команды и пути, и силы уходят не на обучение, а на перевод.
## Ставим через WSL: пошагово
### Шаг 1. Включи WSL
Нажми «Пуск», набери «PowerShell», запусти его правой кнопкой — «Запуск от имени администратора» — и выполни:
```bash
wsl --install
```
Windows сам скачает и включит всё нужное, а заодно поставит Ubuntu — самый популярный дистрибутив Linux. Когда команда закончит работу, перезагрузи компьютер: это обязательный шаг.
### Шаг 2. Настрой Ubuntu
После перезагрузки Ubuntu обычно открывается сама. Если нет — найди «Ubuntu» в меню «Пуск» или установи её из Microsoft Store и запусти вручную.
При первом запуске Ubuntu попросит придумать имя пользователя и пароль. Важный момент, о который спотыкаются все: когда ты вводишь пароль, на экране не появляется ничего — ни звёздочек, ни точек. Это нормально, так Linux прячет пароль. Набирай вслепую и жми Enter.
### Шаг 3. Установи Node.js
Claude Code написан на JavaScript, поэтому ему нужна среда Node.js и менеджер пакетов npm. Ставим их внутри Ubuntu:
```bash
sudo apt update
sudo apt install -y nodejs npm
```
Команда `sudo` выполняет действие от имени администратора — Ubuntu спросит тот самый пароль, который ты придумал на прошлом шаге. Когда установка закончится, проверь версию:
```bash
node -v
```
Если видишь номер версии 18 или выше — всё в порядке, идём дальше.
### Шаг 4. Установи Claude Code
Одна команда:
```bash
npm install -g @anthropic-ai/claude-code
```
Флаг `-g` означает «глобально»: Claude Code будет доступен из любой папки, а не только из текущей.
### Шаг 5. Первый запуск
Создай папку для экспериментов, зайди в неё и запусти Claude:
```bash
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»](/learn/claude-101) — от первого промпта до полноценной работы с проектами.
И не пропускай терминальную базу: чем увереннее ты ориентируешься в командах, тем проще проверять, что Claude сделал, и поправлять его. WSL, который ты только что настроил, — идеальная среда для такой практики: настоящий Linux, где всё работает как в учебниках, а сломать Windows невозможно.
Нет, не обязательно — нативный путь рабочий. Но WSL даёт стандартное Unix-окружение: все команды из курсов и гайдов работают без переделок, а навыки переносятся на серверы и другие системы. Если планируешь учиться, а не только попробовать, WSL окупается сразу.
Нет. WSL — это штатная возможность Windows, а не сторонний хак. Пока окно Ubuntu закрыто, ресурсы почти не тратятся. Windows продолжает работать как раньше, все файлы и программы на месте, а удалить Ubuntu можно в пару кликов, как обычное приложение.
Для входа нужен аккаунт Anthropic. Попробовать можно и на бесплатном тарифе, но лимиты там скромные, поэтому для регулярной работы обычно берут подписку — она открывает Claude Code без оплаты за каждый запрос.
Нет, так задумано: Linux не показывает даже звёздочки при вводе пароля, чтобы никто не подсмотрел его длину. Набирай пароль вслепую и жми Enter — всё вводится, просто невидимо.