Як встановити 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
Запускайте всіх своїх AI-агентів на всіх своїх проєктах з одного вікна.
Додаток-компаньйон: контролюйте своїх агентів на ходу
Використовуйте свого: 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, а твої пул-реквести рядком Generated with Claude Code. Налаштування, яке їх прибирає, файл, куди його покласти, і як почистити вже запушені коміти.
Читати статтю