Як встановити 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КопірайтерFrontend-розробникМенеджер з продажуBackend-розробникКоуч і тренерАрхітектор програмного забезпеченняЮристІнженер з забезпечення якості (QA)Фінанси та адмініструванняFull-Stack розробникКреативний дизайнерРозробник мобільних додатківДослідникІнженер з безпекиHR та підбір персоналу
Менеджер проектуПерекладачЕксперт з GitАналітик данихСпеціаліст з SEOБухгалтерСпеціаліст з локалізаціїPR і комунікаціїГенератор ідейОперації та логістикаСпеціаліст з маркетингуПідтримка клієнтівАсистент проєктуФахівець із закупівельSMM-менеджерОсобистий асистент

Завантажити AgentsRoom

Запускайте всіх своїх AI-агентів на всіх своїх проєктах з одного вікна.

Завантажити AgentsRoomБезкоштовно

Додаток-компаньйон: контролюйте своїх агентів на ходу

Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.

Отримати розширення
Chrome Web Store

Надсилайте баги та запити прямо у свій публічний беклог.

Агенти, яких читаєш як розмову

Кожен агент має роль, обличчя та стрічку, яку читаєш як месенджер.

Режим розмови

Режим розмови в AgentsRoom: робота AI-агента для кодування у вигляді чату
Кілька проектів
Багато постачальників
Кілька агентів
Статус в реальному часі
Різниця файлів і коміт
Мобільний компаньйон
Попередній перегляд в реальному часі
Команди агентів
Автоматизація браузера
Розробка, орієнтована на беклог
Бібліотека підказок
Бібліотека навичок
Переглянути всі функції

Читати далі