Instalacja Claude Code na macOS, Linuksie i Windows

Claude Code instaluje się jako pojedynczy natywny plik binarny: natywnym instalatorem Anthropic, przez Homebrew, WinGet, podpisane repozytoria apt/dnf/apk albo npm (Node.js 22+). Natywny instalator i npm aktualizują się same; instalacje z menedżerów pakietów domyślnie nie. Każda metoda poza WinGet oferuje kanał wydań latest i stable, a claude doctor potwierdza instalację, stan aktualizacji i poprawność ustawień.

Ta strona jest dla dewelopera, który instaluje Claude Code na służbowym komputerze, i dla tech leada, który musi zadbać, żeby instalacja wyglądała tak samo u całego zespołu. Typowy bałagan: ktoś zainstalował przez npm rok temu, ktoś inny przez Homebrew, trzecia osoba ma dwa pliki claude w PATH i nikt nie wie, która wersja działa ani dlaczego brakuje funkcji z changeloga. Kilka minut świadomej konfiguracji oszczędzi ci tego wszystkiego.

Co daje sprawdzona instalacja Claude Code

• Jeden plik claude w PATH, zainstalowany metodą wybraną celowo.
• Wybrany przez ciebie kanał wydań (latest lub stable) i pasująca do niego polityka aktualizacji.
• Czysty raport claude doctor, który zachowujesz jako dowód, że instalacja jest zdrowa.
• Test dymny tylko do odczytu, którego wynik sprawdzasz w repozytorium w niecałą minutę.
• Skrypt kontrolny, który tech lead przekazuje każdej nowej osobie w zespole.

Którą metodę instalacji Claude Code wybrać?

Używaj natywnego instalatora, chyba że coś go wyklucza. Nie potrzebuje Node.js, instaluje się bez uprawnień administratora i sam utrzymuje aktualną wersję bez dodatkowej konfiguracji.

Metoda	Platformy	Aktualizacje	Kanał	Wybierz, gdy
Natywny instalator	macOS, Linux, WSL, Windows	Automatyczne, w tle	domyślnie latest; stable na żądanie	Prawie zawsze
Homebrew	macOS	Ręczne (brew upgrade) lub po włączeniu opcji	Cask claude-code = stable, claude-code@latest = latest	Zespół zarządza wszystkimi narzędziami przez Homebrew
WinGet	Windows	Ręczne (winget upgrade) lub po włączeniu opcji	—	Komputery z Windows zarządzane centralnie przez WinGet
apt / dnf / apk	Debian, Ubuntu, Fedora, RHEL, Alpine	Razem ze zwykłymi aktualizacjami systemu	Repozytorium stable lub latest	Serwery i obrazy, w których każdy plik binarny musi pochodzić z podpisanego repozytorium
npm	Każda platforma z Node.js 22+	W tle, jeśli globalny katalog npm jest zapisywalny	dist-tagi npm latest i stable	Globalne narzędzia standaryzujesz już na npm

Pakiet npm instaluje ten sam natywny plik binarny co pozostałe metody; zainstalowany claude nie korzysta z twojego Node.js. Jeśli wolisz interfejs graficzny, aplikacja desktopowa Claude Code działa bez terminala, ale i tak zainstaluj CLI: to w nim są narzędzia diagnostyczne z tej strony.

Który kanał wydań śledzić?

Kanał latest dostaje każde wydanie od razu po publikacji, mniej więcej jedno dziennie. Kanał stable jest zwykle około tygodnia z tyłu i pomija wydania z poważnymi regresjami. 2026-10-17 latest to v2.1.302, a stable to v2.1.292 (dist-tagi npm sprawdzone tego dnia).

Różnica dotyczy nie tylko poprawek błędów. Nowe funkcje i domyślne modele trafiają najpierw do latest: 2026-10-17 domyślny Claude Opus 5.5 (v2.1.280) jest na obu kanałach, ale alias haiku wskazujący Claude Haiku 5.5 wymaga v2.1.293, więc jest tylko na latest. Aktualną tabelę prowadzi przegląd modeli. Na własnym komputerze wybierz latest, jeśli chcesz nowe funkcje w dniu premiery; dla zespołu, który woli mniej niespodzianek niż tempo, wybierz stable.

Sprawdź wymagania systemowe Claude Code

Wymaganie	Obsługiwane
System operacyjny	macOS 13.0+, Windows 10 1809+ lub Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine Linux 3.19+
Sprzęt	4 GB+ RAM, procesor x64 lub ARM64 (32-bitowy Windows nie jest obsługiwany)
Powłoka	Bash, Zsh, PowerShell lub CMD
Sieć	Dostęp do serwerów pobierania i API Anthropic
Lokalizacja	Kraj obsługiwany przez Anthropic
Konto	Konto Pro, Max, Team, Enterprise lub Console albo dostawca chmurowy; darmowy plan Claude nie obejmuje Claude Code

Sam instalator potrzebuje około 512 MB wolnej pamięci, której małym instancjom chmurowym czasem brakuje (zobacz awarie poniżej).

Zainstaluj Claude Code

Natywny instalator i polecenia npm uruchamiaj w zwykłym terminalu, nie jako root i nie przez sudo; polecenia pakietów systemowych poniżej wymagają podwyższonych uprawnień.

Natywnie (zalecane)

macOS, Linux i WSL:

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

Windows PowerShell (znak zachęty zaczyna się od PS C:\):

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

Windows CMD (znak zachęty zaczyna się od C:\, bez PS):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Żeby zainstalować kanał stable, przekaż go do skryptu. Kanał z instalacji staje się kanałem automatycznych aktualizacji:

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

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd stable && del install.cmd

Na macOS i Linuksie instalator tworzy plik startowy (launcher) ~/.local/bin/claude, który wskazuje na ~/.local/share/claude/versions/.

Homebrew

brew install --cask claude-code          # stable channel
# or
brew install --cask claude-code@latest   # latest channel

Instalacje przez Homebrew nie aktualizują się same. Uruchamiaj brew upgrade claude-code (albo claude-code@latest) lub ustaw CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1, a Claude Code sam wykona aktualizację w tle i poprosi o restart. Co jakiś czas uruchom brew cleanup: Homebrew trzyma stare wersje na dysku.

WinGet

winget install Anthropic.ClaudeCode

Instalacje przez WinGet nie aktualizują się same. Uruchamiaj winget upgrade Anthropic.ClaudeCode lub ustaw CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. Windows blokuje uruchomiony plik wykonywalny, więc automatyczna aktualizacja może się nie udać przy otwartym Claude Code; wtedy Claude Code pokazuje polecenie do ręcznego uruchomienia.

apt / dnf / apk

Anthropic podpisuje wszystkie trzy repozytoria kluczem wydań Claude Code. Zweryfikuj klucz, zanim mu zaufasz. Poniższe polecenia używają kanału stable; żeby śledzić latest, zamień stable na latest w adresie URL (a przy apt także w nazwie dystrybucji repozytorium, czyli w polu suite).

Debian i Ubuntu (apt):

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc \
  -o /etc/apt/keyrings/claude-code.asc
gpg --show-keys /etc/apt/keyrings/claude-code.asc
# Expect fingerprint 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" \
  | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update && sudo apt install claude-code

Fedora i RHEL (dnf):

sudo tee /etc/yum.repos.d/claude-code.repo <<'EOF'
[claude-code]
name=Claude Code
baseurl=https://downloads.claude.ai/claude-code/rpm/stable
enabled=1
gpgcheck=1
gpgkey=https://downloads.claude.ai/keys/claude-code.asc
EOF
sudo dnf install claude-code

dnf poprosi o potwierdzenie klucza: akceptuj tylko 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE.

Alpine (apk, jako root):

wget -O /etc/apk/keys/claude-code.rsa.pub https://downloads.claude.ai/keys/claude-code.rsa.pub
sha256sum /etc/apk/keys/claude-code.rsa.pub
# Expect 395759c1f7449ef4cdef305a42e820f3c766d6090d142634ebdb049f113168b6
echo "https://downloads.claude.ai/claude-code/apk/stable" >> /etc/apk/repositories
apk add claude-code

Te instalacje aktualizują się wyłącznie razem z systemem (sudo apt update && sudo apt upgrade claude-code, sudo dnf upgrade claude-code, apk update && apk upgrade claude-code), bo te polecenia wymagają podwyższonych uprawnień.

npm

npm install -g @anthropic-ai/claude-code

Pakiet wymaga Node.js 22 lub nowszego; starszy Node wypisze ostrzeżenie EBADENGINE, ale instalacja się zakończy. Natywny plik binarny przychodzi jako opcjonalna zależność dla danej platformy, więc menedżer pakietów musi dopuszczać opcjonalne zależności. Aktualizuj przez npm install -g @anthropic-ai/claude-code@latest, a nie npm update -g, które trzyma się pierwotnego zakresu semver. Nigdy nie używaj sudo npm install -g.

Skonfiguruj Claude Code na natywnym Windows lub w WSL

Claude Code działa natywnie na Windows albo w WSL. Wybierz według tego, gdzie masz kod i narzędzia:

Opcja	Wymaga	Sandboxing	Zastosowanie
Natywny Windows	Niczego; Git for Windows opcjonalnie	Nieobsługiwany	Projekty i narzędzia natywne dla Windows
WSL 2	Włączonego WSL 2	Obsługiwany	Narzędzia linuksowe, wykonywanie poleceń w sandboksie
WSL 1	Włączonego WSL 1	Nieobsługiwany	Tylko gdy WSL 2 jest niedostępny

Na natywnym Windows Claude Code używa Git Bash jako narzędzia Bash, jeśli Git for Windows jest zainstalowany, a w przeciwnym razie narzędzia PowerShell. Jeśli Git Bash leży w nietypowym miejscu, ustaw CLAUDE_CODE_GIT_BASH_PATH w bloku env pliku settings.json. W WSL instaluj i uruchamiaj claude w terminalu WSL, nie z PowerShella.

Zainstaluj Claude Code na Alpine i innych dystrybucjach z musl

Przy natywnym instalatorze Alpine potrzebuje bash i curl do polecenia instalacji oraz libgcc, libstdc++ i ripgrep w czasie działania. Zainstaluj je, a potem każ Claude Code używać systemowego ripgrep:

apk add bash curl libgcc libstdc++ ripgrep

{
  "env": { "USE_BUILTIN_RIPGREP": "0" }
}

ripgrep jest w repozytorium community Alpine; włącz je w /etc/apk/repositories, jeśli apk nie znajduje pakietu.

Udowodnij, że instalacja Claude Code działa

Nie kończ na „polecenie się wykonało”. Cztery kontrole pokazują, że działają plik binarny, środowisko i konto, a żadna z nich nie wymaga czytania kodu.

1. Otwórz nowy terminal i wypisz wersję. Terminal, w którym trwała instalacja, wciąż ma stary PATH.

   claude --version

   Działająca instalacja wypisze coś w rodzaju 2.1.283 (Claude Code).

2. Sprawdź, czy nie ma drugiego pliku binarnego. Dwie instalacje to częsta przyczyna „aktualizacja nie zadziałała”.

   which -a claude        # macOS, Linux, WSL
   where.exe claude       # Windows

   Powinna się pojawić dokładnie jedna ścieżka.

3. Uruchom kontrolę stanu tylko do odczytu. claude doctor raportuje stan instalacji, status automatycznych aktualizacji, błędy walidacji plików ustawień oraz ostrzeżenia z sugerowanymi poprawkami, bez uruchamiania sesji.

   claude doctor

   Zachowaj ten wynik przy wdrażaniu nowej osoby: to dowód, że konfiguracja jest poprawna. Pełną kontrolę, która potrafi też naprawiać problemy, uruchamia /doctor wewnątrz sesji.

4. Zaloguj się i uruchom test dymny. Uruchom claude w katalogu projektu i przejdź logowanie w przeglądarce; uwierzytelnianie Claude Code opisuje każdy typ konta. Potem potwierdź logowanie i zadaj bezinterakcyjne pytanie tylko do odczytu, którego odpowiedź sprawdzisz samodzielnie:

   claude auth status --text
   claude -p "Which command runs this project's tests? Cite the file and line you read it from." --tools "Read,Glob,Grep"

   --tools "Read,Glob,Grep" ogranicza sesję do narzędzi tylko do odczytu, więc test dymny niczego nie zmieni. --tools przyjmuje listę wartości, więc umieść go po prompcie albo zapisz --tools=Read,Glob,Grep; postawiony przed promptem potraktuje prompt jako nazwę narzędzia i polecenie zakończy się błędem Input must be provided either through stdin or as a prompt argument (sprawdzone na v2.1.283). Otwórz wskazany plik: jeśli polecenie tam jest, działają instalacja, logowanie i połączenie z modelem.

Prompt do skopiowania: audyt instalacji Claude Code

Audit my Claude Code installation. Do not edit any file or setting.
Run `claude --version`, `which -a claude` (or `where.exe claude` on Windows) and `claude doctor`.
Report in a short table:
1. The installed version.
2. The install method: native launcher in ~/.local/bin, Homebrew, WinGet, npm, or a system package.
3. Whether more than one `claude` binary is on PATH, with every path.
4. The auto-update status and release channel.
5. Every warning `claude doctor` printed, with the fix it suggests.
Finish with one line: INSTALL OK or INSTALL NEEDS ACTION, and the single command I should run next.

Porównaj odpowiedź z własnym wynikiem claude doctor. Jeśli się różnią, ufaj poleceniu, nie podsumowaniu.

Prompt do skopiowania: pierwsza sesja tylko do odczytu w nowym repozytorium

Without editing anything, read this repository and tell me:
the main language and framework, the command that installs dependencies,
the command that runs the tests, and the command that runs the linter or type checker.
For each answer, cite the file and line you took it from. If you cannot find one, say so instead of guessing.

Każdą odpowiedź sprawdzisz w kilka sekund, otwierając wskazany plik. Pewna siebie odpowiedź bez cytatu to pierwszy sygnał, że agent zgaduje, i warto to wiedzieć, zanim dasz mu prawdziwą pracę.

Kontroluj aktualizacje i kanały wydań Claude Code

W instalacji natywnej ustaw kanał w ~/.claude/settings.json (albo przez /config → Auto-update channel):

{
  "autoUpdatesChannel": "stable",
  "minimumVersion": "2.1.274"
}

minimumVersion to dolna granica: aktualizacje w tle i claude update nigdy nie zainstalują nic starszego, więc przejście z latest na stable nie cofnie cię do starszej wersji.

Chcesz	Zrób tak
Zaktualizować teraz	claude update
Przeinstalować kanał lub przypiętą wersję	claude install stable, claude install latest albo claude install 2.1.274 (z --force, żeby wymusić ponowną instalację)
Wyłączyć sprawdzanie aktualizacji w tle	Ustaw "DISABLE_AUTOUPDATER": "1" w bloku env pliku settings.json; claude update nadal działa
Zablokować każdą ścieżkę aktualizacji	Ustaw "DISABLE_UPDATES": "1" w bloku env pliku settings.json (albo w ustawieniach zarządzanych) na maszynach, które muszą zostać na wersji dystrybuowanej w twojej organizacji; blokuje to także claude update i claude install

Po zmianie polityki aktualizacji uruchom ponownie claude doctor. Z ustawionym DISABLE_AUTOUPDATER linia Auto-updates brzmi disabled (set by env: DISABLE_AUTOUPDATER).

Powtarzalna instalacja Claude Code w zespole

Celem tech leada jest to, żeby każda maszyna miała znaną wersję ze znanego źródła, i żeby dało się to udowodnić bez chodzenia od biurka do biurka.

• Wybierz jedną metodę i jeden kanał dla zespołu i zapisz je w dokumencie onboardingowym. Mieszane metody prowadzą do awarii z podwójnym plikiem binarnym opisanych niżej.
• Wymuś kanał i zakres wersji ustawieniami zarządzanymi. Ustawienia zarządzane mogą ustalić autoUpdatesChannel, minimumVersion oraz bramki startowe requiredMinimumVersion i requiredMaximumVersion, których ustawienia użytkownika i projektu nie nadpiszą. Wdrożenie opisują integracja z przedsiębiorstwem i zarządzana polityka dla agentów kodujących.
• Weryfikuj plik binarny, gdy wymaga tego polityka. Każde wydanie publikuje manifest.json z sumami SHA-256, podpisany kluczem wydań Anthropic (odcisk klucza jak wyżej). Pliki binarne na macOS są podpisane i notaryzowane, na Windows podpisane. Pliki binarne na Linuksa nie są podpisywane pojedynczo (dokumentacja instalacji, sprawdzone 2026-09-26); na Linuksie weryfikuj podpis manifestu albo instaluj z podpisanych repozytoriów apt/dnf/apk.
• Kontenery i proxy. W obrazach ustaw katalog roboczy przed uruchomieniem instalatora (zobacz awarie poniżej) i rozważ devcontainer. Za firmowym proxy najpierw skonfiguruj je według konfiguracji proxy.

Prompt do skopiowania: skrypt kontrolny dla zespołu

Write scripts/check-claude-setup.sh, a POSIX shell script every new team member runs after installing Claude Code.
It must:
- fail if `claude` is missing, or if `which -a claude` prints more than one path;
- fail if `claude --version` is below 2.1.274 (compare versions numerically, not as strings);
- run `claude doctor` and fail if it exits non-zero or if its summary line reports one or more warnings or errors (for example `3 warnings found`); do not match the word "error" anywhere else in its output;
- run `claude auth status --text` and fail if the user is not logged in, without printing any token or key;
- print one PASS or FAIL line per check and exit non-zero on any failure.
Do not install or update anything. Then run the script once and show me its output.

Na v2.1.283 claude doctor kończy się kodem 0 nawet wtedy, gdy wypisuje ostrzeżenia, więc skrypt musi czytać linię podsumowania, a nie polegać wyłącznie na kodzie wyjścia. Przeglądaj kontrole skryptu, a nie każdą jego linię: uruchom go na jednej zdrowej maszynie (same PASS) i na jednej, na której celowo dodasz drugi claude do PATH (musi być FAIL). Kontrola, która nie może się nie udać, nie jest kontrolą.

Gdy instalacja Claude Code się psuje

command not found: claude albo 'claude' is not recognized. Najpierw otwórz nowy terminal. Jeśli dalej nie działa, katalogu instalacji nie ma w PATH: sprawdź to przez echo $PATH | tr ':' '\n' | grep -F "$HOME/.local/bin" i dopisz ~/.local/bin do profilu powłoki. Na Windows dodaj %USERPROFILE%\.local\bin do PATH użytkownika.

Wersja nie zmienia się po aktualizacji. Masz dwie instalacje i w PATH wygrywa starsza. Uruchom which -a claude, usuń wszystkie instalacje poza tą, którą chcesz zachować (polecenia deinstalacji są niżej), i uruchom claude doctor. Zwykle to para: stara instalacja npm i instalacja natywna.

syntax error near unexpected token '<' albo 403 z polecenia instalacji. Adres zwrócił stronę internetową zamiast skryptu. Jeśli strona mówi „App unavailable in region”, twój kraj nie jest obsługiwany. W przeciwnym razie przyczyną jest zwykle proxy albo chwilowa awaria: sprawdź, czy łączysz się z downloads.claude.ai, spróbuj ponownie albo użyj Homebrew lub WinGet.

irm is not recognized albo The token '&&' is not a valid statement separator. Polecenie PowerShella zostało uruchomione w CMD albo polecenie CMD w PowerShellu. Sprawdź znak zachęty (PS C:\ oznacza PowerShell) i użyj pasującego polecenia.

Killed albo kod wyjścia 137 podczas instalacji na Linuksie. Mechanizm OOM killer przerwał instalację z braku pamięci. Dodaj 2 GB pliku wymiany, zamknij inne procesy albo użyj większej instancji i uruchom instalator ponownie.

Instalacja zawiesza się w Dockerze. Instalacja jako root z katalogu / sprawia, że instalator skanuje cały system plików. Ustaw WORKDIR /tmp przed linią RUN curl … | bash.

EACCES przy npm install -g. Nie dodawaj sudo. Przejdź na natywny instalator albo wskaż npm prefiks należący do użytkownika (npm config set prefix ~/.npm-global i dodaj ~/.npm-global/bin do PATH).

Error: claude native binary not installed po instalacji przez npm. Menedżer pakietów pominął opcjonalną zależność albo jej krok postinstall. Zainstaluj ponownie z dozwolonymi opcjonalnymi zależnościami i skryptami albo przejdź na natywny instalator.

claude update albo claude doctor się zawiesza. W wersjach sprzed v2.1.214 zawieszenie powodował katalog w miejscu pliku konfiguracyjnego powłoki, np. ~/.zshrc. Przenieś ten katalog, a potem uruchom ponownie skrypt instalacyjny, bo samo claude update też się zawiesza.

Jeśli nic tu nie pasuje, przewodnik rozwiązywania problemów z Claude Code obejmuje błędy działania po instalacji.

Odinstaluj Claude Code

Usuń plik binarny poleceniem właściwym dla metody instalacji:

# Native (macOS, Linux, WSL)
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude
# Homebrew
brew uninstall --cask claude-code        # or claude-code@latest
# npm
npm uninstall -g @anthropic-ai/claude-code
# apt: package, repository file and key
sudo apt remove claude-code
sudo rm /etc/apt/sources.list.d/claude-code.list /etc/apt/keyrings/claude-code.asc
# dnf: package and repository file
sudo dnf remove claude-code
sudo rm /etc/yum.repos.d/claude-code.repo

# apk (as root): package, repository line and key
apk del claude-code
sed -i '\|downloads.claude.ai/claude-code/apk|d' /etc/apk/repositories
rm /etc/apk/keys/claude-code.rsa.pub

# Native (Windows PowerShell)
Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
# WinGet
winget uninstall Anthropic.ClaudeCode

Żeby usunąć również ustawienia, konfigurację MCP i historię sesji, skasuj ~/.claude/ i ~/.claude.json, a w każdym projekcie .claude/ i .mcp.json. Najpierw odinstaluj rozszerzenia IDE i aplikację desktopową, bo inaczej odtworzą ~/.claude/ przy następnym uruchomieniu. Jeśli claude nadal działa, została druga instalacja: uruchom ponownie which -a claude.

Co dalej po instalacji Claude Code

Uwierzytelnij Claude Code Logowanie subskrypcją, kontem Console lub przez dostawcę chmury i jak to udowodnić.

Skonfiguruj Claude Code Tryby uprawnień, wybór modelu i hierarchia ustawień.

Połącz IDE Integracja z VS Code i JetBrains na bazie CLI.

Zainstaluj Codex Siostrzany przewodnik, jeśli zespół używa też Codexa.

Konfigurujesz zamiast tego Cursora? Zobacz instalację i konfigurację Cursora. Dopiero zaczynasz? Ścieżka dewelopera porządkuje kolejne kroki.