Claude Code на Windows: установка, терминал и типичные ошибки первого запуска

Claude Code работает на Windows нативно и внутри WSL. Для обычного Windows-проекта можно начать с PowerShell без установки Linux. WSL2 нужен, если репозиторий уже использует Linux-инструменты или вам важен sandbox для команд.

Ниже установим терминальную версию, проверим окружение и запустим одну задачу в отдельном репозитории.

Нативный Windows подходит для проектов на PowerShell, .NET и других инструментов, которые уже работают в системе. Claude Code запускает команды через PowerShell, а при установленном Git for Windows может использовать Git Bash.

WSL2 выбирайте для Linux toolchain, bash-скриптов и репозиториев, которые команда хранит внутри WSL. В этом случае установка и запуск выполняются из терминала Linux.

Не ставьте две копии «на всякий случай». Сначала выберите, где находятся проект, Git и зависимости. Иначе команда claude в PowerShell и в WSL будет видеть разные окружения.

Текущая официальная документация указывает Windows 10 1809+ или Windows Server 2019+, 4 ГБ оперативной памяти, x64 или ARM64 и соединение с интернетом.

Проверьте версию Windows и архитектуру в системных настройках. Для реального проекта понадобится Git:

Git for Windows рекомендован для нативной работы. Без него Claude Code может использовать PowerShell, но вы потеряете привычный Git-процесс, который нужен для безопасного контроля изменений.

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

Альтернативный путь через WinGet:

Выберите один способ. Нативный installer обновляется автоматически в фоне. Установка через WinGet требует периодически запускать:

После установки закройте и откройте PowerShell, затем проверьте:

Рабочая команда выводит номер версии и название Claude Code.

Официальная документация дает разные команды для PowerShell и Command Prompt. irm относится к PowerShell. Конструкция с && для CMD может дать ошибку в старой версии PowerShell.

У PowerShell приглашение начинается с PS C:\.... В CMD префикса PS нет. Если инструкция сообщает, что irm не найден, вы, вероятно, открыли CMD.

Не исправляйте синтаксис случайной заменой символов. Вернитесь к вкладке вашей оболочки в официальном гайде.

Если claude --version работает, можно выполнить диагностику:

Эта команда полезна после установки, но не поможет, если система вообще не находит claude. В таком случае сначала откройте новый терминал и проверьте PATH и вывод установщика.

Если использовали Git for Windows, убедитесь, что Git Bash доступен. При нестандартном расположении путь можно задать в settings.json, но не копируйте чужой путь, пока не нашли свой bash.exe.

Запустите:

Инструмент предложит авторизацию в браузере. Поддерживается подписка Claude, Console с API-оплатой и корпоративные облачные провайдеры.

Если в окружении уже задан ANTHROPIC_API_KEY, Claude Code может предложить использовать его вместо обычного входа. Не подтверждайте незнакомый ключ. После входа проверьте активный способ через /status.

Завершите сессию и перейдите в папку тестового репозитория:

Не запускайте Claude Code из C:\Users\you: там находятся документы и настройки разных программ. Рабочей границей должен быть один проект.

Если git status показывает чужие или старые изменения, не просите агента их удалить. Разберите их вручную или создайте отдельную копию.

Запустите claude в папке проекта и попросите:

Сверьте вывод с README и конфигурацией. Так вы проверите рабочую директорию и качество чтения до первой правки.

На первом запуске Claude Code запрашивает подтверждение изменений. Режимы разрешений могут отличаться по тарифу и настройкам организации, поэтому не полагайтесь на старый скриншот. Проверьте текущий режим и переключитесь на ручной контроль, если изучаете инструмент.

До изменения выполните в отдельном PowerShell:

Исходная версия должна собираться или запускаться. Выполните штатную проверку проекта и сохраните результат.

Для нового репозитория проверьте .gitignore. Не добавляйте .env, зависимости, временные файлы и сборочные каталоги. Используйте точные пути и читайте staged diff до первого коммита.

Например:

Не подтверждайте план, который расширяет задачу. Если агент предлагает рефакторинг, вынесите его отдельно.

Читайте запросы команд. Установка пакета, сетевой вызов и удаление имеют другой риск, чем чтение файла или запуск известного теста.

После сообщения о готовности выполните:

Откройте измененные файлы. Проверьте новые untracked-файлы отдельно: обычный diff не показывает их содержимое.

Запустите исходный тест и откройте интерфейс. Если результат неверен, опишите конкретный симптом и разрешите только узкое исправление.

Перед коммитом добавляйте ожидаемые пути и смотрите staged diff:

Если проект требует Linux, установите WSL2 по официальной инструкции Microsoft. Откройте дистрибутив и установите Claude Code Linux-командой уже внутри него:

Храните репозиторий в файловой системе WSL для постоянной Linux-разработки. Запускайте claude, Git и тесты из одной среды.

Не используйте Windows-копию Claude Code для управления Linux-проектом через случайные пути и наоборот. Различия прав, окончаний строк и зависимостей создадут шум.

WSL2 поддерживает sandboxing команд, а нативный терминальный Claude Code на Windows, по текущей документации, его не поддерживает. Это весомая причина выбрать WSL для рискованного toolchain, но sandbox все равно не заменяет Git и ревью.

`claude` не найден. Откройте новый терминал. Если не помогло, проверьте завершение installer и PATH. Не запускайте claude doctor, пока сама команда недоступна.

Ошибка `irm`. Вы открыли CMD. Перейдите в PowerShell или возьмите CMD-команду из официальной инструкции.

Не найден Git Bash. Проверьте установку Git for Windows и фактический путь bash.exe. Не меняйте настройки наугад.

Браузер не возвращает авторизацию. Скопируйте предложенную ссылку или код вручную и проверьте системное время и корпоративный прокси.

Агент запускает не те команды. Уточните оболочку и покажите файлы проекта с командами. Bash и PowerShell имеют разный синтаксис.

Появился огромный diff. Проверьте CRLF/LF и автоформатирование. Отмените шум до продолжения.

Запишите рабочую оболочку, путь проекта, команды запуска и тестов. Инструкции можно сохранить в CLAUDE.md, но в ней должны быть только проверенные сведения без секретов и личных путей.

В Windows одна и та же ошибка может идти от Claude Code, PowerShell, Git или самого проекта. Разделяйте их наблюдаемыми командами.

До запуска агента выполните штатную проверку проекта вручную. Если npm test, pytest или команда сборки уже падает, сохраните вывод. Тогда после правки вы сможете отличить старый дефект среды от нового дефекта кода.

Проверьте пути и окончания строк. Проект может ожидать регистр имени файла, символ / или LF, а локальные инструменты Windows вести себя иначе. Не просите агента массово «нормализовать проект», если ошибка касается одного файла. Сначала покажите конкретный вывод и попросите объяснить причину без правок.

Если используете WSL2, храните проект в файловой системе той среды, где выполняются команды. Постоянная работа с Linux-инструментами по папке Windows может давать лишние проблемы с производительностью и правами. Не переносите рабочий репозиторий вслепую: сделайте свежий clone в выбранной среде и повторите базовые проверки.

После учебной папки откройте небольшой настоящий проект. Перед сессией:

1. получите последние изменения команды;

2. выполните git status;

3. не трогайте чужие незакоммиченные файлы;

4. создайте отдельную ветку;

5. запустите тесты и сохраните исходный вывод;

6. попросите Claude Code прочитать инструкции проекта;

7. дайте одну задачу с перечнем разрешенных файлов.

После выполнения отдельно посмотрите новые untracked-файлы. Обычный git diff не показывает их содержимое, пока они не отслеживаются. Прочитайте каждый файл, добавьте только точные пути, затем проверьте git diff --cached.

Не принимайте установку новой зависимости как мелкую часть задачи. Попросите объяснить, зачем она нужна, какая версия выбрана и можно ли решить задачу существующими средствами. Установка пакета меняет не только код, но и цепочку поставки.

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

После успешной сессии сохраните не переписку целиком, а воспроизводимые факты: версию Claude Code, выбранную среду, команды проекта и принятый коммит. Если проблема повторится на другом компьютере, сравните эти четыре пункта. Скриншот последней ошибки без команды и рабочей папки редко позволяет восстановить причину. Для обращения за помощью приложите точный текст ошибки, но заранее удалите ключи, имена клиентов и внутренние адреса.

Укажите также версию Windows и название оболочки: это заметно сокращает диагностику.

На курсе «Вайбкодинг на максималках» Claude Code используется вместе с Git, базой, API, Docker и деплоем. Это помогает перейти от установки к полному циклу проекта.

Первый запуск на Windows завершен, когда команда находится в новом терминале, авторизация понятна, открыт нужный репозиторий, а одна малая правка прошла через diff и тест. WSL добавляйте, когда его требует проект или модель безопасности, а не как обязательный ритуал.