Claude Code Windows: instalacja przez WSL i typowe błędy

• Najpierw przygotuj WSL, potem instaluj Claude Code w terminalu Ubuntu.
• Polecam zacząć od osobnego folderu ćwiczeniowego.
• Gdy pojawi się błąd, zapisz jego treść i sprawdź, w którym terminalu wystąpił.

Do poniższej instalacji WSL potrzebujesz Windows 11 albo Windows 10 w wersji 2004, kompilacja 19041, lub nowszej. Kompilacja oznacza konkretne wydanie systemu. Claude Code wymaga co najmniej 4 GB RAM, procesora x64 lub ARM64 i internetu; obsługuje Ubuntu od wersji 20.04. RAM to pamięć operacyjna, a x64 i ARM64 oznaczają rodzaj architektury procesora.

Terminal to okno do wpisywania poleceń. PowerShell interpretuje polecenia Windows, a Bash, używany tutaj w Ubuntu, polecenia Linuksa. W tym poradniku dzielimy pracę następująco:

Microsoft dokumentuje polecenia zarządzania WSL, a Anthropic wskazuje, żeby Claude Code w WSL instalować i uruchamiać wewnątrz dystrybucji. Dystrybucja to gotowy zestaw systemu Linux i jego programów, tutaj Ubuntu.

1. Zainstaluj WSL i uruchom ponownie komputer

Otwórz PowerShell jako administrator. Instrukcja Microsoftu wymaga takich uprawnień przy instalacji WSL. Wpisz:

wsl --install

Polecenie włącza potrzebne składniki Windows i instaluje Ubuntu. Po zakończeniu uruchom ponownie komputer.

Jeśli masz już WSL, przejdź do sprawdzenia jego wersji w następnym kroku. Nie instaluj kolejnej dystrybucji tylko po to, żeby ponownie spróbować instalacji Claude Code.

2. Skonfiguruj Ubuntu i sprawdź WSL 2

Uruchom Ubuntu z menu Start. Przy pierwszym uruchomieniu utwórz linuksową nazwę użytkownika i hasło. Są niezależne od konta Windows. Podczas wpisywania hasła nie zobaczysz znaków ani gwiazdek, to normalne.

Następnie w PowerShell sprawdź zainstalowane dystrybucje i ich wersję WSL:

wsl --list --verbose

W kolumnie VERSION przy Ubuntu szukaj 2. Jeśli widzisz 1, Microsoft opisuje konwersję dystrybucji:

wsl --set-version Ubuntu 2

Użyj dokładnej nazwy z wyświetlonej listy, jeśli różni się od Ubuntu. Konwersja zmienia sposób działania dystrybucji. Przed konwersją polecam wykonać kopię danych. Microsoft ostrzega, że proces może potrwać i zakończyć się niepowodzeniem.

3. Przygotuj folder i narzędzie do pobierania

Dalsze polecenia wpisuj w Ubuntu. Polecam nowy folder w katalogu domowym użytkownika. Microsoft zaleca trzymać projekty obsługiwane narzędziami Linuksa w systemie plików WSL, aby uniknąć spowolnień przy przekraczaniu granicy systemów.

Korzystając z opisanych przez Ubuntu poleceń tworzenia katalogów i poruszania się po nich, przygotuj miejsce pracy:

mkdir -p ~/projekty/claude-wsl
cd ~/projekty/claude-wsl
pwd

~/projekty/claude-wsl

mkdir -p tworzy katalog wraz z brakującymi katalogami nadrzędnymi. cd przechodzi do niego, a pwd wyświetla bieżącą ścieżkę. Oczekuj ścieżki w postaci /home/nazwa_użytkownika/projekty/claude-wsl. Znak ~ oznacza katalog domowy.

Instalator używa curl, programu do pobierania danych. W Ubuntu odśwież listę pakietów i zainstaluj go przez APT, narzędzie zarządzające oprogramowaniem. Dokumentacja Ubuntu wyjaśnia działanie apt update i apt install, a dokumentacja Anthropic wymienia pakiet curl dla Ubuntu:

sudo apt update
sudo apt install curl

sudo: unable to send audit message: Operation not permitted

WARNING: apt does not have a stable CLI interface. Use with caution in scripts.

Hit:1 http://archive.ubuntu.com/ubuntu noble InRelease
Hit:2 https://deb.nodesource.com/node_24.x nodistro InRelease
Get:3 http://archive.ubuntu.com/ubuntu noble-updates InRelease [126 kB]
Get:4 http://security.ubuntu.com/ubuntu noble-security InRelease [126 kB]
Get:5 http://archive.ubuntu.com/ubuntu noble-backports InRelease [126 kB]
Get:6 http://archive.ubuntu.com/ubuntu noble-updates/multiverse amd64 Packages [67.4 kB]
…
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.

sudo uruchamia polecenie z uprawnieniami administratora Linuksa. Pierwsze polecenie aktualizuje listę dostępnego oprogramowania, drugie instaluje pakiet i wymagane zależności. Przeczytaj podsumowanie zmian przed zatwierdzeniem.

4. Zainstaluj Claude Code i sprawdź wynik

W folderze ćwiczeniowym uruchom oficjalny instalator dla Linuksa i WSL:

curl -fsSL https://claude.ai/install.sh | bash

Setting up Claude Code...

Checking installation status...
Installing Claude Code native build latest...
Setting up launcher and shell integration...
⚠ Setup notes:
  ● Native installation exists but ~/.local/bin is not in your PATH. Run:

    echo 'export PATH="$HOME/.local/bin:$PATH"' >> your shell config file && source your shell config file

…
✅ Installation complete!

Polecenie pobiera skrypt z adresu Anthropic i przekazuje go do wykonania przez Bash. Instaluje program, więc kopiuj adres dokładnie. Instalator podczas pobierania nie pokazuje postępu.

Po zakończeniu otwórz nowe okno Ubuntu, wróć do folderu i sprawdź instalację:

cd ~/projekty/claude-wsl
claude --version

Poprawnie zainstalowany program wyświetla numer wersji. Jeśli zobaczysz command not found, skorzystaj z rozwiązania poniżej.

5. Uruchom Claude Code i zaloguj się

W tym samym folderze wpisz:

claude

Przy pierwszym uruchomieniu Claude Code otwiera przeglądarkę do logowania. Jeśli się nie otworzy, naciśnij c, skopiuj adres logowania i otwórz go w przeglądarce.

Do korzystania z narzędzia potrzebujesz konta Pro, Max, Team, Enterprise lub Console; darmowy plan claude.ai nie obejmuje Claude Code. Po zalogowaniu zobaczysz pole rozmowy oraz informacje o katalogu roboczym. Sposoby rozliczania opisuje osobny poradnik Claude Code: cennik i wybór planu.

Tak wygląda kolejność pracy:

flowchart TD
    A[PowerShell: instalacja WSL] --> B[Ubuntu: konto użytkownika]
    B --> C[Folder ćwiczeniowy]
    C --> D[Instalator Claude Code]
    D --> E[Sprawdzenie wersji i logowanie]

WSL pokazuje pomoc albo pobieranie stoi na 0%

Jeśli wsl --install pokazuje pomoc, Microsoft zaleca wyświetlić dostępne dystrybucje i wskazać wybraną. W PowerShell:

wsl --list --online
wsl --install -d Ubuntu

Gdy pobieranie zatrzyma się na 0.0%, użyj opisanej na tej samej stronie alternatywy:

wsl --install --web-download -d Ubuntu

Błąd WSL 0x80370102

Microsoft wskazuje sprawdzenie składnika Virtual Machine Platform oraz wirtualizacji w BIOS. Wirtualizacja pozwala uruchamiać środowiska wirtualne, a BIOS to ustawienia komputera dostępne przed startem systemu. Sposób jej włączenia zależy od producenta. Po włączeniu składnika Windows uruchom ponownie komputer.

Ubuntu nie znajduje polecenia claude

Najpierw otwórz nowe okno Ubuntu. Jeśli problem pozostaje, instrukcja Anthropic dla Bash każe dodać katalog programu do PATH. PATH to lista katalogów, w których terminal szuka programów.

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
claude --version

Pierwsza linia dopisuje ustawienie do ~/.bashrc, pliku konfiguracji Bash, a druga odczytuje konfigurację ponownie. Uruchom ten blok raz. Jeśli plik ~/.local/bin/claude nie istnieje, dokumentacja wskazuje, że instalacja nie została ukończona.

Przeglądarka loguje, ale terminal nadal czeka

W WSL 2 przekierowanie z przeglądarki może nie dotrzeć do procesu Claude Code. Wklej kod pokazany po logowaniu do pola Paste code here if prompted. Jeśli terminal nie przyjmuje wklejenia, dokumentacja proponuje osobne polecenie:

claude auth login

Claude Code działa wolno w /mnt/c

/mnt/c to dostęp do plików dysku Windows z poziomu WSL. Anthropic opisuje spowolnienia odczytu i możliwe niepełne wyniki wyszukiwania przy pracy między systemami plików.

Polecam następny projekt założyć w ~/projekty. Przy istniejącym projekcie najpierw wykonaj kopię, a dopiero potem zaplanuj przeniesienie. Alternatywą opisaną przez Anthropic jest uruchamianie Claude Code bezpośrednio w Windows.

Starsza instalacja przez npm zgłasza błąd Node

Node.js uruchamia programy JavaScript, a npm instaluje ich pakiety. Przy błędzie exec: node: not found po starszej instalacji npm dokumentacja zaleca sprawdzić lokalizację obu narzędzi:

which npm
which node

/usr/bin/npm
/usr/bin/node

Ścieżki zaczynające się od /mnt/c/ wskazują narzędzia Windows. Dokumentacja proponuje instalację Node wewnątrz Linuksa. Przy nowej konfiguracji polecam instalator z kroku 4, aby uniknąć dokładania npm do procesu.

VS Code to edytor kodu. Jeśli chcesz go używać, wykonaj kroki z dokumentacji rozszerzenia WSL:

1. Zainstaluj VS Code w Windows, zaznaczając Add to PATH podczas instalacji.
2. Zainstaluj w edytorze rozszerzenie WSL.
3. W Ubuntu, z folderu ćwiczeniowego, wpisz:

code .

Przy pierwszym otwarciu edytor pobierze komponenty dla WSL. Po konfiguracji zobaczysz wskaźnik WSL w lewym dolnym rogu. Terminal otwarty przez Terminal > New Terminal w takim oknie działa w WSL. Jeśli code nie zostanie znalezione, dokumentacja zaleca restart terminala lub sprawdzenie ustawienia PATH.

Czy Claude Code działa na Windows bez WSL?

Tak. Anthropic dokumentuje instalację bezpośrednio w Windows z PowerShell lub CMD. Wybierz środowisko odpowiadające narzędziom swojego projektu.

Czy muszę instalować Node.js?

Przy opisanym instalatorze nie musisz osobno instalować Node.js. Centrum pomocy Anthropic wskazuje, że instalator dostarcza własne środowisko uruchomieniowe.

Jak otworzyć folder Ubuntu w Eksploratorze Windows?

W folderze projektu, w Ubuntu, użyj polecenia opisanego przez Microsoft:

explorer.exe .

Kropka wskazuje bieżący katalog. Otworzy się jego widok w Eksploratorze.

Jak sprawdzić instalację bez rozpoczynania rozmowy?

Uruchom diagnostykę instalacji i ustawień:

claude doctor

Polecenie wykonuje odczyt diagnostyczny i pokazuje ostrzeżenia z sugerowanymi rozwiązaniami.

Po uruchomieniu narzędzia przejdź do poradnika Claude Code w terminalu: pierwsze polecenia i pierwszy projekt. Polecam zacząć od małego zadania w folderze ćwiczeniowym, a pracę z ważnymi plikami poprzedzić kopią.