Claude Code install: Windows, macOS i Linux krok po kroku

• Wybierz jedną ścieżkę instalacji odpowiadającą systemowi.
• Po instalacji otwórz nowe okno terminala i sprawdź numer wersji.
• Przygotuj konto z dostępem do Claude Code.
• Pierwszą sesję polecam zacząć od analizy własnego, małego projektu.

flowchart TD
    A[Wybierz system] --> B[Uruchom instalator]
    B --> C[Sprawdź wersję]
    C --> D[Zaloguj się]
    D --> E[Przeanalizuj projekt]

Według wymagań Anthropic potrzebujesz co najmniej 4 GB RAM, czyli pamięci operacyjnej, procesora x64 lub ARM64 (to oznaczenia architektur procesora, czyli typów jego budowy) oraz połączenia z internetem. Obsługiwane systemy obejmują Windows 10 od wersji 1809, macOS od 13.0, Ubuntu od 20.04 i Debian od 10.

Potrzebne jest też odpowiednie konto. Dokumentacja logowania wymienia Pro, Max, Team, Enterprise oraz Console. Console to panel dostępu do API, czyli interfejsu komunikacji między programami, rozliczanego z przedpłaconych środków zgodnie z instrukcją rozpoczęcia pracy.

Najpierw sprawdź dostęp do konta, żeby nie utknąć dopiero przy logowaniu. Do ćwiczenia polecam projekt bez haseł, danych klientów i kluczy API, czyli sekretów pozwalających korzystać z usługi.

Poniższe polecenia instalacyjne producenta różnią się zależnie od powłoki. Wykonaj tylko wiersz odpowiadający swojemu środowisku.

Windows: instalacja w PowerShell

1. Otwórz PowerShell. Poradnik terminala Anthropic wskazuje menu dostępne przez Win + X; jeśli wybierzesz Terminal, upewnij się, że otwarta karta używa PowerShell. Typowy początek wiersza zawiera PS.
2. Wklej polecenie poniżej i naciśnij Enter. Uruchomienie jako administrator nie jest potrzebne.
3. Poczekaj na zakończenie instalacji, następnie otwórz nowe okno PowerShell.

irm https://claude.ai/install.ps1 | iex

irm pobiera skrypt, a iex go wykonuje. Nie wklejaj tego polecenia do CMD, czyli drugiej powłoki Windows.

macOS: instalacja w Terminalu

1. Naciśnij Cmd + Space, wpisz Terminal i zatwierdź Enter, zgodnie z instrukcją dla macOS.
2. Wklej poniższe polecenie i naciśnij Enter.
3. Po zakończeniu otwórz nowe okno terminala.

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!

curl pobiera skrypt, a znak | przekazuje go do Bash, który go wykonuje. To ten sam instalator, którego użyjesz w następnym wariancie.

Linux: Ubuntu i Debian

1. Otwórz aplikację terminala, na przykład przez wyszukanie jej w menu aplikacji.
2. Jeśli zobaczysz curl: command not found, doinstaluj narzędzie poleceniem opisanym w Ubuntu Wiki. sudo uruchamia je z uprawnieniami administratora, a apt instaluje pakiet systemowy:

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.

Reading package lists...
Building dependency tree...
Reading state information...
curl is already the newest version (8.5.0-2ubuntu10.15).
0 upgraded, 0 newly installed, 0 to remove and 2 not upgraded.

Ta operacja dodaje program i wymagane zależności, czyli pakiety potrzebne do jego działania. Przeczytaj proponowane zmiany przed ich zatwierdzeniem.

3. Uruchom instalator dla Linuksa:

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!

4. Po zakończeniu otwórz nowy terminal. Dla Alpine Linux skorzystaj z osobnej instrukcji zależności, ponieważ ten system wymaga dodatkowej konfiguracji.

1. W nowym oknie terminala wpisz polecenie kontrolne:

claude --version

Oczekiwany wynik to numer wersji z dopiskiem (Claude Code). Nie porównuj numeru z przypadkowym zrzutem ekranu z internetu.

2. Uruchom diagnostykę, czyli sprawdzenie stanu instalacji:

claude doctor

claude doctor wyświetla informacje diagnostyczne bez uruchamiania sesji. Pokazuje między innymi problemy instalacji i błędy ustawień; samo polecenie nie wprowadza napraw.

3. Przejdź do folderu własnego projektu. Zanim wykonasz ten krok, musisz mieć na komputerze projekt z kodem i znać ścieżkę do jego folderu. Polecenie cd zmienia bieżący katalog, bez przenoszenia plików. W poniższych przykładach zastąp ścieżkę rzeczywistym adresem folderu, zgodnie z instrukcją pierwszej sesji. Poniższe bloki pokazują tylko wzór polecenia; nie uruchamiaj ich dosłownie.

Na macOS i Linuksie:

cd /path/to/your/project

Na Windows w PowerShell:

cd "C:\projekty\moj-projekt"

4. Z folderu projektu uruchom sesję w trybie planowania:

claude --permission-mode plan

Opcja --permission-mode plan wybiera tryb Plan. Pozwala on analizować projekt bez edytowania plików źródłowych, dlatego polecam go na pierwsze uruchomienie.

5. Przy pierwszym uruchomieniu dokończ logowanie w przeglądarce. Jeśli nie otworzy się automatycznie, naciśnij c, aby skopiować adres logowania, i wklej go do przeglądarki. Jeśli przeglądarka pokaże kod, wklej go wyłącznie do wskazanego pola w terminalu.

Po udanym logowaniu zobaczysz Login successful; naciśnij Enter. Jeśli pojawi się pytanie o zaufanie do folderu, potwierdź je tylko dla projektu, którego zawartość znasz.

Wpisz w sesji Claude Code własne polecenie:

Wyjaśnij po polsku, do czego służy ten projekt i jak są ułożone jego foldery. Na razie nie zmieniaj kodu.

To odpowiednik pierwszego ćwiczenia z dokumentacji: asystent analizuje pliki i przedstawia opis. Oczekuj odniesień do swojego projektu, nie gotowego tekstu identycznego dla każdego.

Przeczytaj odpowiedź i porównaj wymienione pliki z folderem na dysku. Nie proś od razu o przebudowę całej aplikacji. Gdy zechcesz zakończyć sesję, wpisz exit, zgodnie z poradnikiem terminala.

Terminal nie rozpoznaje claude

Najpierw zamknij terminal i otwórz nowe okno, co zaleca centrum pomocy Anthropic. Jeśli problem pozostaje, sprawdź PATH, czyli listę folderów, w których powłoka szuka programów.

Według instrukcji naprawy PATH instalator umieszcza program w ~/.local/bin na macOS i Linuksie oraz %USERPROFILE%\.local\bin na Windows. Znak ~ oznacza folder użytkownika.

1. Wybierz poprawkę dla używanej powłoki. Dla powłoki Zsh na macOS:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Dla Bash na Linuksie:

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

Każdy wariant dopisuje wpis do pliku ustawień powłoki i wczytuje go. >> dopisuje treść na końcu, dlatego wykonaj wybrany wariant tylko raz.

Dla PowerShell na Windows:

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

To trwale dopisuje katalog do PATH użytkownika. Zamknij PowerShell i otwórz go ponownie.

2. Powtórz claude --version. Oczekiwany wynik to numer wersji.

Nierozpoznane irm albo błąd 403

irm is not recognized oznacza, że używasz CMD zamiast PowerShell. Rozwiązanie producenta to otwarcie właściwej powłoki i ponowne wykonanie pełnego polecenia instalacji.

Jeśli pobieranie zwraca 403 lub kod HTML, czyli zawartość strony internetowej, sprawdź połączenie i ewentualną blokadę sieciową. Dokumentacja wskazuje między innymi filtry firmowe i ograniczenia regionalne. Nie zmieniaj składni skryptu, aby „naprawić” pobraną stronę.

Czy Claude Code działa na bezpłatnym koncie?

Bezpłatny plan claude.ai nie daje dostępu do Claude Code. Samo pobranie programu nie zastępuje uprawnionego konta.

Czy przed instalacją potrzebuję Node.js i npm?

Nie dla opisanej instalacji natywnej. Instalator dostarcza własne środowisko wykonawcze. Node.js służy do uruchamiania JavaScript, a npm zarządza jego pakietami. Nie dodawaj ich wyłącznie na potrzeby tego poradnika.

Czy na Windows muszę instalować WSL albo Git Bash?

Nie są obowiązkowe przy instalacji natywnej. WSL to środowisko Linux wewnątrz Windows, a Git Bash dostarcza powłokę Bash. Bez Git for Windows Claude Code korzysta z PowerShell.

Jak aktualizować Claude Code?

Instalacja natywna aktualizuje się automatycznie w tle. Aby ręcznie wywołać aktualizację, użyj polecenia producenta:

claude update

Polecenie aktualizuje program; wynik informuje o zainstalowaniu aktualizacji albo o tym, że wersja jest już aktualna.

Przed pierwszymi zmianami polecam nauczyć się zapisywać historię pracy nad projektem.