Установка Claude Code на WSL2 с нуля: пошагово
WSL2 даёт полноценный Linux внутри Windows, и Claude Code там работает стабильнее, чем под чистой Windows: меньше багов с путями и подсчётом. Установка с нуля занимает минут двадцать: WSL, Ubuntu, Node LTS, сам Claude Code и ключ. Дальше работает как на обычном Linux.
Шаг 1. Поставить WSL2 и Ubuntu
# в PowerShell от администратора: wsl --install # после перезагрузки Ubuntu запустится и попросит имя пользователя и пароль
Шаг 2. Обновить пакеты
sudo apt update && sudo apt upgrade -y
Шаг 3. Поставить Node LTS
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
node --version # 20.x или выше
npm --version
Шаг 4. Поставить Claude Code
npm install -g @anthropic-ai/claude-code claude --version
Шаг 5. Задать ключ
# добавьте в ~/.bashrc строку: export ANTHROPIC_API_KEY="sk-ant-..." # примените: source ~/.bashrc
Шаг 6. Проверить
cd ~/projects/myapp
claude
> скажи hello
ответ пришёл: установка работает
claude не находится в новом окне. Выполните source ~/.bashrc или откройте терминал заново, чтобы PATH обновился.Из РФ без геоблока
Прямой ключ из WSL в России часто упирается в геоблок. Реселлерский шлюз CLOD решает это: Anthropic-совместимый API, ключ кладётся в ту же переменную, Claude Code работает без VPN, оплата рублём.
Частые вопросы
Зачем ставить Claude Code в WSL, а не в Windows?
В WSL меньше багов с путями и подсчётом контекста. Плюс unix-инструменты под рукой. На Windows тоже работает, но WSL стабильнее.
Нужен ли графический интерфейс в WSL?
Нет. Claude Code работает в терминале. Графика не нужна.
Можно ли редактировать код с Windows, а Claude Code гонять в WSL?
Да, проект лежит в файловой системе WSL, редактируете его из VS Code через WSL Remote, а Claude Code запускаете в терминале WSL.
Как обновлять Claude Code в WSL?
Командой npm update -g @anthropic-ai/claude-code. Перед обновлением закройте запущенные сессии.