Claude Code на Windows

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

Коротко: открой PowerShell, вставь строку irm https://claude.ai/install.ps1 | iex и нажми Enter. Потом открой новое окно, проверь claude --version и запусти claude, чтобы войти. Права администратора, Git и WSL для этого не нужны.

Как установить Claude Code на Windows: одной командой в PowerShell или CMD, дальше программа обновляется сама. Ниже - подробности по шагам и разбор того, что может пойти не так.

Оговорюсь сразу: мой рабочий компьютер - Мак, там стоит версия 2.1.278, а через установку на Windows своими руками я не проходил. Поэтому каждая команда здесь проверена по документации Anthropic и открытому трекеру проекта, сверка шла 21 сентября 2026 года.

Claude Code - ИИ-агент: читает файлы проекта, запускает команды и вносит правки (подробно - в отдельной статье). Здесь только Windows, установка на Mac и Linux - в общей инструкции.

Установка - только вход в работу. Настройки, с которыми агент не дёргает тебя по пустякам и не лезет в опасные команды, я держу в ClaudeBase рядом с правилами проекта.

Где ты сейчас

Коротко: четыре типичные точки старта. Найди свою и переходи к нужному разделу, остальное можно пролистать.

• Ещё ничего не ставил. Начни с проверки системы и иди по шагам.
• Команда отработала, а claude не находится. Прыгай к разделу про PATH.
• Установщик выдал красную строку. Раздел про ошибки: их заголовки совпадают с тем, что пишет PowerShell.
• Командная строка пугает. Есть приложение Claude для Windows, о нём в вопросах внизу. Решишься на окно команд - начни с разбора работы в терминале.

Что проверить в Windows заранее?

Коротко: Windows 10 версии 1809 или новее, 64-битная система, от 4 ГБ оперативной памяти и платный аккаунт. Права администратора не нужны, а с бесплатным планом агент работать не станет.

Версию Windows, память и разрядность Microsoft советует смотреть так: правый клик по кнопке «Пуск», «Параметры», «Система» и пункт со сведениями о системе.

Подойдёт подписка Pro, Max, Team или Enterprise либо аккаунт Console с кредитами, оплаченными заранее. С бесплатным claude.ai войти не выйдет. Тариф под свою нагрузку подберёшь по статье про лимиты.

Я сам плачу за Claude картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить карту

Реклама. ООО «КАПИБАРА», ИНН 9703231520. erid: 2W5zFGnh2G9

Если установщик вместо скрипта получает страницу «App unavailable in region», дело в стране, Windows тут ни при чём. Вход из России разобран в статье про Claude Code в России, оплата - в отдельном разборе.

Права администратора не нужны: программа ложится в папку твоего пользователя, %USERPROFILE%\.local\bin\claude.exe.

Нужен ли Git for Windows?

Коротко: для старта нет. С версии 2.1.120 Claude Code обходится без Git: если Git Bash нет, агент выполняет команды через PowerShell. Git for Windows стоит поставить, когда проекту или скиллу нужен bash.

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

Error: Claude Code on Windows requires git-bash (https://git-scm.com/downloads/win). If installed but not in PATH, set environment variable pointing to your bash.exe, similar to: CLAUDE_CODE_GIT_BASH_PATH=C:\Program Files\Git\bin\bash.exe

В версии 2.1.120 требование сняли, а документация ещё какое-то время его повторяла, об этом в трекере есть обращение #53068. Сейчас в разделе про Windows сказано так:

Installing Git for Windows is optional. It enables the Bash tool by providing Git Bash.

«Ставить Git for Windows необязательно. Он включает инструмент Bash, потому что приносит с собой Git Bash.»

• Anthropic, Advanced setup

Без Git агент работает через PowerShell. С Git у него появляется ещё и bash, а с ним скрипты и инструменты, написанные под bash. Я бы ставил Git сразу, если проект уже хранится в Git или нужны скиллы, которые просят bash. Скачивается он со страницы проекта, настройки установщика можно не трогать.

Если Git стоит, а программа его не находит, путь к bash.exe прописывают в файле %USERPROFILE%\.claude\settings.json. Где лежит Git у тебя, покажет where.exe git.

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

Шаг 1. Как открыть PowerShell и не перепутать его с CMD?

Коротко: нажми Win + X и выбери Windows PowerShell или Терминал. В начале строки PowerShell стоит PS, у CMD его нет. Пункт с пометкой x86 не открывай, он даёт ошибку про 32 бита.

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

PS C:\Users\ИмяПользователя>    это PowerShell
C:\Users\ИмяПользователя>       это CMD

В меню «Пуск» есть ещё пункт Windows PowerShell (x86). Это 32-битная версия, и установщик в ней отказывается работать даже на 64-битном компьютере.

Шаг 2. Какую команду вставить?

Коротко: в PowerShell - irm https://claude.ai/install.ps1 | iex, в CMD - строка с curl из той же документации. Установщик кладёт программу в папку пользователя и дальше обновляет её сам.

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

irm скачивает официальный установщик, вертикальная черта передаёт его дальше, а iex (полное имя Invoke-Expression) выполняет. В конце появится строка Claude Code successfully installed!.

Для CMD команда своя:

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

Она сохраняет установщик в файл, запускает его и удаляет.

Запасных способов два, и оба я бы оставил на крайний случай:

1. WinGet: winget install Anthropic.ClaudeCode. Подходит, если скрипт не скачивается, но сам не обновляется, придётся время от времени запускать winget upgrade Anthropic.ClaudeCode.
2. npm - для тех, у кого уже стоит Node.js версии 22 и новее. В PowerShell такая установка может упереться в запрет скриптов, эта ошибка разобрана ниже.

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

Шаг 3. Встала ли программа?

Коротко: открой новое окно и выполни claude --version. Номер версии и Claude Code в скобках значат, что программа на месте. Подробнее покажет claude doctor, и она ничего не меняет.

Окно нужно именно новое: старое помнит прежний список путей.

claude --version

У меня на Маке ответ такой. На Windows вид строки тот же, только номер будет свежее.

2.1.278 (Claude Code)

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

claude doctor

claude doctor показывает, как установлена программа, нет ли ошибок в файлах настроек и чем кончилось последнее обновление. Сессию она не запускает и ничего не правит. Чинить найденное умеет команда /doctor внутри запущенной сессии.

Шаг 4. Как войти и дать первую задачу?

Коротко: перейди в папку проекта, набери claude и войди через браузер. Если браузер не открылся, нажми c: ссылка скопируется, и её можно вставить в браузер руками.

Claude Code работает с той папкой, из которой его запустили, так что удобнее сразу завести отдельную:

New-Item -ItemType Directory -Path C:\projects\first
cd C:\projects\first
claude

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

claude auth login

Сменить аккаунт можно командой /login внутри сессии.

Первую задачу пиши обычным языком, как коллеге: «что делает этот проект?». Остановить агента - клавиша Esc, выйти - exit. Экран сессии и первые запросы подробно разобраны в статье про терминал, возможности агента - в большом гайде.

Когда агент ответил. Как обустроить ему рабочее место, разбирает урок курса «Рабочее окружение: правила проекта и разрешения»: из чего состоит проект агента и чем настройки отличаются от правил. Рядом материал «Настройки Claude Code, Codex и VS Code», он про работу без лишних вопросов и закрытые опасные команды. Уроки выходят по мере записи, открываются они с доступом к ClaudeBase.

Когда вместо нативной установки брать WSL?

Коротко: когда нужны Linux-инструменты или песочница для команд агента. На нативной Windows песочницы нет, в WSL 2 она работает. Для первого знакомства WSL не нужен.

WSL позволяет запускать Linux прямо в Windows, без отдельной виртуальной машины. Документация сравнивает варианты так:

Песочница ограничивает, какие файлы агент может трогать и куда ходить в сеть. По документации она работает на macOS, Linux и WSL2, на нативной Windows - нет.

В PowerShell с правами администратора:

wsl --install

По описанию Microsoft команда включает нужные компоненты и ставит Ubuntu, потом компьютер надо перезагрузить. Нужна Windows 10 версии 2004 (сборка 19041) и новее или Windows 11. Внутри Ubuntu ставится версия для Linux:

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

Запускать claude тоже нужно внутри WSL. Проект держи в домашней папке Linux, /home/...: через /mnt/c/ поиск по файлам медленнее и находит меньше. На WSL 1 запуск может кончиться ошибкой cannot execute binary file: Exec format error, тогда дистрибутив переводят на WSL 2 командой wsl --set-version <имя> 2.

Что делать, если Windows пишет, что claude не распознан?

Коротко: папки с программой нет в PATH, либо окно терминала открыто ещё до установки. Открой новое окно. Не помогло - допиши папку %USERPROFILE%.local\bin в PATH своего пользователя.

PATH - переменная со списком папок: набираешь имя программы, и Windows ищет её только там. Если папка с claude.exe туда не попала, PowerShell отвечает так:

claude : The term 'claude' is not recognized as the name of a cmdlet

В CMD ошибка звучит иначе: 'claude' is not recognized as an internal or external command.

1. Закрой все окна терминала и открой новое.
2. Проверь, есть ли папка в PATH:

$env:PATH -split ';' | Select-String '\.local\\bin'

3. Если ответ пустой, допиши её в переменную своего пользователя:

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

4. Снова открой новое окно и выполни claude --version.

Мышкой то же делается в окне «Переменные среды»: в переменную Path пользователя добавляется %USERPROFILE%\.local\bin.

Если и это не помогло, проверь три вещи:

• Установок две. where.exe claude покажет все найденные программы. Оставь одну, лучше из папки .local\bin.
• Старое приложение Claude. Его старые версии могут зарегистрировать свой Claude.exe, и тогда по команде claude открывается приложение. Помогает обновление приложения.
• Стоит только расширение VS Code. В расширении своя копия программы, в PATH она не попадает, и для терминала нужна отдельная установка. Про расширение есть своя статья.

И один открытый баг: в обращении #83569 описан случай, когда установщик записал в PATH путь без двоеточия, C\Users\... вместо C:\Users\.... Увидишь такую строку - исправь её руками.

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

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

‘irm’ is not recognized as an internal or external command

Ты в CMD. Открой PowerShell или возьми команду для CMD из второго шага.

The token ‘&&’ is not a valid statement separator

Окно PowerShell, а вставлена команда для CMD. Нужна строка с irm.

A parameter cannot be found that matches parameter name ‘fsSL’

В Windows PowerShell вставили команду для Mac и Linux. Там curl - другое имя Invoke-WebRequest, и её ключей он не понимает. Нужна строка с irm.

Claude Code does not support 32-bit Windows

На 64-битном компьютере так отвечает окно Windows PowerShell (x86). Проверь систему в том же окне:

[Environment]::Is64BitOperatingSystem

True - закрой окно и открой PowerShell без x86. False - Windows 32-битная, и агент на ней не запустится.

Claude Code on Windows requires either Git for Windows (for bash) or PowerShell

Программа не нашла ни PowerShell, ни Git Bash. Верни в PATH папку C:\Windows\System32\WindowsPowerShell\v1.0\, поставь PowerShell 7 или Git for Windows с отметкой «Add to PATH».

running scripts is disabled on this system

Бывает при установке через npm: политика выполнения PowerShell не пускает файлы .ps1, которые npm создаёт для своих команд. На irm ... | iex она не действует. Выходы по документации: разрешить скрипты своему пользователю, вызывать npm.cmd и claude.cmd или перейти на официальный установщик.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

The process cannot access the file … because it is being used by another process

Установщик не может записать в папку %USERPROFILE%\.claude\downloads: идёт прошлая попытка установки или файл держит антивирус. Закрой лишние окна, подожди и повтори:

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

Could not establish trust relationship for the SSL/TLS secure channel

Не установилось защищённое соединение. На старых сборках Windows 10 помогает включить TLS 1.2 перед установкой:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
irm https://claude.ai/install.ps1 | iex

App unavailable in region

Вместо скрипта пришла веб-страница, и PowerShell выдаёт ошибки разбора с кусками HTML. Агент недоступен в стране подключения, это вопрос сети: разбор - в статье про установку из России.

Как обновить и удалить Claude Code на Windows?

Коротко: после установки через PowerShell или CMD обновления приходят сами, а claude update ставит их сразу. Установку через WinGet обновляет winget upgrade. Удаление - две команды.

Обновление скачивается в фоне и включается при следующем запуске. Перед winget upgrade Anthropic.ClaudeCode программу лучше закрыть: запущенный файл Windows может не дать заменить.

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Установку через WinGet удаляет winget uninstall Anthropic.ClaudeCode. Папку настроек %USERPROFILE%\.claude эти команды не трогают. Сотрёшь её сам - пропадут настройки, разрешения, подключения MCP и история сессий.

Чек-лист

Коротко: иди по списку сверху вниз. Сошлись все шесть строк - установку на Windows можно считать законченной.

1. [Environment]::Is64BitOperatingSystem в обычном окне PowerShell печатает True.
2. Установка закончилась строкой Claude Code successfully installed! без красных ошибок.
3. В новом окне claude --version печатает номер версии и (Claude Code).
4. where.exe claude показывает одну строку, в папке .local\bin.
5. claude doctor не сообщает об ошибках в файлах настроек.
6. После claude в папке проекта вход прошёл, а на первую задачу пришёл ответ.

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

Коротко: дальше Windows уже ни при чём, начинается настройка самого агента: файл правил, разрешения, скиллы. На каждую тему есть отдельная статья.

Я бы шёл в таком порядке:

1. Завести файл правил CLAUDE.md: всё, что приходится повторять агенту, переедет туда один раз. Как это сделать.
2. Разрешить агенту рутину и запретить опасное: настройка Claude Code с нуля.
3. Поставить первые скиллы, готовые наборы инструкций под задачи: что это и где их брать. Работаешь в VS Code - загляни в статью про расширение, команды держи под рукой в шпаргалке.

Мои правила, настройки, агенты и скиллы собраны в базе ClaudeBase. Переносить их руками не придётся: база подключается к Claude Code по MCP, и нужный материал агент сам приносит в твой проект.