Как установить 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 Code | Codex CLI | |
|---|---|---|
| Версия Windows | Windows 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 |
| CMD | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| WinGet | winget 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». Официальная документация уже изменилась, и установщик тоже.
| Способ | Команда |
|---|---|
| Установщик для PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm 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 Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash внутри WSL |
| Установка Codex | установщик для PowerShell | curl -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:
- 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. - Устанавливай и запускай внутри WSL. Выполняй Linux-команду в терминале WSL, а не в PowerShell. Именно Node.js из Windows, вызванный из WSL, даёт
exec: node: not found: поставь Node.js в сам дистрибутив, через его менеджер пакетов или nvm. - Держи код в файловой системе 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-обёртку npm | Set-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 PowerShell | Claude Code не нашёл ни одной из двух оболочек | Установить Git for Windows или проверить, что PowerShell есть в PATH |
EBADENGINE во время npm install | Node.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 Code | Codex CLI | |
|---|---|---|
| Обновить сейчас | claude update (нативная установка), winget upgrade Anthropic.ClaudeCode или повторная установка через npm | codex 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)» из меню «Пуск».
Скачать AgentsRoom
Запускай всех своих ИИ-агентов во всех проектах из одного окна.
Приложение-компаньон: следите за агентами на ходу
Используйте Claude, Codex, Antigravity CLI или другого поставщика AI.
Отправляйте баги и запросы прямо в ваш публичный бэклог.
Агенты, которых читаешь как переписку
У каждого агента есть роль, лицо и лента, которую читаешь как в мессенджере.

Читать далее
Голосовой режим в Codex, OpenCode, Antigravity и Claude Code: в каком CLI он есть?
Мы проверили пять CLI агентов для программирования и два приложения 13 октября 2026 года. Codex CLI и oh-my-pi ведут голосовой разговор, Claude Code и Antigravity CLI только диктуют в промпт, в OpenCode ничего встроенного нет. Как запустить каждый, куда уходит звук и сколько голос стоит в токенах.
Читать статьюClaude Code против Codex CLI: что выбрать в 2026 году (и почему не оба сразу)
Честное сравнение Claude Code и Codex CLI: цены, скорость, MCP, контроль. И почему через пару недель я перестал выбирать между ними.
Читать статьюКак убрать Co-Authored-By Claude из твоих коммитов git
Claude Code подписывает твои коммиты трейлером Co-Authored-By, а твои pull request строкой Generated with Claude Code. Настройка, которая их убирает, файл, куда её положить, и как почистить уже запушенные коммиты.
Читать статью