← Все гайды

Вдвоём · Гайды

Claude Code на Windows: на что обратить внимание

⏱ 5-6 минут чтения 🪟 Только для Windows
1
терминалы

PowerShell и Git Bash: в чём разница

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

Одна и та же команда
PowerShell:
if (Test-Path file.txt) { Remove-Item file.txt }
Git Bash / MSYS:
[ -f file.txt ] && rm file.txt

Команды, которые ты видел в туториалах для Mac или Linux (`rm -rf`, `export VAR=x`), почти всегда написаны под bash-подобный терминал и не заработают в чистом PowerShell без изменений. Если агент сгенерировал команду, которая не сработала, покажи ему точный текст ошибки, он подстроит команду под нужный терминал.

2
антивирус

Антивирус может удалить node.exe

Реальный случай, а не гипотетический: некоторые антивирусы, включая Kaspersky, иногда помечают `node.exe` как угрозу во время установки npm-пакетов и молча удаляют его.

Это ложное срабатывание, а не настоящий вирус: Node.js это движок, на котором построены многие инструменты разработки, и его массово используют миллионы разработчиков. Но антивирус видит подозрительное поведение (быстрая установка множества файлов) и иногда реагирует слишком агрессивно.

Если Claude Code вдруг перестал запускаться после установки пакетовПроверь карантин антивируса. Если node.exe там, восстанови его из карантина и добавь папку с Node.js в исключения на время установок.
3
пути

Пути и пробелы

Windows-путям вроде C:\Users\Имя Фамилия\Documents пробел в имени пользователя может ломать команды, которые нормально работают в других системах.

  1. Если команда падает с непонятной ошибкой про путь, проверь, нет ли в пути пробелов или кириллицы
  2. В Git Bash пути вида C:\... и /c/... не всегда взаимозаменяемы: некоторые инструменты понимают только один вариант
  3. Простое решение для проекта: создать рабочую папку без пробелов в пути, например D:\мой-проект вместо папки внутри «Мои документы»
4
по желанию

Когда стоит поставить WSL

WSL (Windows Subsystem for Linux) это встроенная в Windows возможность запускать настоящий Linux рядом с обычной системой. Не обязательно для старта, но снимает многие windows-специфичные проблемы разом.

СитуацияСтоит ли ставить WSL
Только начинаешь, простой проектНе обязательно, обычный терминал справится
Много туториалов и примеров написаны под Linux/MacДа, экономит время на адаптации команд
Работаешь с Docker или сложным окружениемДа, на Windows это часто стабильнее через WSL
Если решишь ставить WSL, попроси Claude Code провести тебя через установку пошагово: это стандартная задача, агент справится сам.