Как установить Claude Code на Windows: пошаговая инструкция

Если пользователю Windows нужен один рабочий способ поставить Claude Code — это PowerShell: откройте его (не CMD) и выполните irm https://claude.ai/install.ps1 | iex, прав администратора не нужно. Если проект и так живёт в Linux-окружении или нужна песочница для команд — ставьте через WSL 2. Тем, кто не хочет разбираться с терминалом, подойдёт десктоп-приложение или расширение для VS Code — команды те же самые, только через графический интерфейс. Что такое Claude Code и как им пользоваться после установки — в общем руководстве для новичка; здесь — только про установку на Windows: варианты, команды, вход, оплата и разбор ошибок, которые встречаются именно на этой системе.

Способы установки на Windows: что выбрать

Способ	Команда	Кому подходит
Нативный установщик, PowerShell (рекомендуется)	irm https://claude.ai/install.ps1 | iex	Большинству: работает из коробки, сам обновляется в фоне
Нативный установщик, CMD	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd	Тем, кто по привычке или из-за политик работает в CMD, а не в PowerShell
WinGet	winget install Anthropic.ClaudeCode	Тем, кто ставит и обновляет программы через встроенный менеджер пакетов Windows
WSL 2 (или WSL 1)	curl -fsSL https://claude.ai/install.sh | bash — внутри дистрибутива WSL	Linux-проектам и тем, кому нужна песочница для выполнения команд (доступна только в WSL 2)
Десктоп-приложение	Установщик с claude.com/download	Тем, кто не хочет работать в терминале: параллельные сессии, просмотр диффов, встроенный терминал и редактор
Расширение VS Code	Поиск «Claude Code» в Extensions (Ctrl+Shift+X)	Тем, кто уже работает в VS Code и хочет Claude прямо в редакторе, без отдельного окна терминала

Ставить Claude Code через npm на Windows не рекомендуется: политика выполнения PowerShell часто блокирует .ps1-скрипт, который создаёт npm (разбор ошибки — ниже). Команда для тех, у кого уже настроен Node.js 22+: npm install -g @anthropic-ai/claude-code, но в остальных случаях используйте нативный установщик.

Что нужно заранее

• Система. Windows 10 версии 1809 и новее или Windows Server 2019 и новее, 64-разрядная (32-битная Windows не поддерживается).
• Железо. От 4 ГБ оперативной памяти, процессор x64 или ARM64.
• Интернет и один из терминалов: PowerShell или CMD (для нативной установки и WSL нужен ещё и Bash внутри дистрибутива).
• Аккаунт. Подписка Claude Pro, Max, Team или Enterprise либо аккаунт Claude Console с оплаченным балансом API — без этого войти в Claude Code не получится.
• Git for Windows — по желанию, не обязателен. Если он стоит, Claude Code выполняет команды через Git Bash (инструмент Bash); если его нет — через встроенный инструмент PowerShell. На функциональность агента это не влияет, разница только в том, каким шеллом он пользуется под капотом. Поставить можно с git-scm.com/downloads/win, при установке отметьте «Add to PATH».

Подробности — в разделе про вход и оплату ниже.

Установка в PowerShell (нативный способ)

1. Откройте PowerShell — не путайте с CMD: строка приглашения в PowerShell начинается с PS C:\, в CMD — без PS. Найти его можно через поиск в меню «Пуск», это должен быть пункт «Windows PowerShell», а не «Windows PowerShell (x86)» — 32-битная версия ставить Claude Code не даёт.
2. Выполните команду:

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

   Права администратора не нужны.
3. После завершения откройте новое окно терминала (в уже открытом PATH не обновится) и проверьте установку:

   claude --version

   Команда должна вывести номер версии с пометкой «(Claude Code)», например 2.1.211 (Claude Code).

Нативная установка обновляется в фоне сама — отдельно запускать обновление не нужно. Проверить состояние можно командой claude doctor: она выводит диагностику установки и настроек, ничего не запуская и не меняя.

Установка в CMD

Если рабочий терминал — классическая командная строка, команда для PowerShell не подойдёт: curl в PowerShell — это алиас на Invoke-WebRequest, который не понимает флаги вроде -fsSL. Для CMD своя команда:

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

Она скачивает установочный файл, запускает его и удаляет за собой. Дальше — так же: новое окно терминала и claude --version для проверки.

Установка через WinGet

winget install Anthropic.ClaudeCode

В отличие от нативного установщика, WinGet-версия не обновляется автоматически — периодически обновляйте вручную:

winget upgrade Anthropic.ClaudeCode

Установка внутри WSL 2

WSL 2 стоит выбрать, если проект использует Linux-инструменты или нужна песочница для выполнения команд — на Windows напрямую она не поддерживается, только внутри WSL 2 (в WSL 1 — тоже нет). Ставить и запускать Claude Code нужно из терминала самого дистрибутива, а не из PowerShell или CMD:

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

Это та же команда, что для Linux и macOS — WSL Claude Code воспринимает как обычный Linux. Git for Windows для WSL не нужен.

Два нюанса именно для WSL: во-первых, поиск по файлам может находить меньше результатов на медленных дисках — если проект лежит на /mnt/c/ (файловая система Windows), лучше перенести его на /home/ (файловая система Linux) или уточнять запросы («найди JWT-валидацию в пакете auth-service» вместо общего поиска). Во-вторых, если при первом входе не открывается браузер для авторизации, укажите путь к браузеру Windows вручную:

export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
claude

Десктоп-приложение и расширение VS Code

Не хотите работать в терминале — у Claude Code есть графические варианты:

• Десктоп-приложение для Windows (x64 и ARM64) — скачивается с claude.com/download. После установки войдите и откройте вкладку «Code»: там можно вести несколько сессий параллельно, каждая — в своей папке проекта, со встроенным терминалом, редактором файлов и просмотром диффов.
• Расширение для VS Code — откройте вкладку расширений (Ctrl+Shift+X), найдите «Claude Code» и нажмите «Install». Нужен VS Code версии 1.94.0 или новее. Для входа подходит любая платная подписка Claude — Pro, Max, Team или Enterprise, отдельный API-ключ не требуется. Внутри VS Code можно и запустить обычный claude в интегрированном терминале (Ctrl+`) — он сам подхватит интеграцию с редактором: просмотр диффов и общие диагностики.

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

Вход в аккаунт и оплата

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

cd путь\к\проекту
claude

При первом запуске откроется браузер — выберите способ, которым оплачен доступ: подписка Claude (Pro, Max, Team, Enterprise) или аккаунт Claude Console с предоплаченным балансом API. Данные входа сохраняются, повторно логиниться не нужно; сменить аккаунт можно командой /login внутри сессии. Если задана переменная окружения ANTHROPIC_API_KEY, Claude Code вместо браузера один раз предложит подтвердить использование этого ключа.

Отдельно Claude Code не продаётся — он входит в подписку. На claude.com/pricing на момент подготовки статьи актуальны такие условия:

• Pro — $20 в месяц при помесячной оплате или $17 в месяц при оплате за год; включает Claude Code.
• Max — от $100 в месяц, лимиты в 5 или 20 раз больше, чем у Pro; Claude Code включён.
• Team и Enterprise — Claude Code включён в тариф.
• Free (бесплатный тариф claude.ai) — Claude Code не включён вообще.

Альтернатива подписке — аккаунт Claude Console с оплатой по фактическому расходу токенов через API.

Если вы в России: официально Anthropic с российскими пользователями не работает, страна не входит в список поддерживаемых, и оплатить подписку российской картой нельзя — только зарубежной. Разобранные рабочие способы оплаты — в статье как оплатить Claude из России без зарубежной карты.

Частые ошибки на Windows

Большинство ошибок при установке на Windows — из-за путаницы между PowerShell и CMD или из-за PATH, который обновляется только в новых окнах терминала.

• 'irm' is not recognized as an internal or external command. Вы в CMD, а команда — для PowerShell. Откройте PowerShell (не x86) и выполните irm https://claude.ai/install.ps1 | iex, либо возьмите отдельную команду для CMD из раздела выше.
• The token '&&' is not a valid statement separator. Обратная ситуация: вы в PowerShell выполняете команду для CMD. Используйте команду PowerShell: irm https://claude.ai/install.ps1 | iex.
• A parameter cannot be found that matches parameter name 'fsSL'. Вы запустили в PowerShell команду для macOS/Linux (curl -fsSL ... | bash) — в PowerShell curl это алиас Invoke-WebRequest, который не понимает такие флаги. Нужна именно команда irm https://claude.ai/install.ps1 | iex.
• claude не распознаётся после установки (PATH не обновился). Откройте новое окно терминала — PATH подхватывается только в новых сессиях. Если не помогло, проверьте PATH в PowerShell командой $env:PATH -split ';' | Select-String '\.local\\bin'; если пусто — добавьте вручную:

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

  и перезапустите терминал.
• Claude Code does not support 32-bit Windows. В меню «Пуск» есть два PowerShell: «Windows PowerShell» и «Windows PowerShell (x86)» — второй запускается как 32-битный процесс и выдаёт эту ошибку даже на 64-битной машине. Проверьте командой [Environment]::Is64BitOperatingSystem: если она вернула True, закройте окно, откройте обычный «Windows PowerShell» (без x86) и запустите установку заново.
• running scripts is disabled on this system при установке через npm. Политика выполнения PowerShell блокирует .ps1-скрипты, которые создаёт npm. Проще всего перейти на нативный установщик (irm https://claude.ai/install.ps1 | iex) — он ставит бинарник, а не скрипт. Если нужен именно npm, разрешите локальные скрипты для своего пользователя: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
• The process cannot access the file ... because it is being used by another process при установке. Установщик не может записать файл в папку %USERPROFILE%\.claude\downloads — обычно потому, что там ещё выполняется предыдущая попытка установки или антивирус сканирует недокачанный файл. Закройте лишние окна PowerShell, подождите антивирус, затем удалите папку и попробуйте снова:

  Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
  irm https://claude.ai/install.ps1 | iex

• Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Не найден ни Git Bash, ни PowerShell. Если PowerShell не в PATH — добавьте C:\Windows\System32\WindowsPowerShell\v1.0\ или поставьте PowerShell 7. Для Bash поставьте Git for Windows с «Add to PATH»; если Git уже стоит, но не находится, укажите путь явно в settings.json: "env": {"CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"}.
• 'claude' is not recognized сразу после обновления. Обновление переименовывает старый claude.exe в резервную копию и подставляет новый; если это не удалось, рабочего файла не остаётся. Верните резервную копию:

  Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe

  Нет такого файла — переустановите командой irm https://claude.ai/install.ps1 | iex.
• Вход не срабатывает внутри WSL2. Редирект браузера не долетает до Claude Code, вместо автоматического входа появится код для ручной вставки. Задайте BROWSER с путём к браузеру Windows (пример — в разделе про WSL) или нажмите c в приглашении входа, чтобы скопировать ссылку и открыть вручную.

Первые шаги после установки

Дальше — одинаково для всех способов установки: зайдите в папку проекта, наберите claude, при первом запуске войдите через браузер. Первая полезная команда внутри сессии — /init: Claude изучит проект и создаст файл CLAUDE.md с инструкциями на будущее. Подробный разбор первой сессии, режимов разрешений и полезных команд — в общем руководстве по Claude Code. Если вы только выбираете инструмент для программирования с ИИ, а не конкретно Claude Code, — сравнение вариантов есть в статье лучшая нейросеть для программирования; а если раньше не программировали вообще — начните со статьи вайб-кодинг: что это и с чего начать.

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

Какая команда для установки Claude Code на Windows правильная?

Для PowerShell — irm https://claude.ai/install.ps1 | iex. Для CMD — другая: curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd. Если запустить команду не того терминала, PowerShell и CMD выдадут разные ошибки — они разобраны в разделе про частые ошибки.

Нужны ли права администратора?

Нет, ни для PowerShell, ни для CMD, ни для WinGet-установки. Установка идёт в папку профиля пользователя (%USERPROFILE%), которая доступна на запись по умолчанию.

Обязательно ли ставить Git for Windows?

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

Что лучше — ставить нативно на Windows или через WSL?

Нативная установка подходит для Windows-проектов и не требует настройки WSL. WSL 2 стоит выбрать, если проект использует Linux-инструментарий или нужна песочница для выполнения команд — на Windows напрямую она не поддерживается. WSL 1 работает, но без песочницы, и это запасной вариант, если WSL 2 недоступен.

Есть ли бесплатный доступ к Claude Code на Windows?

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

Работает ли Claude Code на Windows из России?

Технически поставить программу можно — блокировок на уровне скачивания нет. Но Anthropic официально не работает с российскими пользователями, и оплатить подписку российской картой нельзя, нужна зарубежная. Рабочие способы оплаты — в статье про оплату Claude из России.

Чем расширение VS Code отличается от установки в терминале?

Это один и тот же Claude Code, но расширение работает прямо в редакторе — с просмотром изменений во вкладках и без отдельного окна терминала. Можно поставить оба варианта: расширение для повседневной работы в VS Code и консольную версию — если понадобится запустить Claude Code вне редактора, например в CI.