Как установить Claude Code на Windows 10 и 11: команда, проверка, ошибки

Обновлено 10 минут чтения

Чтобы установить Claude Code на Windows, открой PowerShell и выполни одну команду: irm https://claude.ai/install.ps1 | iex. Права администратора не нужны, Node.js не нужен, Git for Windows можно поставить позже. Ниже весь путь по официальной документации на 15 октября 2026 года: что проверить до установки, команды для PowerShell и CMD, первый запуск и разбор ошибок, на которых застревают чаще всего.

Если тебе нужно просто понять, где скачать Claude Code под Mac, Linux или телефон, для этого есть отдельная карта загрузок. Здесь только Windows.

Что нужно перед установкой

Требования у Claude Code скромные:

  • Windows 10 версии 1809 или новее, либо Windows Server 2019 и новее
  • 4 ГБ оперативной памяти и больше, процессор x64 или ARM64
  • интернет: модель работает на серверах Anthropic, не на твоём компьютере
  • PowerShell или CMD, они уже есть в системе
  • платный тариф и страна из списка поддерживаемых, об этом ниже

Чего для установки не нужно, хотя старые гайды пишут обратное.

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

Git for Windows по желанию. В системных требованиях Claude Code его нет. Документация рекомендует поставить его на нативной Windows по одной причине: Git for Windows даёт Git Bash, через который работает инструмент Bash. Без Git for Windows команды выполняет инструмент PowerShell. Сам git нужен тебе только для git-операций — коммитов, веток, истории. Ставится обычным установщиком: git-scm.com/downloads/win (откроется в новой вкладке), настройки по умолчанию, потом новый терминал.

А вот два требования, без которых установка не имеет смысла.

Нужен платный тариф. Бесплатный план claude.ai не даёт доступа к Claude Code. Подойдёт Pro, Max, Team, Enterprise или аккаунт Console. Pro стоит $20 при помесячной оплате или $17 в месяц при годовой ($200 сразу за год), остальные тарифы разобраны в статье про цены Claude Code.

Страна должна быть в списке поддерживаемых. Это формальное требование из документации, и для России оно важно. Подробнее ниже, в разделе про установку из России.

Как установить Claude Code на Windows одной командой

Открой PowerShell: нажми Пуск, набери «PowerShell» и запусти пункт «Windows PowerShell», не от администратора. Пункт с пометкой «(x86)» не подходит: это 32-битный процесс, и установщик ответит Claude Code does not support 32-bit Windows даже на 64-битной системе — эта ошибка и её разбор есть в документации Anthropic по ошибкам установки (откроется в новой вкладке). Строка приглашения начинается с PS C:\Users\ТвоёИмя>. Вставь команду:

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

Если ты в CMD (приглашение без PS в начале), команда другая:

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

Перепутать их легко, и тогда Windows ответит ошибкой. 'irm' не является внутренней или внешней командой означает, что ты в CMD, а команда для PowerShell. Подробный разбор этой ошибки лежит в отдельной статье про irm. Обратная ситуация: The token '&&' is not a valid statement separator означает, что CMD-команду вставили в PowerShell. На русской Windows текст ошибки будет переведён, но смысл тот же: речь о разделителе &&.

Установщик кладёт программу в %USERPROFILE%\.local\bin\claude.exe. Нативная установка обновляется сама в фоне, следить за версиями не придётся.

WinGet и npm: когда они нужны

Нативный установщик Anthropic называет рекомендуемым. Два других способа работают, но у каждого свой нюанс.

WinGet удобен, если ты ставишь всё через менеджер пакетов:

winget install Anthropic.ClaudeCode

Такая установка не обновляется сама. Периодически запускай winget upgrade Anthropic.ClaudeCode. Можно поручить обновление самому Claude Code: задай переменную окружения и открой новый терминал.

setx CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 1

Тогда Claude Code сам запустит обновление через WinGet, когда выйдет новая версия. Оно может не пройти, пока Claude Code запущен: Windows блокирует файл claude.exe. В этом случае Claude Code покажет команду для ручного обновления.

npm остался запасным путём:

npm install -g @anthropic-ai/claude-code

Для установки через npm нужен Node.js 22 или новее. На старом Node npm выдаст предупреждение EBADENGINE, но установка завершится: пакет всё равно скачивает ту же нативную программу, которой Node для работы не нужен. Обновлять npm-версию нужно командой npm install -g @anthropic-ai/claude-code@latest.

Если у тебя стоит старая npm-версия и хочешь перейти на нативную, поставь нативную командой из предыдущего раздела, затем удали пакет: npm uninstall -g @anthropic-ai/claude-code.

Первый запуск и проверка

Закрой терминал и открой новый: только так он увидит обновлённый PATH. Проверь версию:

claude --version

Если напечатался номер версии, программа на месте. Дальше перейди в папку проекта и запусти Claude Code:

cd C:\Users\ТвоёИмя\projects\my-site
claude

При первом запуске откроется браузер со входом в аккаунт Claude. После подтверждения терминал напишет Login successful и попросит нажать Enter. Если вместо возврата в терминал браузер показал код, вставь его в строку Paste code here if prompted. Вход сохраняется, но у него есть срок. За три дня до окончания Claude Code при запуске предупредит: Your login expires in 3 days · run /login to renew. Команда /login внутри сессии продлит вход.

Для подробной проверки есть команда:

claude doctor

Она ничего не запускает и не меняет, а только показывает состояние установки, ошибки в файлах настроек и предупреждения с подсказками, как их исправить. С неё я начинаю любой разбор, когда что-то пошло не так.

Частые ошибки при установке на Windows

«claude не является внутренней или внешней командой»

Программа установилась, но папка %USERPROFILE%\.local\bin не попала в PATH. Сначала проверь, что файл есть:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Если ответ True, добавь папку в пользовательский PATH одной командой в PowerShell:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Потом закрой все окна терминала и открой новое. То же можно сделать мышкой: Win + R, sysdm.cpl, «Дополнительно», «Переменные среды», в пользовательской переменной Path добавь %USERPROFILE%\.local\bin.

Учти: если ты ставил только расширение для VS Code, claude в терминале не появится. Расширение держит свою копию программы и в PATH её не добавляет, для терминала нужна обычная установка.

«Выполнение сценариев отключено в этой системе»

Многие инструкции советуют менять политику выполнения перед установкой. На нативный установщик она не влияет: команда irm … | iex выполняет скачанный текст напрямую, а политика касается файлов-скриптов.

Эта ошибка появляется при установке через npm, когда PowerShell блокирует npm.ps1 или claude.ps1. Три выхода: разрешить локальные скрипты для своего пользователя командой Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser, вызывать npm.cmd и claude.cmd вместо них или перейти на нативный установщик.

Claude Code не находит Git Bash

Если Git for Windows стоит, а Claude Code его не видит, укажи путь в файле настроек %USERPROFILE%\.claude\settings.json:

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

Путь подставь свой, если ставил Git не в стандартную папку.

Команда печатает HTML или отвечает 403

Вместо скрипта установки пришла веб-страница или ошибка 403. Обычно это прокси, корпоративный фильтр или ограничение по стране. Если на странице написано «App unavailable in region», Claude Code недоступен в твоей стране.

Как установить Claude Code на Windows в России

Россия не входит в список стран, где работает Anthropic (откроется в новой вкладке), а документация называет нахождение в поддерживаемой стране одним из системных требований. Поэтому из России установщик может вернуть ту самую ошибку 403 или страницу «App unavailable in region», хотя команда набрана правильно.

Что говорит документация про эту ошибку: 403 обычно дают прокси, сетевой фильтр или страна, где Claude Code недоступен. Если в ответе страница «App unavailable in region», дело именно в стране, и документация отправляет к списку поддерживаемых стран. Обходного пути на такой случай в ней нет. Если же страницы с регионом нет, а ты за корпоративным прокси, задай в PowerShell адрес прокси и запусти установщик в том же окне:

$env:HTTP_PROXY = 'http://proxy.example.com:8080'
$env:HTTPS_PROXY = 'http://proxy.example.com:8080'
irm https://claude.ai/install.ps1 | iex

Вместо proxy.example.com:8080 подставь адрес своего прокси, его знает администратор сети. Переменные действуют только в этом окне PowerShell и после его закрытия исчезнут.

Зарубежный VPS не делает использование из России поддерживаемым: политика Anthropic (откроется в новой вкладке) прямо относит к неподдерживаемому использованию работу человека, который физически находится в неподдерживаемом регионе. Вопросы доступа к Claude Code и оплаты из России я разобрал в гайде про Claude Code в России. Все способы оплаты собраны на странице оплаты.

Устанавливай только официальной командой

Если тебе попалась команда вида curl ... | bash с незнакомым доменом, остановись. Такая команда выполняет на твоём компьютере всё, что пришлёт сервер. В PowerShell и CMD она обычно падает с ошибкой, а вот в Git Bash и WSL выполнится, и там она так же опасна. Для PowerShell правило то же: irm ... | iex запускай, только если адрес начинается с https://claude.ai/.

Официальные источники для Windows:

Если в инструкции другой домен, не запускай её, а сверь с документацией Claude Code (откроется в новой вкладке).

Claude Desktop: без терминала

Если командная строка не твоё, есть Claude Desktop с вкладкой Code. Это тот же Claude Code, только с окном вместо терминала. На вкладке Code выбираешь окружение Local, указываешь папку проекта, и Claude читает файлы, вносит правки и запускает команды на твоём компьютере. Правки показываются как дифф, их можно принять или отклонить.

Установщик для Windows x64 и отдельный для ARM64 есть на claude.com/download (откроется в новой вкладке). Для вкладки Code нужна подписка Pro, Max, Team или Enterprise. Аккаунта Console, с которым работает CLI, в этом списке нет.

WSL: когда он нужен

Claude Code можно запустить и внутри WSL. Тогда ставишь его Linux-командой уже в терминале дистрибутива:

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

Git for Windows для WSL не нужен. Главная причина выбрать WSL 2: там поддерживается песочница для команд (sandboxing), а на нативной Windows её нет. Ещё WSL удобен, если проект живёт в Linux-инструментах. Для обычной работы с Windows-проектами хватает нативной установки.

Что сделать после установки

Первым делом создай в корне проекта файл CLAUDE.md со стеком, командами сборки и тестов и правилами проекта. Проще всего набрать в сессии /init: Claude изучит код и сам соберёт черновик файла, а ты допишешь то, чего он не увидит. Claude Code читает этот файл как постоянные инструкции, и тебе не придётся повторять одно и то же в каждой сессии. Как его составить, я разобрал в статье про CLAUDE.md.

Вторым шагом поставь пару скиллов под свои задачи. Если пишешь код, начни с Ревьюера кода для проверки изменений перед коммитом и Мастера отладки для разбора ошибок и трассировок. Для установки самого Claude Code эти скиллы не нужны.

Каждый скилл ставится своей строкой из блока ниже. Это установщик каталога claudeskills.ru, не установщик Claude Code от Anthropic. Перед запуском прочитай инструкцию на странице скилла и скрипт по адресу из команды.

Команды для Bash. На Windows открой Git Bash, если он установлен; в PowerShell и CMD этот блок не запускай. Если Git Bash нет, нажми «Скачать» на странице скилла и распакуй архив в папку %USERPROFILE%\.claude\skills\ так, чтобы файл лежал по пути %USERPROFILE%\.claude\skills\<имя-скилла>\SKILL.md. Если работаешь в WSL, выполняй команды внутри той же среды, где запускаешь Claude Code.

curl -sL https://claudeskills.ru/install/code-reviewer | bash
curl -sL https://claudeskills.ru/install/debugging-wizard | bash

Установщик кладёт файлы в ~/.claude/skills/ текущей среды. После установки перезапусти Claude Code. Где брать другие скиллы и как их ставить, рассказано в статье про каталоги скиллов, а всё наше собрано в каталоге.

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

Claude Code работает на Windows 10 или только на 11? На обеих. Минимум Windows 10 версии 1809, для серверов Windows Server 2019.

Нужен ли Node.js? Нет, если ставишь нативным установщиком или через WinGet. Только для установки через npm нужен Node.js 22 или новее.

Обязательно ли ставить Git? Нет, в требованиях Claude Code его нет. Git for Windows нужен ради Git Bash, через который работает инструмент Bash; без него команды выполняет инструмент PowerShell. Сам git понадобится только для git-операций: коммитов, веток, истории.

Можно ли пользоваться бесплатно? Нет. Бесплатный план claude.ai не включает Claude Code, нужен Pro или выше либо аккаунт Console.

Как обновить Claude Code на Windows? Нативная установка обновляется сама, а обновиться сразу можно командой claude update. Для WinGet запусти winget upgrade Anthropic.ClaudeCode, для npm npm install -g @anthropic-ai/claude-code@latest.

Что поставить первым

Скиллы ставятся на компьютере, на телефоне Claude Code не запускается. Отправьте себе ссылку на этот список.

  1. Разработка
    Ревьюер кода

    Для ревью pull request, проверки качества кода и поиска уязвимостей.

    code-reviewer · Jeffallan

  2. Разработка
    Мастер отладки

    Для разбора ошибок, трассировки стека и поиска причин сбоев.

    debugging-wizard · Jeffallan

  3. Разработка
    Мастер системной отладки

    Ищет первопричину ошибки или падения теста до того, как предлагать исправление.

    systematic-debugging · obra

«Мастер системной отладки»: близко к «Мастер отладки».

Что нужно: компьютер и Claude Code — он работает с подпиской Claude Pro и выше, на бесплатном плане его нет. Как поставить Claude Code →

Читать дальше