Claude Code на Windows: почему установка спотыкается на терминале и что выбрать вместо WSL
Запросов «claude code windows» в Яндексе почти 1300 в месяц, «как установить claude code на windows» — ещё 365. Судя по формулировкам, спотыкаются люди на подготовке к установке. Половина инструкций в сети начинается со слов «поставьте WSL», после чего предприниматель, который хотел автоматизировать отчёт, закрывает вкладку.
Разберём, что из этого действительно нужно, а что тянется из инструкций двухлетней давности.
WSL больше не обязателен
Claude Code работает на Windows нативно, начиная с Windows 10 версии 1809. Никакой отдельной подсистемы Linux для запуска не требуется: команда ставится прямо из PowerShell или из командной строки и после этого запускается в любом терминале.
Требования к машине скромные: 4 ГБ оперативной памяти и процессор x64 или ARM64. То есть обычный рабочий ноутбук подходит, отдельного сервера или мощной видеокарты здесь не нужно.
WSL остаётся вторым вариантом и имеет смысл в двух случаях: если ваши проекты и так живут в Linux-окружении или если нужна песочница для выполнения команд. Изоляция такого рода поддерживается только в WSL 2 — в нативном Windows её нет. Для типовых задач вроде разбора выгрузки, сборки отчёта или правки сайта это не критично.
Установка занимает одну команду
В PowerShell:
irm https://claude.ai/install.ps1 | iex
В командной строке команда другая:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Права администратора не нужны. Отличить одно окно от другого проще всего по приглашению: в PowerShell строка начинается с «PS C:\», в командной строке — просто с «C:\». Если вы перепутали и вставили команду не туда, Windows скажет об этом прямым текстом: «irm is not recognized» означает, что вы в CMD, а жалоба на разделитель «&&» — что в PowerShell.
Есть и третий путь, через встроенный менеджер пакетов:
winget install Anthropic.ClaudeCode
У него одна особенность, о которой стоит знать заранее: установки через winget не обновляются сами. Нативная установка подтягивает новые версии в фоне, а тут придётся периодически запускать обновление руками.
После установки проверьте, что всё встало:
claude --version
Рабочая установка печатает номер версии. Если что-то пошло не так, диагностику покажет команда claude doctor — она проверяет саму установку и файлы настроек, ничего при этом не запуская.
Git for Windows: не обязателен, но меняет поведение
Вот здесь начинается неочевидная часть, из-за которой чаще всего и возникают вопросы в поиске.
Claude Code выполняет команды в вашей системе — распаковать архив, пройтись по папкам, запустить скрипт. На Windows он может делать это двумя разными способами. Если в системе установлен Git for Windows, агент работает через Git Bash и получает привычный Linux-подобный набор команд. Если Git for Windows нет, он переключается на PowerShell.
Практическая разница проявляется в мелочах, которые всплывают в самый неподходящий момент. Инструкции и примеры из интернета почти всегда написаны под bash, и в PowerShell они не работают дословно: другие имена команд, другие правила экранирования, другой синтаксис многострочного текста. Человеку, который не хочет разбираться в различиях двух оболочек, проще один раз поставить Git for Windows.
Иногда Git Bash установлен, а агент его не находит. Тогда путь прописывается в настройках вручную, ключом CLAUDE_CODE_GIT_BASH_PATH — обычно это «C:\Program Files\Git\bin\bash.exe». Судя по частотности запроса «claude code git bash path», в эту ситуацию попадают регулярно.
Что ещё понадобится до первого запуска
Аккаунт. Claude Code входит в платные тарифы — Pro, Max, командный или корпоративный. Бесплатный аккаунт Claude.ai доступа к нему не даёт. Вход происходит через браузер при первом запуске команды claude.
Понимание, что агент работает в папке. Он видит файлы того каталога, из которого запущен, поэтому терминал нужно открывать в папке проекта. Для человека, привыкшего к «открыть файл двойным щелчком», это главный непривычный момент, и он же самый важный: агент не ищет ваши документы по всему диску, он работает там, куда вы его привели.
Пара минут на обновления. Нативная установка проверяет новые версии при старте и ставит их в фоне, применяются они при следующем запуске. Если версия по каким-то причинам должна быть фиксированной, обновления отключаются настройкой, но по умолчанию об этом думать не нужно.
Что выбрать в итоге
Для большинства задач малого бизнеса нативная установка на Windows плюс Git for Windows — это разумный набор по умолчанию. Ставится за пару минут, обновляется само, команды из статей и видео работают как написано.
WSL стоит рассматривать, когда у вас уже есть Linux-проекты или когда вам принципиально нужна изоляция выполнения команд. Ставить его только ради Claude Code смысла нет, и именно этот лишний шаг чаще всего отпугивает людей на старте.
Про то, как участники клуба применяют такие инструменты в своей работе, мы регулярно пишем в канале — присоединяйся к клубу AI Practiq, там разборы и цифры из практики.