Instalacja Claude Code na Windows to jedna komenda. Otwórz PowerShell, wklej i naciśnij Enter:
irm https://claude.ai/install.ps1 | iex
To cała instalacja (stan na 6 lipca 2026). Bez WSL, bez Node.js, bez niczego, co brzmi jak sprzęt programisty. Potem otwierasz terminal na nowo, wpisujesz claude, logujesz się w przeglądarce – i masz na komputerze agenta AI, który przyjmuje polecenia po polsku.
Poniżej dokładne kroki dla Windows i Maca, droga zupełnie bez terminala oraz rozwiązania pięciu błędów, które zatrzymują ludzi najczęściej.
- Windows: jedna komenda w PowerShellu –
irm https://claude.ai/install.ps1 | iex– potemclaudei logowanie w przeglądarce. - Mac:
curl -fsSL https://claude.ai/install.sh | bashw Terminalu (albobrew install --cask claude-code). - Bez WSL i bez Node.js. Starsze poradniki, które ich wymagają, są nieaktualne.
- Potrzebny plan Pro, Max albo Team – darmowe konto Claude nie obejmuje Claude Code.
- Nie chcesz terminala? Aplikacja Claude na komputer ma zakładkę Code – ten sam agent w zwykłym okienku.
- Coś nie działa? Niżej tabela pięciu najczęstszych błędów plus komenda
claude doctor.
- Zanim zaczniesz: czego potrzebujesz (a czego nie)
- Instalacja na Windows – 4 kroki
- Instalacja na Mac – 3 kroki
- Nie chcesz terminala? Aplikacja z zakładką Code
- Claude Code w edytorze: VS Code i JetBrains
- Gdy coś nie działa – najczęstsze błędy
- Aktualizacja i odinstalowanie
- Co dalej: pierwsze polecenie po polsku
- FAQ
Zanim zaczniesz: czego potrzebujesz (a czego nie)
Lista wymagań jest krótka, a lista rzeczy niepotrzebnych – dłuższa i ważniejsza. Stan na 6 lipca 2026:
Potrzebujesz:
- Windows 10 (wersja 1809 lub nowsza) albo Windows 11 i minimum 4 GB RAM. Na Macu: macOS 13 lub nowszy.
- Konta Claude z planem Pro, Max albo Team. Darmowy plan nie wystarczy – najtańszy wariant z Claude Code to Pro za 20 USD miesięcznie. Ceny i limity rozkładamy w cenniku Claude Code.
- Git for Windows – opcjonalnie, ale warto. Instalacja przejdzie bez niego, ale część funkcji z niego korzysta (patrz błąd nr 3 w tabeli niżej). Pobierzesz z git-scm.com.
Nie potrzebujesz:
- WSL. Claude Code działa natywnie na Windows. Jeśli poradnik każe ci instalować „podsystem Linuksa”, opisuje stan sprzed wielu miesięcy.
- Node.js. Stara metoda instalacji przez npm jest w oficjalnym repozytorium oznaczona jako przestarzała (Deprecated). Natywny instalator załatwia wszystko sam.
Jeśli już kiedyś próbowałeś i utknąłeś na WSL albo npm – to nie twoja wina. Te instrukcje były kiedyś poprawne. Narzędzie od tamtej pory uprościło się na tyle, że spora część poradników w sieci jest po prostu nieaktualna.
I jedno wyjaśnienie, zanim ruszymy: terminal to okno, w które wpisuje się polecenia tekstem. PowerShell to terminal wbudowany w każdy Windows. Niczego nie doinstalowujesz – on już tam jest.
Instalacja na Windows – 4 kroki
Krok 1. Otwórz PowerShell. Kliknij Start, wpisz „PowerShell” i otwórz aplikację z góry listy.
Krok 2. Wklej komendę i naciśnij Enter:
irm https://claude.ai/install.ps1 | iex
Po ludzku: pierwsza część (irm) pobiera oficjalny skrypt instalacyjny ze strony Anthropic, druga (iex) od razu go uruchamia. Skrypt ściąga Claude Code i instaluje go w twoim folderze użytkownika – nie rusza żadnych innych plików. Całość trwa chwilę.
Krok 3. Zamknij terminal i otwórz go na nowo. Świeżo zainstalowany program staje się widoczny dopiero w nowym oknie. To najczęściej pomijany krok – i jedno z najczęstszych źródeł zgłoszeń „nie działa”.
Krok 4. Wpisz claude i zaloguj się:
claude
Przy pierwszym uruchomieniu otworzy się przeglądarka z logowaniem. Dostaniesz wybór między kontem subskrypcyjnym a Console (API). Wybierz konto subskrypcyjne – to zwykłe konto Claude, na którym masz plan Pro albo Max. Opcja Console/API służy do rozliczeń za tokeny i na start jej nie potrzebujesz.
Gotowe. W terminalu czeka agent gotowy na polecenia.
Dwie alternatywy dla Windows
Wolisz klasyczny wiersz poleceń (CMD) zamiast PowerShella? Ta komenda robi to samo:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Po ludzku: pobiera instalator do pliku, uruchamia go, a po wszystkim kasuje plik.
Korzystasz z menedżera pakietów winget? Jest i taka droga:
winget install Anthropic.ClaudeCode
Z jednym zastrzeżeniem: wersje z winget i Homebrew nie aktualizują się same. Wrócimy do tego w sekcji o aktualizacjach.
Instalacja na Mac – 3 kroki
Krok 1. Otwórz Terminal. Naciśnij Cmd + spację, wpisz „Terminal” i naciśnij Enter.
Krok 2. Wklej komendę i naciśnij Enter:
curl -fsSL https://claude.ai/install.sh | bash
Działa tak samo jak wersja dla Windows: pobiera oficjalny skrypt instalacyjny i go uruchamia. Używasz Homebrew? Możesz zamiast tego wpisać:
brew install --cask claude-code
Krok 3. Wpisz claude i zaloguj się. Przeglądarka, konto subskrypcyjne, gotowe – identycznie jak w kroku 4 dla Windows.
Nie chcesz terminala? Jest aplikacja z zakładką Code
Aplikacja Claude na komputer (pobierzesz ją z claude.com/download) ma zakładkę Code. To ten sam agent, tylko w zwykłym okienku: wskazujesz folder, piszesz po polsku, co ma zrobić, i oglądasz wynik. Żadnych komend, żadnego czarnego okna. Jedno wymaganie na Windows: do pracy na lokalnych folderach potrzebujesz zainstalowanego Gita (git-scm.com). Krótki start opisuje oficjalna instrukcja aplikacji desktop.
Terminal daje więcej kontroli i tam Claude Code pokazuje pełnię możliwości. Ale jeśli zakładka Code sprawi, że w ogóle zaczniesz – zacznij od niej. Przesiąść się zdążysz.
Claude Code w edytorze: VS Code i JetBrains
Sekcja dla osób, które piszą kod na co dzień. Reszta może spokojnie przeskoczyć do błędów.
- VS Code: zainstaluj rozszerzenie „Claude Code” od wydawcy anthropic. Wymaga VS Code w wersji 1.98 lub nowszej; działa też w Cursorze i innych edytorach opartych o VS Code. Szczegóły: dokumentacja VS Code.
- JetBrains (IntelliJ, PyCharm, WebStorm i spółka): wtyczka „Claude Code [Beta]”. Wymaga zainstalowanego wcześniej Claude Code (CLI) z kroków wyżej. Szczegóły: dokumentacja JetBrains.
Gdy coś nie działa – najczęstsze błędy
Instalacja jest prosta, ale komputery bywają złośliwe. Te pięć przypadków pokrywa zdecydowaną większość problemów:
| # | Objaw | Rozwiązanie |
|---|---|---|
| 1 | „claude nie jest rozpoznawane jako polecenie” | System nie wie, gdzie szukać programu. Dodaj folder %USERPROFILE%\.local\bin do zmiennej PATH (Start → „zmienne środowiskowe”) i otwórz nowy terminal. |
| 2 | 'irm' is not recognized | Jesteś w CMD, nie w PowerShellu. Otwórz PowerShell albo użyj komendy dla CMD z sekcji wyżej. |
| 3 | Claude Code nie może znaleźć Git Bash | W pliku ~/.claude/settings.json ustaw CLAUDE_CODE_GIT_BASH_PATH na C:\\Program Files\\Git\\bin\\bash.exe (podwójne ukośniki są celowe – tak zapisuje się ścieżki w tym pliku). |
| 4 | Błędy uprawnień przy npm (EACCES) | Porzuć npm – ta metoda jest przestarzała. Zainstaluj natywnie, komendą z początku tekstu. |
| 5 | „The process cannot access the file” | Usuń folder %USERPROFILE%\.claude\downloads i uruchom instalację jeszcze raz. Częsty winowajca: antywirus albo resztki starej instalacji. |
PATH z punktu 1 to po prostu lista miejsc, w których system szuka programów – taki spis treści dla komend. Instalator zwykle dopisuje tam Claude Code sam; punkt 1 to plan B na wypadek, gdyby tego nie zrobił.
A gdy nie wiesz, co się dzieje, Claude Code ma wbudowaną diagnostykę:
claude doctor
Komenda sprawdza instalację i wskazuje, co wymaga naprawy. Dłuższa lista problemów z rozwiązaniami: oficjalny troubleshooting.
Aktualizacja i odinstalowanie
Instalacja natywna (PowerShell, CMD, Mac) aktualizuje się sama w tle – nie musisz nic robić. Chcesz wymusić aktualizację ręcznie:
claude update
Wyjątek: wersje z winget i Homebrew nie aktualizują się same – odświeżasz je przez winget upgrade albo brew upgrade claude-code.
Odinstalowanie: usuń plik %USERPROFILE%\.local\bin\claude.exe i folder %USERPROFILE%\.local\share\claude. To wszystko.
Co dalej: pierwsze polecenie po polsku
Masz działającego agenta. W takim razie nie zostawiaj go na „kiedyś” – daj mu pierwsze zadanie od razu, póki terminal jest otwarty. Wpisz claude w dowolnym folderze (na przykład w Dokumentach) i napisz zwykłym zdaniem:
Przejrzyj pliki w tym folderze i zaproponuj, jak uporządkować je w podfoldery. Na razie tylko zaproponuj, niczego nie przenoś.
Claude Code przeczyta zawartość folderu i odpowie planem. I ważny szczegół dla spokoju ducha: zanim cokolwiek zmieni na dysku, zapyta cię o zgodę. Domyślnie nic nie dzieje się bez twojego „tak”.
Instalacja to najkrótszy rozdział tej przygody. Co to narzędzie naprawdę potrafi – od porządków w plikach, przez analizę dokumentów, po budowanie własnych narzędzi – rozkładamy w przewodniku po Claude Code. A jak formułować polecenia, żeby wynik był dobry za pierwszym podejściem, opisujemy w tekście o pisaniu promptów.
Jeśli wolisz przejść tę drogę z prowadzeniem – od pierwszej komendy do własnego zespołu agentów – zajrzyj do Masterclass Claude Code.
Komendy i wymagania sprawdziłem 6 lipca 2026 w oficjalnej dokumentacji. Anthropic rozwija narzędzie szybko – jeśli czytasz ten tekst dużo później, porównaj kroki z aktualną instrukcją instalacji.
FAQ
Czy potrzebuję WSL, żeby używać Claude Code na Windows?
Nie. Claude Code działa natywnie na Windows 10 (wersja 1809 lub nowsza) i Windows 11. Poradniki, które każą instalować WSL, opisują starą wersję narzędzia – dziś wystarczy jedna komenda w PowerShellu.
Czy muszę mieć Node.js, żeby zainstalować Claude Code?
Nie. Instalacja przez npm, która wymagała Node.js, jest oficjalnie oznaczona jako przestarzała (Deprecated). Natywny instalator nie potrzebuje Node.js ani żadnych innych narzędzi programistycznych.
Czy Claude Code działa na darmowym planie Claude?
Nie. Potrzebujesz planu Pro, Max albo Team. Darmowy plan daje czat na claude.ai, ale nie obejmuje Claude Code. Najtańszy plan z Claude Code to Pro za 20 USD miesięcznie (stan na 6 lipca 2026) – szczegóły w cenniku Claude Code.
Jak zaktualizować Claude Code?
Instalacja natywna aktualizuje się sama w tle. Ręcznie zrobisz to komendą claude update. Wersje instalowane przez winget lub Homebrew nie aktualizują się same – odświeżasz je przez winget upgrade albo brew upgrade claude-code.
Czy mogę używać Claude Code w VS Code?
Tak. Zainstaluj rozszerzenie „Claude Code” od wydawcy anthropic – wymaga VS Code w wersji 1.98 lub nowszej i działa też w Cursorze i innych edytorach opartych o VS Code. Dla środowisk JetBrains jest wtyczka „Claude Code [Beta]”, która wymaga wcześniej zainstalowanego Claude Code (CLI).