Claude Code nie uruchamia się na Windows - co sprawdzić

Claude Code

Claude Code nie uruchamia się na Windows - co sprawdzić

W skrócie

Claude Code, narzędzie CLI od Anthropic, przez długi czas najlepiej działało na Linuxie i macOS, a użytkownicy Windows napotykali dodatkowe przeszkody. Dziś istnieje natywne wsparcie dla Windows, ale wciąż zdarza się, że narzędzie nie chce wystartować - albo zamyka się od razu, albo zgłasza błędy dotyczące powłoki bądź brakujących zależności. Ten problem dotyka głównie osób, które instalują Claude Code na czystym Windows bez wcześniejszego przygotowania środowiska programistycznego.

Jak to wygląda w praktyce

Objawy bywają różne. Czasem po wpisaniu claude okno terminala miga i zamyka się bez komunikatu. Innym razem pojawia się błąd o niewspieranej wersji Node albo o braku powłoki, na przykład:

Error: Claude Code requires Node.js version 18 or higher.
Your version: v16.14.0

Bywa też, że narzędzie startuje, ale wywołania komend systemowych (git, testy) kończą się błędami, bo Claude Code nie znajduje odpowiedniej powłoki. To typowe dla świeżej instalacji Windows bez Git for Windows, który dostarcza powłokę Bash wykorzystywaną przez narzędzie.

Dlaczego Claude Code tak działa

Claude Code jest napisany z myślą o środowisku uniksowym - do uruchamiania komend, edycji plików i pracy z gitem oczekuje powłoki zgodnej z POSIX. Na macOS i Linux jest ona wbudowana, na Windows trzeba ją dostarczyć. Natywna wersja dla Windows radzi sobie z tym coraz lepiej, korzystając z powłoki dostarczanej razem z Git for Windows, ale gdy jej brakuje albo Node jest w wersji starszej niż 18, narzędzie nie ma na czym się oprzeć i pada. Starsze poradniki wręcz wymagały uruchamiania Claude Code wyłącznie wewnątrz WSL (Windows Subsystem for Linux) - i to nadal jest pewna droga, gdy natywna instalacja sprawia kłopoty.

Jak to rozwiązać krok po kroku

1. Sprawdź wersję Node: node --version. Jeśli jest niższa niż 18, pobierz aktualną wersję LTS ze strony nodejs.org i zainstaluj ponownie.
2. Zainstaluj Git for Windows ze strony git-scm.com. Dostarcza on powłokę Bash, której Claude Code używa do uruchamiania komend na Windows - bez tego wiele operacji się nie powiedzie.
3. Zainstaluj Claude Code natywnym poleceniem w PowerShell: irm https://claude.ai/install.ps1 | iex. To najprostsza droga na Windows i pomija problemy z globalnym npm.
4. Otwórz nowe okno PowerShell (żeby PATH się odświeżył) i uruchom claude w katalogu swojego projektu.
5. Jeśli natywna instalacja dalej sprawia kłopoty, przejdź na WSL: w PowerShell z uprawnieniami administratora wpisz wsl --install, zrestartuj komputer, a potem wewnątrz Ubuntu zainstaluj Node i Claude Code jak na Linuxie. Otwieraj projekty spod ścieżki WSL, nie z dysku Windows.
6. Uruchamiaj Claude Code w PowerShell lub Windows Terminal, a nie w starej konsoli cmd.exe - część funkcji interfejsu wymaga nowoczesnego terminala.

Jak sprawdzić, że zadziałało

Uruchom claude --version - powinna pojawić się liczba wersji. Następnie odpal claude w katalogu projektu i poproś o coś prostego, na przykład "wypisz pliki w tym katalogu". Jeśli narzędzie wykona komendę systemową i pokaże wynik bez błędów powłoki, znaczy to, że powłoka jest poprawnie podpięta. Dobrym testem końcowym jest wydanie polecenia dotykającego gita (np. "pokaż status repozytorium") - jego poprawne wykonanie potwierdza, że całe środowisko na Windows działa.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5