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 CodeCodex CLI
Wersja WindowsaWindows 10 1809 lub nowszy, Windows Server 2019 lub nowszyZalecany Windows 11, aktualny Windows 10 na zasadzie „best effort”
Procesorx64 lub ARM64, nigdy 32-bitowyx64 lub ARM64
KontoPłatny plan Claude albo konto ConsolePlan ChatGPT albo klucz API OpenAI
Node.jsTylko dla drogi przez npm, wersja 22 lub nowszaTylko dla drogi przez npm
Git for WindowsOpcjonalnyNiepotrzebny
Sandbox na natywnym WindowsieNie, tylko w WSL 2Tak, własny sandbox Windows
Uprawnienia administratora do instalacjiNieNie

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.

DrogaPolecenie
PowerShell (zalecana)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

Co zostawia po sobie każda droga:

  • Natywny instalator: claude.exe w %USERPROFILE%\.local\bin, wersje w %USERPROFILE%\.local\share\claude. Instalator ostrzega cię, gdy .local\bin nie 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ż.

DrogaPolecenie
Instalator PowerShellpowershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
npmnpm 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 Codeirm https://claude.ai/install.ps1 | iexcurl -fsSL https://claude.ai/install.sh | bash wewnątrz WSL
Instalacja Codexinstalator PowerShellcurl -fsSL https://chatgpt.com/codex/install.sh | sh wewnątrz WSL
Sandbox Claude Codeniedostępnydostępny, z bubblewrap i socat
Sandbox Codexsandbox Windowssandbox Linux
Gdzie trzymać repozytoriumgdziekolwiekpod ~/, 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:

  1. 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łędem Exec format error. Dystrybucję przekonwertujesz poleceniem wsl --set-version <DistroName> 2.
  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.
  3. 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 widziszDlaczegoRozwią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 PATHDodaj go do PATH użytkownika (polecenia poniżej), potem otwórz nowy terminal
Nadal nie jest rozpoznawane po dodaniuTerminal 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 aktualizacjiAktualizacja przerwana w trakcie podmiany nie zostawiła żadnego claude.exeZmień nazwę najnowszego claude.exe.old.* z powrotem na claude.exe (polecenie poniżej)
'irm' is not recognizedWkleiłeś linię PowerShell do CMDOtwórz PowerShell albo użyj linii CMD
The token '&&' is not a valid statement separatorWkleiłeś linię CMD do Windows PowerShellUżyj linii PowerShell
npm.ps1 cannot be loaded because running scripts is disabled on this systemZasady wykonywania blokują nakładkę PowerShell od npmSet-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser albo wywołaj npm.cmd
Błąd o 32-bitowym Windowsie na 64-bitowym komputerzeOtworzyłeś „Windows PowerShell (x86)” z menu StartOtwórz zwykły 64-bitowy PowerShell
claude otwiera aplikację desktopową zamiast CLIStara aplikacja desktopowa Claude umieściła Claude.exe w WindowsApps, przed CLI w PATHZaktualizuj aplikację desktopową Claude
requires either Git for Windows (for bash) or PowerShellClaude Code nie znalazł żadnej z dwóch powłokZainstaluj Git for Windows albo sprawdź, czy PowerShell jest w PATH
EBADENGINE podczas npm installNode.js jest starszy niż 22Zaktualizuj 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 CodeCodex CLI
Aktualizacja terazclaude update (natywnie), winget upgrade Anthropic.ClaudeCode albo ponowna instalacja przez npmcodex update w wydaniach, które to obsługują, ponownie instalator PowerShell albo npm install -g @openai/codex
Automatyczne aktualizacjetylko przy instalacji natywnej, wyłączane przez DISABLE_AUTOUPDATER=1nieudokumentowane
Odinstalowanieusuń %USERPROFILE%\.local\bin\claude.exe i %USERPROFILE%\.local\share\claude, albo winget uninstall Anthropic.ClaudeCode, albo npm uninstall -g @anthropic-ai/claude-codeusuń 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.

Inżynier DevOpsRedaktorProgramista FrontendPrzedstawiciel HandlowyProgramista BackendCoach i TrenerArchitekt OprogramowaniaDoradca PrawnyInżynier QAFinanse i AdministracjaProgramista Full-StackProjektant KreatywnyProgramista MobilnyResearcherInżynier BezpieczeństwaHR i Rekrutacja
Kierownik ProjektuTłumaczEkspert GitAnalityk DanychSpecjalista SEOKsięgowySpecjalista ds. LokalizacjiKomunikacja i PRBrainstormerOperacje i LogistykaSpecjalista ds. MarketinguObsługa KlientaAsystent projektuSpecjalista ds. ZakupówCommunity ManagerAsystent Osobisty

Pobierz AgentsRoom

Uruchamiaj wszystkich swoich agentów AI, we wszystkich projektach, z jednego okna.

Pobierz AgentsRoomZa darmo

Aplikacja towarzysząca: monitoruj agentów w podróży

Użyj Claude, Codex, Antigravity CLI lub innego dostawcy AI.

Zainstaluj rozszerzenie
Chrome Web Store

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.

Widok rozmowy

Widok rozmowy w AgentsRoom: praca agenta AI do kodowania pokazana jako wątek czatu
Wiele projektów
Multi-provider
Wielu agentów
Status na żywo
Diff i commit
Aplikacja mobilna
Podgląd na żywo
Zespoły agentów
Testy w przeglądarce
Dev oparta na backlogu
Biblioteka promptów
Biblioteka umiejętności
Zobacz wszystkie funkcje

Czytaj dalej