Инструкция · Windows · обновлено 21 августа 2026

Claude Code на Windows: одна команда и разбор 7 ошибок

Поставил Claude Code, а на Windows он то не открывается, то вместо ответа выдаёт незнакомую строку на английском - и не понятно, что нажать дальше? Ниже - оба пути установки одной командой в окне для команд и разбор всех 7 частых ошибок Windows: что видишь на экране, что нажать и что получишь в итоге

К концу статьи агент будет стоять и отвечать на твоём Windows, а на любую из 7 ошибок у тебя будет готовый план: как узнать её по одной строке на экране и что нажать, чтобы поехать дальше

Claude Code ставится на Windows одной командой в окне PowerShell - irm https://claude.ai/install.ps1 | iex. Отдельная программа вроде Node.js для этого не нужна, права администратора тоже. Ниже - оба способа по шагам и разбор 7 частых ошибок, на которых чаще всего застревают на Windows

Из практики

Установить - это только первый шаг

Установку я довожу до готового агента почти на каждом потоке учеников: экран расшарен, ошибка на экране - я называю причину и что нажать. Дальше начинается другой вопрос - что вообще собрать первым, когда агент уже отвечает. Как я довожу учеников от установки до первой готовой вещи, показываю у себя

Показать разбор

Что нужно, чтобы Claude Code включился на твоём Windows?

Windows 10 версии 1809 или новее (либо Windows Server 2019 и новее), 64-разрядная система, память от 4 ГБ и оплаченный доступ к Claude - подойдёт любой из тарифов Pro, Max, Team, Enterprise или Console. Бесплатный аккаунт claude.ai для этого не годится, это прямо написано в официальной документации, раздел Advanced setup. Как завести и оплатить подписку из России - отдельный разбор Claude купить подписку, а про доступ и блокировки - Claude и VPN без банов

Слово PowerShell дальше встретится не раз - простыми словами, это готовое окно Windows для печати команд: вместо кликов по кнопкам туда впечатывают текстовую строку, и Windows сразу её выполняет. Устанавливать саму программу отдельно не нужно, она уже есть в Windows

Проверь свой компьютер перед стартом

  1. Открой окно PowerShell и впечатай строку [Environment]::Is64BitOperatingSystem, нажми Enter увидишь слово True - система 64-разрядная и подходит; увидишь False - на этой машине агент пока не встанет
  2. Открой «Параметры» → «Система» → «О системе» увидишь номер сборки Windows и объём оперативной памяти - для установки хватит сборки 1809 и новее плюс памяти от 4 ГБ
  3. Проверь, что оформлен платный доступ к Claude подойдёт любой тариф - Pro, Max, Team, Enterprise или Console; после этого шага точно знаешь, что компьютер и аккаунт готовы к установке

«You do not need to run as Administrator»

Официальная документация Claude Code, раздел Advanced setup → Set up on Windows, проверено 21 августа 2026

Дословно: права администратора для установки не нужны вовсе - агент встаёт в папку твоего собственного профиля, а не в системные папки Windows

Шаг 0. Эта статья - про виндовую часть маршрута. Если аккаунта ещё нет и про сам инструмент слышишь впервые, начни с гайда Claude Code установка из России и вернись сюда за виндовой частью

Обычная Windows или WSL: что выбрать первым?

Для большинства проектов на Windows хватает обычной установки без единой дополнительной программы. WSL - это отдельный слой, который включает внутрь Windows настоящий Linux, и нужен он не всем, а только тем, кому нужны линуксовые привычки или изолированный запуск команд (песочница)

СпособЧто для этого нужноИзоляция команд (песочница)Когда выбирать
Обычная Windowsничего, Git for Windows по желаниюне поддерживаетсяпроекты и привычные программы на самой Windows
WSL 2включить WSL 2поддерживаетсялинуксовые инструменты, изолированный запуск команд
WSL 1включить WSL 1не поддерживаетсятолько если WSL 2 недоступен

Таблица прокручивается вбок →

Вторая разница - скорость поиска по файлам проекта. Через WSL поиск по файлам, что лежат на дисках самой Windows, находит меньше совпадений - об этом прямо предупреждает раздел Troubleshooting документации. Microsoft в своём руководстве Working across file systems советует то же самое: папку проекта для WSL держать внутри самого Linux, а не на диске C

Прикинь на себя: какой сценарий твой

  1. Хочу начать быстро и без лишних программ ставь обычным способом - шаг ниже, весь путь занимает несколько минут
  2. Уже работал в Linux или Ubuntu раньше ставь через WSL - команды и папки будут знакомыми
  3. Не уверен, что выбрать начни с обычной Windows - к WSL всегда можно вернуться позже, оба способа не мешают друг другу

Как поставить Claude Code одной командой в командном окне?

Открой командное окно, вставь одну строку, дождись надписи об успехе, закрой окно и открой новое

Установка в 4 действия

  1. Нажми сочетание клавиш Win + X и выбери в списке пункт Windows PowerShell или Terminal откроется синее окно, строка внутри начинается с PS C:\Users\Имя> - права администратора не нужны
  2. Скопируй строку irm https://claude.ai/install.ps1 | iex, вставь в открывшееся окно и нажми Enter начнётся закачка и установка - появится строка о том, что всё прошло успешно
  3. Закрой это окно и открой новое тем же сочетанием клавиш программа встаёт в папку твоего профиля и прописывает её в список путей Windows - старое окно об этом изменении ещё не знает
  4. В новом окне впечатай claude --version и нажми Enter увидишь номер версии вида 2.1.211 (Claude Code) - значит агент установлен и его можно запускать

Если вместо номера версии окно отвечает ошибкой - переходи в раздел 7 частых ошибок Windows, почти любая из них разбирается по симптому за пару минут

Половина пути позади: агент уже стоит на компьютере. Осталось узнать, что делать при ошибке, и убедиться, что всё работает как надо

Если предпочитаешь не печатать команду руками, есть готовый установщик от Windows - winget install Anthropic.ClaudeCode. У него один минус: сам себя такой установщик не обновляет, обновлять придётся той же командой с словом upgrade вместо install, тогда как обычная установка обновляется в фоне сама

Нужна ли отдельно программа Node.js?

Нет, не нужна. Родной установщик кладёт уже готовую программу, и Node.js (ещё одна отдельная программа для запуска кода на JavaScript) ей не требуется ни при установке, ни при работе

Путаница чаще всего идёт от старых инструкций, где программу ставили отдельным способом через npm. Если всё же ставишь именно так, начиная с определённой версии для этого способа нужен Node.js 22 или новее: на более старой версии установка не падает, а просто печатает предупреждение и всё равно доходит до конца. Вывод для новичка простой - ставь родным способом из командного окна выше и лишнюю программу не заводи

Два похожих окна Windows: почему команда не срабатывает

В Windows есть два похожих, но разных командных окна, у каждого своя команда установки: PowerShell и его более старый сосед CMD. Ещё есть программа-обёртка с вкладками (называется Windows Terminal), внутри которой может открыться любое из первых двух: путаница чаще всего в том, что человек смотрит на название окна, а важна именно строка приглашения внутри него

Что видишь в начале строкиКакое окно открытоКоманда установки
PS C:\Users\Имя>PowerShell`irm https://claude.ai/install.ps1 \iex`
C:\Users\Имя> без букв PSCMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Таблица прокручивается вбок →

Если перепутать окно и команду, Windows сама подскажет об этом ошибкой:

Если появилась одна из этих строк - вот что она значит

  1. Видишь 'irm' is not recognized окно и команда не совпали местами - открой второе окно из таблицы выше и вставь строку для него
  2. Видишь The token '&&' is not a valid statement separator та же путаница наоборот - возьми строку установки для другого окна из той же таблицы
  3. Видишь 'bash' is not recognized в окно Windows вставлена команда для Linux или Mac - используй одну из двух строк для Windows из таблицы выше

Нужна ли ещё одна программа для команд?

Необязательна, но полезна. Git for Windows - это отдельная бесплатная программа: без неё Claude Code выполняет команды через обычное командное окно, а с ней получает ещё и линуксовый стиль работы с командами (называется Git Bash)

Скачивается со страницы git-scm.com/downloads/win: в установщике на всех экранах достаточно нажимать «Next», ничего дополнительно настраивать не нужно

Бывает, что программа стоит, а агент её не находит. Тогда путь к ней задаётся явно, вставкой в файл настроек settings.json:

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

Вставь этот текст в файл настроек и сохрани - после перезапуска Claude Code сам найдёт нужную программу по указанному пути

Если вместо этого окно пишет Claude Code on Windows requires either Git for Windows (for bash) or PowerShell - значит, не нашлось ни одной из двух программ для команд. Проверь, что обычное командное окно вообще открывается штатно через Win + X, и при необходимости поставь свежую версию отдельно со страницы aka.ms/powershell

Как включить WSL и поставить агента внутри?

Одна команда от имени администратора, перезагрузка компьютера, и внутри уже свой линуксовый установщик

Включение WSL и установка внутри

  1. Открой командное окно от имени администратора (правый клик по значку → «Запуск от имени администратора») и впечатай wsl --install, нажми Enter начнётся закачка, следом Windows попросит перезагрузить компьютер - после перезагрузки внутри уже стоит готовая система Ubuntu
  2. Открой окно WSL (найди Ubuntu в меню «Пуск») и впечатай curl -fsSL https://claude.ai/install.sh | bash, нажми Enter появится та же надпись об успехе, что и на обычной установке - агент встал уже внутри WSL, отдельно от той установки, что была раньше

Два правила, которые экономят часы. Первое - держи папку проекта внутри самого Linux (в WSL это путь вида /home/имя/проект), а не на диске C. Второе - если команда claude внутри WSL отвечает cannot execute binary file: Exec format error, это старая версия WSL 1: проверь версию командой wsl.exe --list --verbose и, если там стоит единица, переведи на вторую командой wsl.exe --set-version Ubuntu 2

7 частых ошибок Windows: что нажать на каждую

Почти все ошибки на Windows сводятся к четырём причинам - не то окно, папка не попала в список путей, Windows блокирует запуск вспомогательного файла с командами (это называется скриптом), или антивирус придержал недокачанный файл. Ниже - 7 конкретных симптомов по каждой из них

1. Команда claude не находится

Видишь 'claude' is not recognized as an internal or external command в одном окне, либо claude : The term 'claude' is not recognized as the name of a cmdlet в другом. Значит, папка установки не попала в список путей Windows

Что нажать

  1. Впечатай в командном окне $env:PATH -split ';' | Select-String '\.local\\bin' и нажми Enter пустой ответ означает, что папки установки в списке путей действительно нет
  2. Закрой это окно и открой новое тем же сочетанием клавиш Win + X обычно этого достаточно - список путей подхватывается только в новом окне, старое о нём не знает

Если после нового окна команда всё ещё не находится - значит, установка прервалась раньше времени: вернись к шагу с одной командой выше и повтори её заново

2. Running scripts is disabled on this system

Полный текст ошибки помечен словом PSSecurityException и вылезает при установке через npm: встроенная защита Windows блокирует запуск вспомогательных файлов с командами

Что нажать - впечатай в командном окне строку Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser и нажми Enter, это разрешает запуск для твоего же пользователя. После этого команда установки срабатывает штатно

Если вместо этого проще не трогать настройки безопасности - используй родной способ установки одной командой из раздела выше, там этой защиты Windows не касается вовсе

3. The process cannot access the file

Полный текст начинается с Failed to download binary. Причина обычно одна из двух - параллельно запущена вторая установка, либо антивирус придержал недокачанный файл в папке загрузок

Что нажать - впечатай Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads", нажми Enter, а следом повтори обычную команду установки irm https://claude.ai/install.ps1 | iex

Если ошибка повторяется - на минуту отключи проверку папки загрузок в антивирусе и повтори установку ещё раз

4. Ошибка SSL или TLS

Сообщение Could not create SSL/TLS secure channel встречается на давно не обновлявшихся сборках Windows 10

Что нажать - перед обычной командой установки впечатай ещё одну строку: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12, нажми Enter, а следом обычную команду irm https://claude.ai/install.ps1 | iex

Если ошибка не пропадает - скорее всего, у Windows давно не было обновлений: сначала поставь системные обновления через «Параметры» → «Центр обновления Windows»

5. Claude Code does not support 32-bit Windows

Экран честно так и пишет, хотя сам компьютер 64-разрядный. В меню «Пуск» на самом деле два похожих ярлыка командного окна - обычный и с пометкой (x86), и второй запускает 32-разрядный процесс

Что нажать - закрой это окно, найди в меню «Пуск» ярлык БЕЗ пометки (x86) и повтори команду установки уже в нём

Если в меню «Пуск» видно только один ярлык без пометки - значит, дело не в этом, вернись к первому шагу статьи и ещё раз проверь разрядность системы

6. Команда claude открывает не то

Причина - на компьютере уже стоит отдельное приложение Claude Desktop старой версии, и оно перехватывает себе имя команды claude

Что нажать - обнови приложение Claude Desktop до свежей версии обычным способом, через его собственную кнопку проверки обновлений

Если обновления не помогло - удали старую версию Claude Desktop полностью и поставь её заново с официального сайта

7. Поиск по файлам ничего не находит

Упоминания файлов через @ и поиск по проекту молчат - значит, встроенный поисковый механизм не запустился именно на этой машине

Что нажать - впечатай winget install BurntSushi.ripgrep.MSVC, нажми Enter, а после установки открой заново окно с Claude Code

Если поиск всё ещё молчит после установки - проверь диагностику командой claude doctor, она покажет, что именно не так с поиском

Короткая шпаргалка по всем семи - вернуться к ней проще, чем листать статью заново:

№Строка на экране (кусок)Что нажать
1is not recognizedзакрыть окно, открыть новое
2running scripts is disabledSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
3Failed to download binaryудалить папку .claude\downloads, повторить установку
4SSL/TLS secure channelстрока Tls12, потом обычная установка
5does not support 32-bitоткрыть ярлык без пометки (x86)
6claude открывает не тообновить Claude Desktop
7поиск по @ молчитwinget install BurntSushi.ripgrep.MSVC

Таблица прокручивается вбок →

Пробел или русские буквы в имени пользователя ломают установку

Домашняя папка вида C:\Users\Иван Сергеев иногда ломает часть сценариев Claude Code, потому что пробелы и не-латинские буквы теряются при разборе пути. Это заведённые баги в самом Claude Code, и чинить их приходится обходом, а не ждать починки

Обход проблемы с именем профиля

  1. Впечатай в командном окне $env:USERPROFILE и нажми Enter увидишь свой путь целиком - если в нём есть пробел или русские буквы, переходи к следующему пункту
  2. Впечатай [Environment]::SetEnvironmentVariable('CLAUDE_HOME', 'C:\ClaudeHome', 'User') и нажми Enter эта строка задаёт для программы отдельную папку без пробелов и без русских букв
  3. Закрой все такие окна и открой заново программа начнёт хранить свои данные по новому, простому пути - большинство сценариев после этого работает штатно

Честная граница - это обход, а не официальная настройка, и снимает он не любой сценарий целиком. Если проблема не уходит - самое надёжное решение - завести в Windows второго локального пользователя с именем на латинице и работать из-под него

Как проверить, что всё встало правильно?

Две команды. claude --version печатает номер версии, claude doctor показывает диагностику установки и настроек без запуска самой программы

Финальная проверка

  1. Впечатай claude --version и нажми Enter увидишь номер вида 2.1.211 (Claude Code) - установка на месте
  2. Впечатай claude doctor и нажми Enter увидишь список проверок с подсказками, что чинить, если что-то не так - и без начала самой сессии
  3. Перейди в папку своего проекта и впечатай claude при первом запуске откроется браузер для входа по подписке - дальше можно писать задачу словами прямо в строку

Что делать с этой строкой дальше и как ставить агенту задачи словами - в общем гайде Claude Code: что это и как пользоваться

Рабочая установка печатает номер вида 2.1.211 (Claude Code) - все подписанные версии и способ сверки контрольной суммы файла собраны в разделе Binary integrity официальной документации Claude Code.

Что меняется, когда Windows больше не мешает

Установка снимает только барьер входа. Дальше вопрос уже не «как поставить», а «что собрать первым и как довести до живой ссылки» - если весь путь от установки до первой задачи ещё не проходил, полная версия маршрута - в гайде Claude Code установка из России

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

Больше 5 миллионов подписчиков собрали в сумме ученики, которых я лично провожу через установку Claude Code на их Windows-компьютерах - подробнее пишу об этом в своём Telegram.

15 мин чтения Иван Сергеев

Источники

  • Claude Code Docs, Advanced setup - требования к Windows (сборка 1809, 4 ГБ памяти, x64/ARM64), команды установки для обоих командных окон, цитата про права администратора, платные тарифы. Проверено 21 августа 2026
  • Claude Code Docs, Troubleshoot installation and login - разбор ошибок PATH, политики запуска, TLS, конфликта с Claude Desktop, настройка CLAUDE_CODE_GIT_BASH_PATH
  • Claude Code Docs, Troubleshooting - поиск по файлам на WSL и системный ripgrep через WinGet
  • Microsoft Learn, Install WSL - установка одной командой, требование Windows 10 версии 2004
  • Microsoft Learn, Working across file systems - почему проект для WSL держат внутри Linux
  • nodejs.org, страница загрузки - версия Node.js для установки через npm
  • git-scm.com, страница загрузки Git for Windows
  • GitHub, страница проекта Claude Code - заведённые проблемы с пробелом и русскими буквами в пути профиля, статусы сверены 3 августа 2026

Claude Code на Windows - за один вечер

Восемь пунктов, по которым видно, что агент действительно встал и работает

Сохрани себе

  • Система 64-разрядная, Windows 10 сборка 1809 или новее, память от 4 ГБ
  • Оплачен один из тарифов Claude - Pro, Max, Team, Enterprise или Console
  • Открыто нужное командное окно - строка начинается с PS
  • Выполнена команда установки и получена надпись об успехе
  • Командное окно закрыто и открыто заново, чтобы подхватился путь программы
  • claude --version печатает номер версии, а не ошибку
  • claude doctor не жалуется на установку и файлы настроек
  • В пути %USERPROFILE% нет пробела и русских букв, иначе задана переменная CLAUDE_HOME

Продолжение

Установка бесплатная, путь до продукта - нет

Claude Code снял барьер входа на Windows, и на этом его работа заканчивается: он не решает, что именно строить, и не доводит идею до вещи, за которую готовы платить. Как я закрываю именно этот разрыв, от идеи до готового продукта, руками и по шагам, показываю в закрытом канале, вход кнопкой выше

Забрать путёвку в ИИ-Лагерь

Частые вопросы

Можно ли поставить Claude Code на Windows без прав администратора?

Да. Документация прямо говорит, что запуск установщика от имени администратора не нужен - программа встаёт в папку профиля пользователя. Права администратора нужны только для одной команды включения WSL

Нужен ли Node.js для Claude Code на Windows?

Нет. Родной установщик кладёт уже готовую программу, и она не вызывает Node.js при работе. Node.js версии 22 и новее нужен только тем, кто ставит программу через npm

Что лучше на Windows - обычная установка или WSL?

Обычная установка проще и быстрее ищет по файлам проекта на дисках Windows. WSL 2 нужен, если работаешь с линуксовыми привычками или хочешь изолированный запуск команд - песочница поддерживается только там

Куда именно ставится программа на Windows?

В папку %USERPROFILE%\.local\bin, а временный файл загрузки лежит в %USERPROFILE%\.claude\downloads и удаляется после установки. Эта папка попадает в список путей самой Windows

Почему после установки команда claude не находится?

Почти всегда потому, что окно было открыто до установки и не знает про обновлённый список путей. Закрой окно, открой новое. Не помогло - смотри разбор первой ошибки выше

Работает ли Claude Code на Windows на процессоре ARM?

Да. Установщик сам определяет тип процессора и качает подходящую сборку. Требование то же самое - 64-разрядная система

Что делать, если `Git for Windows` стоит, а Claude Code его не находит?

Указать путь к программе явно, вставкой в файл настроек settings.json - строка CLAUDE_CODE_GIT_BASH_PATH с полным путём до файла bash.exe