Jak zainstalować Claude Code i Codex CLI na Windowsie
Dokładne polecenia PowerShell, CMD, WinGet i npm do instalacji Claude Code i Codex CLI na Windowsie 10 i 11, kiedy wybrać WSL i jak naprawić „claude nie jest rozpoznawane” oraz inne błędy, na które trafisz.
Oba CLI instalują się dziś na Windowsie jedną linią. Większość kłopotów zaczyna się dopiero po niej: terminal, który nie znajduje polecenia, zasady wykonywania blokujące npm, stara dystrybucja WSL 1, polecenie wklejone do niewłaściwej powłoki. Ten poradnik podaje dokładne polecenia dla każdej drogi instalacji, a potem błędy i sposoby ich naprawy.
Informacje o obu CLI pochodzą z dokumentacji Anthropic i OpenAI oraz z samych skryptów instalacyjnych, przeczytanych 16 listopada 2026 roku, przy Claude Code 2.1.318 i Codex CLI 0.169.0. Oba narzędzia szybko się zmieniają: jeśli któreś polecenie poniżej zawiedzie, sprawdź oficjalną stronę podlinkowaną w każdej sekcji.
Krótka odpowiedź. Otwórz PowerShell, nie CMD, i uruchom:
irm https://claude.ai/install.ps1 | iex
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
Potem otwórz nowy terminal i uruchom claude --version oraz codex --version. Jeśli Windows odpowie, że claude nie jest rozpoznawane, poprawkę PATH znajdziesz niżej, w tabeli błędów.
Czego każde CLI potrzebuje na Windowsie
| Claude Code | Codex CLI | |
|---|---|---|
| Wersja Windowsa | Windows 10 1809 lub nowszy, Windows Server 2019 lub nowszy | Zalecany Windows 11, aktualny Windows 10 na zasadzie „best effort” |
| Procesor | x64 lub ARM64, nigdy 32-bitowy | x64 lub ARM64 |
| Konto | Płatny plan Claude albo konto Console | Plan ChatGPT albo klucz API OpenAI |
| Node.js | Tylko dla drogi przez npm, wersja 22 lub nowsza | Tylko dla drogi przez npm |
| Git for Windows | Opcjonalny | Niepotrzebny |
| Sandbox na natywnym Windowsie | Nie, tylko w WSL 2 | Tak, własny sandbox Windows |
| Uprawnienia administratora do instalacji | Nie | Nie |
Dwa wiersze tej tabeli zaskakują ludzi. Claude Code nie wymaga już Git for Windows: bez niego używa PowerShell jako narzędzia powłoki. A Codex uruchamia polecenia w sandboxie na natywnym Windowsie, podczas gdy Claude Code robi to tylko wewnątrz WSL 2.
Instalacja Claude Code na Windowsie
Strona instalacji Anthropic podaje cztery drogi. Zalecaną drogą jest natywny instalator: nie potrzebuje Node.js i sam aktualizuje się w tle.
| Droga | Polecenie |
|---|---|
| PowerShell (zalecana) | 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 |
Co zostawia po sobie każda droga:
- Natywny instalator:
claude.exew%USERPROFILE%\.local\bin, wersje w%USERPROFILE%\.local\share\claude. Instalator ostrzega cię, gdy.local\binnie ma w twoim PATH, ale sam go tam nie dodaje. - WinGet: brak automatycznych aktualizacji. Aktualizujesz przez
winget upgrade Anthropic.ClaudeCode, a Anthropic zaznacza, że aktualizacja może się nie udać, gdy Claude Code działa, bo Windows blokuje plik wykonywalny. - npm: z Node.js starszym niż 22 instalacja kończy się ostrzeżeniem
EBADENGINE.
Żeby zostać jedno wydanie za najnowszym, na kanale stabilnym:
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable
Potem sprawdź instalację. claude --version wypisuje wersję, a claude doctor przeprowadza diagnostykę instalacji i jej ustawień w trybie tylko do odczytu.
Jeśli masz Git for Windows, Claude Code szuka Git Bash w C:\Program Files\Git, potem w C:\Program Files (x86)\Git, a potem przez git z twojego PATH. Żeby wymusić inny, ustaw CLAUDE_CODE_GIT_BASH_PATH w bloku env swojego settings.json. Musi wskazywać plik o nazwie bash.exe lub sh.exe, nie git-bash.exe.
Instalacja Codex CLI na Windowsie
Strona o Windowsie od OpenAI mówi jasno: domyślnie używaj Codex natywnie z jego sandboxem Windows, a WSL wybierz, gdy twoje narzędzia i tak żyją w Linuksie. Jedno źródło zostaje w tyle: strona instalacji w repozytorium GitHub wciąż mówi „Windows 11 via WSL2”. Oficjalna dokumentacja poszła dalej, instalator również.
| Droga | Polecenie |
|---|---|
| Instalator PowerShell | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" |
| npm | npm install -g @openai/codex |
Instalator PowerShell to ta łatwa droga. Lektura skryptu pokazuje, co robi: instaluje Codex w %LOCALAPPDATA%\Programs\OpenAI\Codex\bin, dodaje ten folder do PATH twojego użytkownika i do bieżącej sesji, a na koniec każe ci otworzyć nowe okno PowerShell. Ponowne uruchomienie tego samego polecenia aktualizuje Codex. Przy npm aktualizujesz, uruchamiając ponownie polecenie instalacji.
Potem się zaloguj. Uruchom codex i wybierz Sign in with ChatGPT albo uruchom codex login. Na maszynie bez przeglądarki codex login --device-auth daje ci kod do wpisania na innym urządzeniu. codex login status mówi ci, na jakie konto jesteś zalogowany.
Sandbox Windows
Codex ma na Windowsie trzy implementacje sandboxa:
mxc: zalecana, bez konfiguracji przez administratora. Wymaga Windowsa 11 24H2 (build 26100.9278) lub 25H2 (build 26200.9278).elevated: preferowana opcja awaryjna. Wymaga jednorazowej konfiguracji zatwierdzonej przez administratora.unelevated: słabsza izolacja sieci i brak ścieżek tylko do odczytu.
Wybór robisz w config.toml:
[features]
prefer_mxc = true
[windows]
sandbox = "elevated" # or "unelevated"
Jeśli sandbox zawodzi z błędem 1385, Windows odrzucił typ logowania konta sandboxa. OpenAI prosi wtedy o CODEX_HOME/.sandbox/sandbox.log. Nigdy nie udostępniaj zawartości .sandbox-secrets/.
Natywny Windows czy WSL?
| Natywnie (PowerShell, CMD) | WSL 2 | |
|---|---|---|
| Instalacja Claude Code | irm https://claude.ai/install.ps1 | iex | curl -fsSL https://claude.ai/install.sh | bash wewnątrz WSL |
| Instalacja Codex | instalator PowerShell | curl -fsSL https://chatgpt.com/codex/install.sh | sh wewnątrz WSL |
| Sandbox Claude Code | niedostępny | dostępny, z bubblewrap i socat |
| Sandbox Codex | sandbox Windows | sandbox Linux |
| Gdzie trzymać repozytorium | gdziekolwiek | pod ~/, nie pod /mnt/c/ |
Wybierz WSL 2, gdy twój projekt i tak buduje się i działa w Linuksie albo gdy chcesz, żeby Claude Code uruchamiał swoje polecenia w sandboxie. Zostań przy natywnym Windowsie, gdy twój projekt jest projektem windowsowym: .NET, skrypty PowerShell, ścieżki Windows wszędzie.
Trzy zasady, jeśli idziesz drogą WSL:
- WSL 2, nigdy WSL 1. Codex przestał wspierać WSL 1 w wersji 0.115. Sandbox Claude Code odrzuca WSL 1 komunikatem
Sandboxing requires WSL2, a instalacje na WSL 1 mogą kończyć się błędemExec format error. Dystrybucję przekonwertujesz poleceniemwsl --set-version <DistroName> 2. - Instaluj i uruchamiaj wewnątrz WSL. Uruchom polecenie linuksowe w terminalu WSL, nie w PowerShell. To windowsowy Node.js wywołany z WSL daje
exec: node: not found: zainstaluj Node.js w samej dystrybucji, jej menedżerem pakietów albo przez nvm. - Trzymaj kod w linuksowym systemie plików. Obaj dostawcy radzą trzymać repozytorium poza
/mnt/c/, a Anthropic zaznacza, że wyszukiwania Claude Code są tam mniej kompletne. Sklonuj je do swojego katalogu domowego w Linuksie.
„claude nie jest rozpoznawane” i inne błędy
| Co widzisz | Dlaczego | Rozwiązanie |
|---|---|---|
'claude' is not recognized as an internal or external command (CMD), The term 'claude' is not recognized (PowerShell) | %USERPROFILE%\.local\bin nie ma w twoim PATH | Dodaj go do PATH użytkownika (polecenia poniżej), potem otwórz nowy terminal |
| Nadal nie jest rozpoznawane po dodaniu | Terminal albo otaczający go edytor uruchomił się przed zmianą | Zamknij i ponownie otwórz terminal, a także edytor, jeśli terminal działa w nim |
| Nie jest rozpoznawane tuż po aktualizacji | Aktualizacja przerwana w trakcie podmiany nie zostawiła żadnego claude.exe | Zmień nazwę najnowszego claude.exe.old.* z powrotem na claude.exe (polecenie poniżej) |
'irm' is not recognized | Wkleiłeś linię PowerShell do CMD | Otwórz PowerShell albo użyj linii CMD |
The token '&&' is not a valid statement separator | Wkleiłeś linię CMD do Windows PowerShell | Użyj linii PowerShell |
npm.ps1 cannot be loaded because running scripts is disabled on this system | Zasady wykonywania blokują nakładkę PowerShell od npm | Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser albo wywołaj npm.cmd |
| Błąd o 32-bitowym Windowsie na 64-bitowym komputerze | Otworzyłeś „Windows PowerShell (x86)” z menu Start | Otwórz zwykły 64-bitowy PowerShell |
claude otwiera aplikację desktopową zamiast CLI | Stara aplikacja desktopowa Claude umieściła Claude.exe w WindowsApps, przed CLI w PATH | Zaktualizuj aplikację desktopową Claude |
requires either Git for Windows (for bash) or PowerShell | Claude Code nie znalazł żadnej z dwóch powłok | Zainstaluj Git for Windows albo sprawdź, czy PowerShell jest w PATH |
EBADENGINE podczas npm install | Node.js jest starszy niż 22 | Zaktualizuj Node.js albo użyj natywnego instalatora |
Poprawka PATH, w PowerShell, dla bieżącego użytkownika, bez uprawnień administratora:
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
Żeby sprawdzić, gdzie Windows szuka, zanim cokolwiek zmienisz:
Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
where.exe claude
Zmiana nazwy po zepsutej aktualizacji:
Get-ChildItem "$env:USERPROFILE\.local\bin\claude.exe.old.*" | Sort-Object Name | Select-Object -Last 1 | Rename-Item -NewName claude.exe
O zasadach wykonywania: Windows PowerShell 5.1, ten dostarczany z Windowsem, na komputerach klienckich domyślnie ma ustawienie Restricted, dlatego świeżo kupiony laptop blokuje npm.ps1. Zakres CurrentUser nie wymaga uprawnień administratora. Natywnego instalatora Claude ani instalatora Codex to nie dotyczy: irm | iex i -ExecutionPolicy ByPass nigdy nie wczytują pliku skryptu z dysku.
Aktualizacja i odinstalowanie
| Claude Code | Codex CLI | |
|---|---|---|
| Aktualizacja teraz | claude update (natywnie), winget upgrade Anthropic.ClaudeCode albo ponowna instalacja przez npm | codex update w wydaniach, które to obsługują, ponownie instalator PowerShell albo npm install -g @openai/codex |
| Automatyczne aktualizacje | tylko przy instalacji natywnej, wyłączane przez DISABLE_AUTOUPDATER=1 | nieudokumentowane |
| Odinstalowanie | usuń %USERPROFILE%\.local\bin\claude.exe i %USERPROFILE%\.local\share\claude, albo winget uninstall Anthropic.ClaudeCode, albo npm uninstall -g @anthropic-ai/claude-code | usuń folder instalacji albo npm uninstall -g @openai/codex |
| Pozostawione ustawienia | %USERPROFILE%\.claude i %USERPROFILE%\.claude.json | %USERPROFILE%\.codex |
Czego nauczyło nas uruchamianie CLI agentów na Windowsie
AgentsRoom uruchamia Claude Code, Codex i inne CLI agentów obok siebie, a jego wersja na Windowsa pokazała nam, gdzie te instalacje się psują, gdy tylko wyjdą poza terminal. Cztery rzeczy warto wiedzieć, nawet jeśli nigdy nie użyjesz naszej aplikacji.
Program uruchomiony z menu Start zachowuje PATH, z którym wystartował. Instalujesz Claude Code, dodajesz .local\bin do PATH, a aplikacja desktopowa, która była już otwarta, wciąż nie znajduje claude. Restart terminala nie wystarcza w przypadku aplikacji, które uruchamiają CLI za ciebie. AgentsRoom przy szukaniu CLI ponownie odczytuje z rejestru PATH użytkownika i maszyny, więc instalacja, która właśnie się udała, nie jest zgłaszana jako brakująca.
npm nie instaluje pliku .exe. npm install -g @openai/codex zapisuje trzy pliki w %APPDATA%\npm: codex, codex.cmd i codex.ps1. Program, który uruchamia codex bezpośrednio, dostaje spawn codex ENOENT, bo Windows dopisuje do gołej nazwy tylko .exe. Twój terminal to ukrywa, ponieważ PowerShell i CMD czytają PATHEXT. To jeszcze jeden powód, żeby wybierać natywne instalatory, które dostarczają prawdziwy plik wykonywalny.
Nakładki npm potrzebują Node.js w chwili uruchomienia. Jeśli w tej samej sesji zainstalujesz Node.js, a potem CLI, nakładka .cmd zostanie znaleziona, ale zawiedzie z komunikatem „node is not recognized” w każdym programie uruchomionym, zanim Node.js trafił do PATH. Ten sam objaw daje menedżer wersji Node, którego nakładki wskazują nieaktywną wersję.
Uruchomienie procesu kosztuje na Windowsie znacznie więcej. Zmierzyliśmy 20 do 80 ms na utworzenie procesu na Windowsie wobec 1 do 3 ms na macOS, a każde sprawdzenie pliku kosztuje więcej, bo sprawdza je antywirus. Nasze pierwsze wykrywanie CLI próbowało każdego folderu, każdej nazwy i każdego rozszerzenia i zamrażało aplikację na Windowsie nawet na sekundę. Odczytanie każdego folderu tylko raz rozwiązało problem.
W aplikacji asystent instalacji instaluje brakujące CLI własnym instalatorem dostawcy dla twojego systemu (irm https://claude.ai/install.ps1 | iex dla Claude Code, skrypt OpenAI dla Codex), przechodzi na npm, gdy skrypt zawiedzie, i uruchamia to w terminalu, który możesz obserwować. Gdy CLI się nie uruchamia, CLI Doctor odczytuje błąd i dokładne polecenie, a potem mówi ci, co się zepsuło. Gdy oba CLI odpowiadają na --version, dalej poprowadzi cię przewodnik na start, a zapowiedź wersji na Windowsa opisuje, co aplikacja robi na Windowsie.
Najczęściej zadawane pytania
Jak zainstalować Claude Code na Windowsie?
Otwórz PowerShell i uruchom irm https://claude.ai/install.ps1 | iex. W CMD użyj zamiast tego linii install.cmd ze strony instalacji Anthropic, a z WinGet uruchom winget install Anthropic.ClaudeCode. Plik binarny trafia do %USERPROFILE%\.local\bin, a instalator nie dodaje tego folderu do twojego PATH: dodaj go sam, jeśli claude nie jest rozpoznawane, potem otwórz nowy terminal i uruchom claude --version.
Czy potrzebuję WSL, żeby używać Claude Code albo Codex na Windowsie?
Nie. Oba działają natywnie w PowerShell lub CMD na Windowsie 10 i 11. WSL 2 się opłaca, gdy twój projekt i tak żyje w Linuksie albo gdy chcesz mieć sandbox Claude Code, który nie działa na natywnym Windowsie. Używaj WSL 2, nie WSL 1: Codex porzucił WSL 1 w wersji 0.115.
Dlaczego Windows tuż po instalacji mówi, że 'claude' nie jest rozpoznawane?
Natywny instalator umieszcza claude.exe w %USERPROFILE%\.local\bin i wyświetla ostrzeżenie, jeśli tego folderu nie ma w twoim PATH, ale sam PATH nie zmienia. Dodaj folder do PATH swojego użytkownika, potem zamknij i ponownie otwórz terminal, a także edytor, jeśli terminal działa w nim. Terminal, który był już otwarty, zachowuje swój stary PATH.
Czy Claude Code potrzebuje Git for Windows?
Już nie. Strona instalacji Anthropic podaje Git for Windows jako opcjonalny: bez niego Claude Code używa PowerShell jako narzędzia powłoki. Z nim Claude Code znajduje Git Bash w C:\Program Files\Git, a ustawieniem CLAUDE_CODE_GIT_BASH_PATH możesz wskazać inny bash.exe.
Czy mogę zainstalować Codex CLI na Windowsie bez Node.js?
Tak. Instalator PowerShell od OpenAI pobiera samodzielny Codex, umieszcza go w %LOCALAPPDATA%\Programs\OpenAI\Codex\bin i dodaje ten folder do PATH twojego użytkownika. Tylko droga przez npm, npm install -g @openai/codex, wymaga Node.js.
Instalować je przez PowerShell czy przez CMD?
Przez PowerShell. Oba oficjalne jednolinijkowce to polecenia PowerShell, a najczęstsze błędy biorą się z wklejenia linii PowerShell do CMD albo odwrotnie: 'irm' is not recognized (na polskim Windowsie „'irm' nie jest rozpoznawane jako polecenie wewnętrzne lub zewnętrzne”) oznacza, że jesteś w CMD, a '&&' is not a valid statement separator oznacza, że jesteś w PowerShell. Używaj 64-bitowego PowerShell, nie pozycji „Windows PowerShell (x86)” z menu Start.
Pobierz AgentsRoom
Uruchamiaj wszystkich swoich agentów AI, we wszystkich projektach, z jednego okna.
Aplikacja towarzysząca: monitoruj agentów w podróży
Użyj Claude, Codex, Antigravity CLI lub innego dostawcy AI.
Wysyłaj bugi i prośby bezpośrednio do swojego publicznego backlogu.
Agenci, których czytasz jak rozmowę
Każdy agent ma rolę, twarz i wątek, który czytasz jak komunikator.

Czytaj dalej
Integracja Claude Code w iTerm2: co robi i jak ją skonfigurować
iTerm2 3.7 dostał integrację z Claude Code: status każdej sesji Claude (working, waiting, idle, a od 3.7.5 także done i error), workgroup z Chat, Diff i Code Review oraz komentarze z przeglądu odsyłane jako clippings. Jak ją zainstalować, co zmienia w ~/.claude/settings.json, dlaczego status przestaje działać i czego potrzebuje Codex.
Czytaj artykułClaude dodaje znak wodny do wszystkiego, co pisze. Twojego kodu to prawie nie dotyczy.
Anthropic znakuje teraz odpowiedzi Claude. Co naprawdę jest oznaczane, dlaczego kod w dużej mierze tego unika, kto to wykryje i dlaczego SEO się nie zmienia.
Czytaj artykułJak usunąć Co-Authored-By Claude z commitów git
Claude Code podpisuje twoje commity trailerem Co-Authored-By, a pull requesty linią Generated with Claude Code. Ustawienie, które je usuwa, plik, w którym je umieścić, i sposób na wyczyszczenie commitów, które już wypchnąłeś.
Czytaj artykuł