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

Точные команды PowerShell, CMD, WinGet и npm для установки Claude Code и Codex CLI на Windows 10 и 11, когда выбирать WSL и как исправить «claude не является внутренней или внешней командой» и другие ошибки, которые тебе встретятся.

Сегодня оба CLI ставятся на Windows одной строкой. Почти все проблемы начинаются после неё: терминал не находит команду, политика выполнения блокирует npm, старый дистрибутив WSL 1, команда вставлена не в ту оболочку. В этом руководстве собраны точные команды для каждого способа установки, а затем ошибки и их исправления.

Сведения о двух CLI взяты из документации Anthropic и OpenAI и из самих скриптов установки, прочитанных 16 ноября 2026 года, с Claude Code 2.1.318 и Codex CLI 0.169.0. Оба инструмента быстро меняются: если команда ниже не срабатывает, проверь официальную страницу, ссылка на которую есть в каждом разделе.

Короткий ответ. Открой PowerShell, а не CMD, и выполни:

irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

Затем открой новый терминал и выполни claude --version и codex --version. Если Windows отвечает, что claude не распознаётся, исправление PATH есть в таблице ошибок ниже.

Что нужно каждому CLI на Windows

Claude CodeCodex CLI
Версия WindowsWindows 10 1809 или новее, Windows Server 2019 или новееРекомендуется Windows 11, свежая Windows 10 в режиме «best effort»
Процессорx64 или ARM64, никогда 32 битаx64 или ARM64
АккаунтПлатный тариф Claude или аккаунт ConsoleТариф ChatGPT или ключ API OpenAI
Node.jsТолько для пути через npm, версия 22 или новееТолько для пути через npm
Git for WindowsНеобязателенНе нужен
Песочница на нативной WindowsНет, только в WSL 2Да, собственная песочница Windows
Права администратора для установкиНетНет

Две строки этой таблицы удивляют. Claude Code больше не требует Git for Windows: без него он использует PowerShell как инструмент оболочки. А Codex изолирует команды в песочнице на нативной Windows, тогда как Claude Code делает это только внутри WSL 2.

Установка Claude Code на Windows

Страница установки Anthropic перечисляет четыре способа. Рекомендуемый: нативный установщик. Ему не нужен Node.js, и он сам обновляется в фоне.

СпособКоманда
PowerShell (рекомендуется)irm https://claude.ai/install.ps1 | iex
CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
WinGetwinget install Anthropic.ClaudeCode
npm (Node.js 22+)npm install -g @anthropic-ai/claude-code@latest

Что оставляет после себя каждый способ:

  • Нативный установщик: claude.exe в %USERPROFILE%\.local\bin, версии в %USERPROFILE%\.local\share\claude. Установщик предупреждает, когда .local\bin нет в твоём PATH, но сам его туда не добавляет.
  • WinGet: без автоматических обновлений. Обновляешь командой winget upgrade Anthropic.ClaudeCode, и Anthropic уточняет, что обновление может сорваться, пока Claude Code запущен, потому что Windows блокирует исполняемый файл.
  • npm: с Node.js старше 22 установка заканчивается предупреждением EBADENGINE.

Чтобы оставаться на один релиз позади последнего, на стабильном канале:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Затем проверь установку. claude --version выводит версию, а claude doctor запускает диагностику установки и её настроек в режиме только для чтения.

Если у тебя есть Git for Windows, Claude Code ищет Git Bash в C:\Program Files\Git, затем в C:\Program Files (x86)\Git, затем берёт git из твоего PATH. Чтобы задать другой, укажи CLAUDE_CODE_GIT_BASH_PATH в блоке env своего settings.json. Путь должен вести к файлу с именем bash.exe или sh.exe, а не git-bash.exe.

Установка Codex CLI на Windows

Страница о Windows от OpenAI говорит ясно: по умолчанию используй Codex нативно с его песочницей Windows, а WSL выбирай, когда твои инструменты уже живут в Linux. Один источник отстаёт: страница установки в репозитории GitHub всё ещё пишет «Windows 11 via WSL2». Официальная документация уже изменилась, и установщик тоже.

СпособКоманда
Установщик для PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm install -g @openai/codex

Проще всего установщик для PowerShell. Если прочитать скрипт, видно, что он делает: ставит Codex в %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, добавляет эту папку в PATH пользователя и в текущую сессию и просит открыть новое окно PowerShell. Повторный запуск той же команды обновляет Codex. С npm обновление делается повторным запуском команды установки.

Затем войди в аккаунт. Выполни codex и выбери Sign in with ChatGPT или выполни codex login. На машине без браузера codex login --device-auth выдаёт код, который нужно ввести на другом устройстве. codex login status показывает, под каким аккаунтом ты вошёл.

Песочница Windows

У Codex три реализации песочницы на Windows:

  • mxc: рекомендуемая, без настройки от администратора. Требует Windows 11 24H2 (сборка 26100.9278) или 25H2 (сборка 26200.9278).
  • elevated: предпочтительный запасной вариант. Требует однократной настройки, одобренной администратором.
  • unelevated: более слабая сетевая изоляция и никаких путей только для чтения.

Выбор делается в config.toml:

[features]
prefer_mxc = true

[windows]
sandbox = "elevated" # or "unelevated"

Если песочница падает с ошибкой 1385, Windows отклонила тип входа учётной записи песочницы. В этом случае OpenAI просит прислать CODEX_HOME/.sandbox/sandbox.log. Никогда не делись содержимым .sandbox-secrets/.

Нативная Windows или WSL?

Нативно (PowerShell, CMD)WSL 2
Установка Claude Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash внутри WSL
Установка Codexустановщик для PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh внутри WSL
Песочница Claude Codeнедоступнадоступна, с bubblewrap и socat
Песочница Codexпесочница Windowsпесочница Linux
Где держать репозиторийгде угоднов ~/, а не в /mnt/c/

Выбирай WSL 2, когда твой проект всё равно собирается и работает в Linux или когда хочешь, чтобы Claude Code изолировал запускаемые им команды в песочнице. Оставайся на нативной Windows, когда твой проект виндовый: .NET, скрипты PowerShell, пути Windows повсюду.

Три правила, если идёшь через WSL:

  1. WSL 2, никогда WSL 1. Codex перестал поддерживать WSL 1 с версии 0.115. Песочница Claude Code отказывается работать на WSL 1 с сообщением Sandboxing requires WSL2, а установка на WSL 1 может упасть с Exec format error. Переведи дистрибутив командой wsl --set-version <DistroName> 2.
  2. Устанавливай и запускай внутри WSL. Выполняй Linux-команду в терминале WSL, а не в PowerShell. Именно Node.js из Windows, вызванный из WSL, даёт exec: node: not found: поставь Node.js в сам дистрибутив, через его менеджер пакетов или nvm.
  3. Держи код в файловой системе Linux. Оба вендора советуют держать репозиторий вне /mnt/c/, а Anthropic уточняет, что поиск Claude Code там менее полный. Клонируй его в свою домашнюю папку Linux.

«claude не распознаётся» и другие ошибки

Что ты видишьПочемуИсправление
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell)%USERPROFILE%\.local\bin нет в твоём PATHДобавить её в PATH пользователя (команды ниже), затем открыть новый терминал
Всё ещё не распознаётся после добавленияТерминал или редактор вокруг него запустился до измененияЗакрыть и снова открыть терминал, а также редактор, если терминал живёт в нём
Не распознаётся сразу после обновленияОбновление, прерванное посреди замены, не оставило claude.exeПереименовать самый свежий claude.exe.old.* обратно в claude.exe (команда ниже)
'irm' is not recognizedТы вставил строку для PowerShell в CMDОткрыть PowerShell или взять строку для CMD
The token '&&' is not a valid statement separatorТы вставил строку для CMD в Windows PowerShellВзять строку для PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemПолитика выполнения блокирует PowerShell-обёртку npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser или вызывать npm.cmd
Ошибка про 32-битную Windows на 64-битном ПКТы открыл «Windows PowerShell (x86)» из меню «Пуск»Открыть обычный 64-битный PowerShell
claude открывает десктопное приложение вместо CLIСтарое десктопное приложение Claude положило Claude.exe в WindowsApps, раньше CLI в PATHОбновить десктопное приложение Claude
requires either Git for Windows (for bash) or PowerShellClaude Code не нашёл ни одной из двух оболочекУстановить Git for Windows или проверить, что PowerShell есть в PATH
EBADENGINE во время npm installNode.js старше 22Обновить Node.js или взять нативный установщик

Исправление PATH в PowerShell, для текущего пользователя, без прав администратора:

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

Чтобы проверить, где ищет Windows, прежде чем что-то менять:

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

Переименование после сломанного обновления:

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

О политике выполнения: Windows PowerShell 5.1, та версия, что поставляется с Windows, по умолчанию стоит в Restricted на клиентских ПК, поэтому новый ноутбук блокирует npm.ps1. Область CurrentUser не требует прав администратора. Нативного установщика Claude и установщика Codex это не касается: irm | iex и -ExecutionPolicy ByPass никогда не загружают файл скрипта с диска.

Обновление и удаление

Claude CodeCodex CLI
Обновить сейчасclaude update (нативная установка), winget upgrade Anthropic.ClaudeCode или повторная установка через npmcodex update в версиях, где это есть, повторный запуск установщика для PowerShell или npm install -g @openai/codex
Автоматические обновлениятолько нативная установка, отключаются через DISABLE_AUTOUPDATER=1не задокументированы
Удалениеудалить %USERPROFILE%\.local\bin\claude.exe и %USERPROFILE%\.local\share\claude, или winget uninstall Anthropic.ClaudeCode, или npm uninstall -g @anthropic-ai/claude-codeудалить папку установки или npm uninstall -g @openai/codex
Что остаётся на диске%USERPROFILE%\.claude и %USERPROFILE%\.claude.json%USERPROFILE%\.codex

Чему нас научил запуск CLI агентов на Windows

AgentsRoom запускает Claude Code, Codex и другие CLI агентов бок о бок, и его версия для Windows показала нам, где эти установки ломаются, как только выходят за пределы терминала. Четыре вещи стоит знать, даже если ты никогда не пользуешься нашим приложением.

Программа, запущенная из меню «Пуск», сохраняет PATH, с которым она стартовала. Ты ставишь Claude Code, добавляешь .local\bin в PATH, а уже открытое десктопное приложение всё равно не находит claude. Перезапуска терминала мало для приложений, которые запускают CLI за тебя. AgentsRoom заново читает PATH пользователя и машины из реестра, когда ищет CLI, чтобы только что успешная установка не числилась отсутствующей.

npm не устанавливает .exe. npm install -g @openai/codex пишет три файла в %APPDATA%\npm: codex, codex.cmd и codex.ps1. Программа, которая запускает codex напрямую, получает spawn codex ENOENT, потому что Windows добавляет к голому имени только .exe. Твой терминал это скрывает, так как PowerShell и CMD читают PATHEXT. Это ещё одна причина предпочесть нативные установщики, которые как раз ставят исполняемый файл.

Обёрткам npm нужен Node.js в момент запуска. Если ты ставишь Node.js, а потом CLI в той же сессии, обёртка .cmd находится, но падает с «node is not recognized» в любой программе, запущенной до того, как Node.js попал в PATH. Тот же симптом с менеджером версий Node, чьи обёртки указывают на неактивную версию.

Запуск процесса на Windows стоит гораздо дороже. Мы намерили от 20 до 80 мс на создание процесса на Windows, тогда как на macOS это от 1 до 3 мс, и каждая проверка файла обходится дороже, потому что файл досматривает антивирус. Наше первое обнаружение CLI перебирало каждую папку, каждое имя и каждое расширение и замораживало приложение на Windows до секунды. Однократное чтение каждой папки это исправило.

В приложении мастер установки ставит недостающий CLI собственным установщиком вендора для твоей ОС (irm https://claude.ai/install.ps1 | iex для Claude Code, скрипт OpenAI для Codex), откатывается на npm, если скрипт не сработал, и запускает всё в терминале, за которым ты можешь следить. Когда CLI не запускается, CLI Doctor читает ошибку и точную команду, а затем говорит, что сломалось. Когда оба CLI отвечают на --version, дальше тебя ведёт руководство по началу работы, а анонс версии для Windows рассказывает, что приложение умеет на Windows.

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

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

Открой PowerShell и выполни irm https://claude.ai/install.ps1 | iex. В CMD возьми вместо этого строку install.cmd со страницы установки Anthropic, а через WinGet выполни winget install Anthropic.ClaudeCode. Бинарник попадает в %USERPROFILE%\.local\bin, а установщик не добавляет эту папку в твой PATH: добавь её сам, если claude не распознаётся, затем открой новый терминал и выполни claude --version.

Нужен ли WSL, чтобы запускать Claude Code или Codex на Windows?

Нет. Оба работают нативно в PowerShell или CMD на Windows 10 и 11. WSL 2 имеет смысл, когда твой проект уже живёт в Linux или когда тебе нужна песочница Claude Code, которая не работает на нативной Windows. Бери WSL 2, а не WSL 1: Codex отказался от WSL 1 в версии 0.115.

Почему Windows пишет, что 'claude' не распознаётся, сразу после установки?

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

Нужен ли Claude Code Git for Windows?

Больше нет. Страница установки Anthropic называет Git for Windows необязательным: без него Claude Code использует PowerShell как инструмент оболочки. С ним Claude Code находит Git Bash в C:\Program Files\Git, а на другой bash.exe можно указать настройкой CLAUDE_CODE_GIT_BASH_PATH.

Можно ли установить Codex CLI на Windows без Node.js?

Да. Установщик OpenAI для PowerShell скачивает автономный Codex, кладёт его в %LOCALAPPDATA%\Programs\OpenAI\Codex\bin и добавляет эту папку в PATH твоего пользователя. Node.js нужен только для пути через npm, npm install -g @openai/codex.

Чем их устанавливать: PowerShell или CMD?

PowerShell. Обе официальные однострочные команды написаны для PowerShell, а самые частые ошибки возникают, когда строку для PowerShell вставляют в CMD или наоборот: 'irm' is not recognized (на русской Windows: «"irm" не является внутренней или внешней командой») значит, что ты в CMD, а '&&' is not a valid statement separator значит, что ты в PowerShell. Бери 64-битный PowerShell, а не пункт «Windows PowerShell (x86)» из меню «Пуск».

Инженер DevOpsКопирайтерФронтенд РазработчикМенеджер по продажамБэкенд РазработчикКоуч и тренерАрхитектор ПОЮристИнженер по качествуФинансы и администрированиеFull-Stack РазработчикКреативный дизайнерМобильный РазработчикИсследовательИнженер по безопасностиHR и подбор персонала
Менеджер ПроектовПереводчикЭксперт по GitАналитик данныхSEO СпециалистБухгалтерСпециалист по локализацииPR и коммуникацииМозговой штурмОперации и логистикаМаркетинговый СпециалистПоддержка клиентовАссистент проектаСпециалист по закупкамSMM-менеджерЛичный ассистент

Скачать AgentsRoom

Запускай всех своих ИИ-агентов во всех проектах из одного окна.

Скачать AgentsRoomБесплатно

Приложение-компаньон: следите за агентами на ходу

Используйте Claude, Codex, Antigravity CLI или другого поставщика AI.

Установить расширение
Chrome Web Store

Отправляйте баги и запросы прямо в ваш публичный бэклог.

Агенты, которых читаешь как переписку

У каждого агента есть роль, лицо и лента, которую читаешь как в мессенджере.

Режим переписки

Режим переписки в AgentsRoom: работа ИИ-агента для программирования в виде чата
Мульти-проекты
Мульти-провайдер
Мульти-агенты
Статус онлайн
Diff и коммиты
Мобильное приложение
Live-превью
Команды агентов
Тесты в браузере
Разработка от backlog
Библиотека промптов
Библиотека навыков
Все функции

Читать далее