Как установить Claude Code на Windows: откройте PowerShell и выполните одну команду —
irm https://claude.ai/install.ps1 | iex
Node.js и WSL не нужны — с 2025 года Anthropic ставит Claude Code нативным инсталлером. После установки откройте новый терминал в папке проекта и введите claude. Дальше — вход в аккаунт через браузер, и агент работает.
Коротко, что важно знать до старта:
- Windows 10 1809+ или Windows 11, 4 ГБ ОЗУ — этого достаточно, WSL не обязателен.
- Нужен платный план Claude (Pro, Max, Team) или аккаунт Console — бесплатный тариф Claude Code не включает.
- Git for Windows ставить желательно: без него Claude выполняет команды через PowerShell, с ним — через Bash.
- Способ через
npm install -gжив, но устарел как основной: он требует Node.js 18+ и чаще ломается на правах. - Расширение VS Code ставится отдельно и не добавляет команду
claudeв терминал — это два разных компонента.
Обновлено: июль 2026. Все команды сняты с официальной документации Anthropic, а не пересказаны по старым гайдам.
Claude Code — это что
Claude Code — терминальный ИИ-агент от Anthropic. В отличие от чата, куда код вставляют кусками, он сам читает файлы проекта, редактирует их, запускает команды и тесты. Вы описываете задачу словами — «найди, почему падает форма регистрации, и почини» — агент делает остальное и показывает diff перед применением.
Под капотом — актуальные модели Anthropic: Opus 4.8, Sonnet 5 и Fable 5. Переключаются командой /model прямо в сессии. На занятиях Зерокодера по Claude Code мы видим один и тот же паттерн: сама установка занимает три минуты, а 80% проблем новичков — это перепутанный терминал и PATH. Поэтому ниже — не только команды, но и разбор ошибок.
Что нужно перед установкой
По официальной странице Advanced setup требования такие:
| Что | Минимум |
|---|---|
| ОС | Windows 10 1809+ / Windows Server 2019+ (также macOS 13+, Ubuntu 20.04+) |
| Железо | 4 ГБ ОЗУ, процессор x64 или ARM64 |
| Аккаунт | Claude Pro / Max / Team / Enterprise или Anthropic Console |
| Git for Windows | Не обязателен, но рекомендован — включает инструмент Bash |
| Node.js | НЕ нужен для нативной установки. Нужен (18+) только для пути через npm |
Один нюанс для читателей из России: Anthropic ведёт список поддерживаемых стран, и РФ в нём нет — аккаунт регистрируют на регион из списка, оплата — зарубежной картой. Это ограничение аккаунта, не инсталлера: сама программа ставится на любую Windows.
Шаг 1. Установите Claude Code
Четыре рабочих способа. Если сомневаетесь — берите первый.
Способ 1 — нативный инсталлер в PowerShell (рекомендован Anthropic):
irm https://claude.ai/install.ps1 | iex
Способ 2 — нативный инсталлер в CMD (если работаете в классической командной строке):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Способ 3 — WinGet, штатный пакетный менеджер Windows:
winget install Anthropic.ClaudeCode
Способ 4 — npm, классический путь для тех, у кого уже стоит Node.js 18+:
npm install -g @anthropic-ai/claude-code
Разница, которую большинство гайдов не объясняет: нативная установка обновляется сама в фоне, WinGet и npm — только вручную (winget upgrade Anthropic.ClaudeCode или npm install -g @anthropic-ai/claude-code@latest). При этом npm ставит тот же нативный бинарник — Node нужен лишь как доставщик пакета. Все четыре варианта задокументированы на одной странице setup; права администратора не требуются ни для одного.
Если в старой статье вам встретилось «на Windows обязателен WSL» — это устаревшая информация: нативная поддержка Windows появилась ещё в 2025-м. WSL остаётся опцией для тех, кому нужны Linux-тулчейн или песочница команд.
Шаг 2. Проверьте установку
Закройте терминал, откройте новый (важно: PATH подхватывается только новым окном) и выполните:
claude --version
Вывод вида 2.x.x — установка прошла. Для развёрнутой диагностики есть встроенный доктор:
claude doctor
Он покажет способ установки, статус автообновлений и конфликты, если Claude Code когда-то ставился двумя способами параллельно.
Шаг 3. Первый запуск и вход
Перейдите в папку проекта и запустите агента:
cd C:\projects\my-site
claude
При первом запуске Claude Code откроет браузер для авторизации. Варианта два: вход по подписке Claude (Pro/Max/Team) или через Anthropic Console с оплатой по API-токенам. Порядок описан в официальном квикстарте.
Первая команда внутри сессии, которая реально экономит время, — /init: агент просканирует проект и создаст файл CLAUDE.md с описанием структуры. Все последующие сессии будут стартовать уже с этим контекстом.
Вывод: установка и вход занимают меньше пяти минут, если не путать PowerShell с CMD — про это ниже.
Шаг 4. Подключите VS Code
Расширение даёт графическую панель: diff-просмотр правок, @-упоминания файлов, историю сессий.
- Откройте VS Code (нужна версия 1.98.0+), нажмите
Ctrl+Shift+X. - В поиске введите «Claude Code», издатель Anthropic, нажмите Install.
- Кликните иконку-искру в правом верхнем углу редактора и войдите в аккаунт.
- Выделите строки кода и нажмите
Alt+K— в промпт вставится ссылка вида@app.ts#5-10.
Ловушка, о которой молчат обзоры: расширение несёт собственную копию CLI внутри себя и не добавляет команду claude в систему. Если хотите запускать claude во встроенном терминале VS Code — нужна отдельная установка из шага 1. Обратное тоже верно: запуск claude в терминале VS Code сам предложит поставить расширение. Детали — в доке Use Claude Code in VS Code.
Типичные ошибки установки и фиксы
Собрано из практики вебинаров Зерокодера и официального трабблшутинга.
«’irm’ is not recognized as an internal or external command» — вы вставили PowerShell-команду в CMD. Проверка за секунду: приглашение PS C:\Users\... — это PowerShell, просто C:\Users\... — CMD. Либо откройте PowerShell, либо используйте команду для CMD из шага 1.
«The token ‘&&’ is not a valid statement separator» — зеркальная ситуация: CMD-команду вставили в PowerShell. Диагностика та же, по приглашению.
«claude: command not found» / «не является внутренней или внешней командой» после успешной установки — в 90% случаев вы проверяете в том же окне терминала, где ставили. PATH обновляется только для новых окон: закройте терминал полностью и откройте заново. Если не помогло — инсталлер кладёт бинарник в %USERPROFILE%\.local\bin; проверьте, что этот путь есть в переменной PATH (Win+R → sysdm.cpl → Дополнительно → Переменные среды).
«npm is not recognized» — вы пошли путём npm, а Node.js не установлен. Либо поставьте Node 18+ с nodejs.org, либо — проще — используйте нативный инсталлер, которому Node не нужен.
Ошибки прав при npm install -g (EACCES) — не запускайте установку через sudo или «от администратора», Anthropic прямо предупреждает об этом в доке. Правильный фикс — сменить глобальную директорию npm или перейти на нативный инсталлер.
Claude Code ставится, но выполняет команды «не так» — без Git for Windows агент работает через PowerShell-инструмент. Если нужен привычный Bash, поставьте Git for Windows с git-scm.com и перезапустите сессию; при нестандартном пути пропишите CLAUDE_CODE_GIT_BASH_PATH в settings.json.
Мини-вывод: любая из этих ошибок диагностируется за минуту по тексту сообщения — сохраните этот раздел.
С чего начать: первые команды в терминале
Синтаксис простой: слэш-команды управляют сессией, обычный текст — это задача агенту.
| Команда | Что делает |
|---|---|
/init |
Создаёт CLAUDE.md — карту проекта для агента |
/help |
Список всех команд |
/model |
Переключение модели: Opus 4.8 / Sonnet 5 |
/resume |
Возврат к прошлой сессии с полной историей |
/compact |
Сжимает контекст, когда сессия разрослась |
Esc |
Останавливает агента (не Ctrl+C — тот убьёт программу) |
claude update |
Ручное обновление без ожидания фонового |
Рабочий первый сценарий: зайдите в любой существующий проект, выполните /init, затем попросите «объясни, как устроен этот проект и где точки входа». Так вы увидите, как агент читает кодовую базу, ещё до того, как доверите ему правки.
Если хотите пройти путь от установки до первого рабочего проекта на Claude Code с обратной связью — у Зерокодера есть практический вебинар по вайб-кодингу, где этот стек разбирается на живой задаче.
Чек-лист установки
- PowerShell →
irm https://claude.ai/install.ps1 | iex - Новое окно терминала →
claude --version - Папка проекта →
claude→ вход через браузер - Внутри сессии →
/init - VS Code → расширение «Claude Code» → иконка-искра
- Ошибка? Сначала проверьте приглашение:
PS C:\илиC:\
FAQ
Нужен ли Node.js для установки Claude Code?
Нет. Нативный инсталлер (PowerShell, CMD, WinGet) ставит готовый бинарник без Node. Node.js 18+ нужен только при установке через npm install -g @anthropic-ai/claude-code.
Работает ли Claude Code на Windows без WSL?
Да. Поддерживается Windows 10 1809+ и Windows 11 нативно. WSL — опция для Linux-тулчейнов и песочницы, но не требование.
Можно ли пользоваться Claude Code бесплатно?
Нет. Нужен план Pro, Max, Team, Enterprise или аккаунт Anthropic Console с оплатой по токенам. Бесплатный тариф Claude.ai доступа к Claude Code не даёт.
Чем расширение VS Code отличается от CLI?
Расширение — графическая панель с diff-просмотром и историей; CLI — работа в терминале с полным набором команд. Они делят общую историю сессий, но ставятся отдельно: расширение не добавляет claude в PATH.
Как обновить Claude Code?
Нативная установка обновляется сама в фоне. Вручную — claude update. Для WinGet — winget upgrade Anthropic.ClaudeCode, для npm — npm install -g @anthropic-ai/claude-code@latest.