Claude Code на Windows: установка, PowerShell, Git Bash и ошибки запуска

Команда claude должна открывать агент в нужной папке проекта. На Windows сначала выберите среду, затем проверьте установку и оболочку: это поможет отличить ошибку PATH от проблемы входа или выполнения команд.

Выберите Native Windows или WSL

Для первой установки используйте ту среду, где уже запускается ваш проект. Если сборка работает в PowerShell, начинайте с Native Windows. Если инструменты проекта установлены внутри Linux, запускайте Claude Code внутри той же системы WSL. Переносить проект ради установки агента обычно лишняя работа. Сначала сохраните рабочую среду.

Согласно официальным требованиям Claude Code, поддерживаются Windows 10 1809 и новее, а также Windows Server 2019 и новее, процессоры x64 или ARM64 и память от 4 ГБ. Нужны интернет и учётная запись с доступом к Claude Code. Доступность сервиса и способ входа проверьте до настройки проекта: успешная установка программы ещё не означает доступ к модели.

У Native Windows Git for Windows теперь опционален. Без него Claude Code выполняет команды через PowerShell; с Git for Windows доступен Bash. Поэтому старый совет «сначала обязательно установите Git Bash» может отправить вас искать зависимость, которая для выбранного сценария не нужна.

Это различие описано в документации песочницы. Разрешения на вызовы инструментов и изоляция команд операционной системой решают разные задачи. Если нужна именно изоляция Bash, выбирайте WSL 2 и настройте её по документации.

Установите CLI из правильной оболочки

CLI — программа с интерфейсом командной строки. Здесь работаем с ней; установка расширения VS Code не заменяет отдельную установку команды claude. Основы терминала Windows можно освежить в справочнике командной строки.

Откройте обычное окно PowerShell, без повышения прав до администратора. В приглашении часто виден префикс PS. Выполните официальную команду:

irm https://claude.ai/install.ps1 | iex

Команда получает установочный сценарий с адреса Anthropic и выполняет его. Проверьте адрес перед запуском. Дождитесь завершения: во время загрузки установщик может не показывать прогресс.

Затем закройте окно и откройте новое. Проверьте:

claude --version
claude doctor

Первая команда должна вывести номер установленной версии. Не сверяйте его с номером из чужого скриншота: версия меняется. claude doctor показывает диагностические сведения об установке и настройках. Если программа не найдена, до входа в аккаунт вы ещё не дошли.

В CMD действует другая команда:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Выберите один способ. Сообщение об ошибке возле && в старой версии PowerShell обычно означает, что вы вставили команду для CMD. Сообщение о неизвестной irm в CMD указывает на обратную путаницу. Менять политики безопасности для исправления такой ошибки не требуется. Проверьте оболочку.

Проверьте PATH до повторной установки

PATH — список папок, в которых оболочка ищет программы по имени. Установленный файл может существовать, а новая команда оставаться недоступной в старом окне терминала.

В PowerShell проверьте расположение нативной установки:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
$env:PATH -split ';' | Select-String '\.local\\bin'

Test-Path отвечает, существует ли файл. where.exe показывает найденные исполняемые файлы, а последняя команда ищет папку установки среди элементов PATH. Команды и путь к файлу приведены в руководстве по установочным ошибкам.

Если файл найден, сначала перезапустите терминал. Если папки всё ещё нет в пользовательском PATH, откройте системные настройки переменных среды и добавьте %USERPROFILE%\.local\bin в PATH своего пользователя. Оставьте остальные папки в списке: они нужны для запуска других программ. После изменения снова откройте терминал и выполните claude --version.

Когда where.exe claude показывает несколько путей, сохраните этот вывод. Он объясняет, почему разные терминалы могут запускать разные установки. Не удаляйте найденные папки наугад: определите способ установки и используйте соответствующую инструкцию удаления. Нативный установщик и WinGet — разные способы управления одной программой.

Подключите Git Bash, если он нужен проекту

Git Bash полезен, когда учебный проект использует Bash-сценарии или вы хотите освоить команды Git в привычной для Linux оболочке. Установите Git for Windows с официального сайта Git, затем перезапустите терминал.

Claude Code обычно находит установленный Bash сам. При нестандартном расположении проверьте путь к bash.exe. В пользовательском settings.json можно указать:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Это пример стандартного расположения, а не путь, который нужно копировать без проверки. Если файл настроек уже существует, добавьте поле к имеющейся конфигурации: замена всего файла может потерять ваши другие параметры.

Переменная должна указывать на исполняемый файл оболочки, например bash.exe. Значок запуска git-bash.exe служит другой цели. После изменения начните новую сессию и попросите агента назвать оболочку, которой он собирается выполнить конкретную команду. Факт выполнения проверьте в журнале инструмента. Названия в ответе недостаточно.

Устанавливайте WSL-версию внутри Linux

Если выбираете WSL, сначала проверьте установленный дистрибутив из PowerShell:

wsl -l -v

Если хотите использовать песочницу, найдите 2 в столбце версии. Если WSL ещё не настроена, используйте инструкцию Microsoft, затем вернитесь к установке Claude Code.

В терминале дистрибутива выполните Linux-команду из документации Anthropic:

curl -fsSL https://claude.ai/install.sh | bash
claude --version
claude doctor

Проверки относятся к Linux-установке. Запуск этих же проверок в PowerShell покажет другую среду. Подготовьте учебный проект внутри выбранной среды и проверьте его обычную команду сборки там же.

Не смешивайте пути в инструкциях агенту. C:\Users\... относится к Windows; путь внутри домашней папки Linux относится к дистрибутиву. Если инструмент проекта запускается из неожиданного места, выясните происхождение команды до работы над кодом. Для WSL это особенно заметно по путям, ведущим в /mnt/c/.

Запустите агент в учебной папке

Для проверки создайте папку claude-windows-demo и сохраните в ней вымышленный файл README.md:

# Учебный каталог
Страница содержит карточки двух вымышленных товаров.
Проверка запуска: прочитать этот файл и назвать цель проекта.

Для Native Windows откройте PowerShell, а для WSL — терминал выбранного дистрибутива. Создайте учебную папку в той же среде, перейдите в неё командой cd и запустите claude. Следуйте запросам входа. После запуска отправьте:

Прочитайте README.md в текущей папке.
Назовите цель проекта и путь прочитанного файла.
Ничего не изменяйте и не подключайте внешние инструменты.

В ответе ожидается описание учебного каталога. Сверьте путь в вызове чтения. Это проверяет цепочку «правильная оболочка → установленная команда → доступная сессия → правильная папка». Правки интерфейса здесь ещё не нужны.

Затем попросите агента выполнить git --version, если Git установлен. Просмотрите запрос разрешения и точную команду перед подтверждением. При отсутствии Git пропустите эту проверку: чтения учебного файла достаточно для проверки запуска.

Определите, на каком этапе произошёл сбой

Если соединение сообщает об ошибке TLS, проверьте сертификаты по официальной инструкции. На рабочей машине могут понадобиться настройки, принятые в вашей организации. Отключение проверки сертификатов скрывает проблему и меняет доверие к соединению.

Установку на Windows в этом материале мы не выполняли. Команды сверены с официальной документацией; фактический результат нужно проверить на вашей машине.

Закрепите запуск одной задачей

Повторите чтение README.md после закрытия терминала. Если сценарий работает, запишите выбранную среду, способ установки и команду диагностики. Теперь у вас есть опора для следующей задачи: вы сможете отделить сбой агента от ошибки проекта.

Чтобы перейти к постановке задач и проверке изменений, откройте бесплатный раздел курса «Разработка с AI-агентами: инженерный подход». Перед упражнениями подготовьте учебный репозиторий, в котором разрешено менять файлы.

«Доктайп» — журнал о фронтенде. Читайте, слушайте и учитесь с нами.