Instalacja i aktualizacja Claude Code CLI: Mac, Linux, Windows

Instalacja Claude Code to jedno polecenie na każdą platformę – curl -fsSL https://claude.ai/install.sh | bash w systemach macOS, Linux i WSL albo irm https://claude.ai/install.ps1 | iex w Windows PowerShell – a aktualizacja przebiega automatycznie (tak jest domyślnie) lub sprowadza się do jednego claude update. To, co większość stron pomija, zaczyna się dopiero po tym pierwszym poleceniu: którą metodę instalacji wybrać, gdy dostępne są cztery, jak zachowuje się autoupdater i jak go wyłączyć, jak przypiąć konkretną wersję oraz jak czysto odinstalować każdą z metod. Ta strona jest właśnie takim kompendium – jedna tabela na jedno zadanie, stan na wersję v2.1.224 (sierpień 2026).¹

TL;DR

• Warto wybrać instalator natywny. Nie ma zależności od Node.js, dostarcza przetestowany plik binarny dla każdej platformy i od wersji v2.1.113 stanowi metodę domyślną. Pakiet npm to rozwiązanie schyłkowe – wycofywane od wersji v2.1.15, a dziś wymaga Node.js 22 lub nowszego.¹
• Aktualizacje są domyślnie automatyczne: Claude Code sprawdza je przy starcie oraz okresowo w trakcie sesji, pobiera w tle i stosuje przy kolejnym uruchomieniu. claude update wymusza aktualizację natychmiast.²
• Wyłączenie aktualizacji to dwa różne przełączniki: DISABLE_AUTOUPDATER=1 zatrzymuje aktualizacje w tle; DISABLE_UPDATES=1 (v2.1.118+) blokuje wszystkie ścieżki aktualizacji, łącznie z ręcznym claude update.²
• Wersję można przypiąć, przekazując ją instalatorowi: curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58. Uruchomioną wersję sprawdza się poleceniem claude --version, a listę zmian przegląda przez /release-notes.¹²
• Gdy cokolwiek zaczyna szwankować, należy uruchomić claude doctor – raportuje typ instalacji, wersję i wykryte problemy, a od wersji v2.1.205 dostępne w sesji /doctor diagnozuje i naprawia usterki konfiguracji.²

Jak zainstalować Claude Code CLI?

Jedno polecenie, w podziale na platformy:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

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

A może menedżer pakietów? Obie ścieżki są pełnoprawne:

brew install --cask claude-code          # macOS / Linux (stable channel)
winget install Anthropic.ClaudeCode      # Windows

Następnie wystarczy uruchomić claude w katalogu projektu i uwierzytelnić się subskrypcją Claude Pro/Max/Team albo kontem API Anthropic.¹ Instalator natywny nie wymaga Node.js, sudo ani niczego wcześniej zainstalowanego. Jeśli konieczna jest stara ścieżka npm (npm install -g @anthropic-ai/claude-code), wymaga ona Node.js w wersji 22 lub nowszej i nigdy nie powinna być uruchamiana z sudo – globalne moduły należące do roota tworzą problemy z uprawnieniami, które przeżywają samą instalację.¹ Instalacja działa już przez npm? Polecenie claude install przenosi ją w miejscu na natywny plik binarny.

Konfigurację pierwszej sesji – wybór metody uwierzytelniania, pierwszy prompt, tryby uprawnień – opisuje przewodnik szybkiego startu, prowadzący od zera do pierwszego wyniku.

Jakie platformy obsługuje Claude Code?

Powracające pytanie o Windows: natywny Windows działa i nie wymaga uprawnień administratora; samo Anthropic zaleca wybór według tego, gdzie znajdują się projekty i czego się potrzebuje, z WSL 2 wtedy, gdy potrzebne są linuksowe łańcuchy narzędzi lub wykonywanie poleceń w piaskownicy, a w jego wnętrzu działa ten sam instalator dla Linuksa.³ Tryb auto w Claude Code nie jest granicą bezpieczeństwa dowodzi, że prawdziwą granicą jest izolacja na poziomie systemu operacyjnego, a nie tryb auto.

Jak zaktualizować Claude Code?

Zwykle nie trzeba nic robić. Claude Code domyślnie aktualizuje się sam – sprawdza nową wersję przy starcie oraz okresowo w trakcie sesji, pobiera ją w tle i stosuje przy kolejnym uruchomieniu.² Aby wymusić aktualizację natychmiast albo gdy autoupdater został wyłączony:

claude update

Instalacje z menedżerów pakietów aktualizują się własnym kanałem – brew upgrade --cask claude-code, winget upgrade Anthropic.ClaudeCode – a od wersji v2.1.129 ustawienie CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 pozwala im wykonać aktualizację menedżera pakietów w tle i poprosić o ponowne uruchomienie.²

Sterowanie aktualizacjami opiera się na dwóch odrębnych przełącznikach, a różnica między nimi ma znaczenie w środowiskach o zaostrzonych regułach:

Każdy z nich ustawia się jako zmienną środowiskową albo w sekcji "env" w pliku settings.json.²

Jak zainstalować konkretną wersję?

Wystarczy przekazać wersję instalatorowi – przydaje się to przy odtwarzaniu błędu, utrzymywaniu zespołu na sprawdzonym wydaniu albo przy wycofywaniu zmian:

# Specific version
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

# Latest, explicitly
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Windows PowerShell, specific version
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Potwierdzenie daje claude --version, a zmiany w każdym wydaniu przegląda się selektorem /release-notes dostępnym w sesji.² Przypięcie wersji warto połączyć z DISABLE_AUTOUPDATER=1 – inaczej autoupdater uprzejmie odepnie ją przy kolejnym uruchomieniu. (Gdy ręczne claude update również ma pozostać zablokowane, należy użyć DISABLE_UPDATES=1.)

Jak odinstalować Claude Code?

Sposób odinstalowania musi odpowiadać metodzie instalacji:

Konfiguracja mieszka osobno, w ~/.claude/, więc usunięcie pliku binarnego nie kasuje ustawień, skills ani historii – ten katalog warto usunąć tylko wtedy, gdy celem jest naprawdę czysta karta.¹

Cały cykl życia w jednej tabeli

A gdy coś jest nie tak – zgłaszana zła wersja, brak polecenia po aktualizacji, instalacja zastosowana połowicznie – claude doctor z powłoki raportuje typ instalacji, wersję i wykryte problemy, natomiast /doctor wewnątrz sesji (v2.1.205+) przeprowadza pełny przegląd, który potrafi naprawić to, co znajdzie.² Pełny przewodnik po Claude Code obejmuje wszystko po instalacji: konfigurację, uprawnienia, hooki, MCP i subagenty.

Rozwiązywanie problemów w Windows: claude nierozpoznawane, niewłaściwa powłoka, zablokowane skrypty

Większość awarii w Windows to jeden z dziewięciu przypadków, a każdy z nich ma rozpoznawalny komunikat błędu. Wszystkie poniższe poprawki pochodzą ze strony Anthropic o rozwiązywaniu problemów z instalacją oraz ze strony konfiguracji, w stanie na 7 września 2026.³⁴

1. 'claude' is not recognized as an internal or external command (CMD) lub The term 'claude' is not recognized as the name of a cmdlet (PowerShell). Instalator umieścił claude.exe w %USERPROFILE%\.local\bin\claude.exe; ten katalog nie znajduje się w PATH albo wciąż otwarty jest terminal, z którego przeprowadzono instalację i który zachowuje stary PATH. Należy sprawdzić, dodać katalog, a potem otworzyć nowy terminal:⁴

$env:PATH -split ';' | Select-String '\.local\\bin'      # no output = not on PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

W CMD sprawdzeniem jest echo %PATH% | findstr /i "local\bin", a poprawką dodanie %USERPROFILE%\.local\bin do PATH użytkownika w oknie Zmienne środowiskowe.⁴

2. 'irm' is not recognized, The token '&&' is not a valid statement separator lub A parameter cannot be found that matches parameter name 'fsSL'. Uruchomiono wiersz instalacyjny przeznaczony dla innej powłoki. Brak irm oznacza, że otwarty jest CMD (znak zachęty to C:\): należy użyć instalatora CMD podanego wyżej albo otworzyć PowerShell (PS C:\). Odrzucone && oznacza, że w PowerShellu uruchomiono wiersz dla CMD: należy użyć irm https://claude.ai/install.ps1 | iex. Komunikat o fsSL oznacza, że do PowerShella wklejono wiersz curl -fsSL ... | bash dla macOS/Linuksa, a tam curl jest aliasem Invoke-WebRequest. Jeśli polecenie wypisuje treść skryptu i niczego nie instaluje, uruchomiono tylko część pobierającą, bez części, która go wykonuje.⁴

3. running scripts is disabled on this system / PSSecurityException. Zasady wykonywania PowerShella blokują skrypty uruchomieniowe .ps1, które tworzy npm (npm.ps1, claude.ps1). Nie dotyczy to instalatora natywnego, który przepuszcza pobrany tekst przez iex zamiast zapisanego pliku, a zapisany ClaudeInstall.ps1 uruchamiany z -ExecutionPolicy Bypass -File nie należy do udokumentowanych przez Anthropic ścieżek instalacji (strona konfiguracji wymienia tylko wiersz irm, instalator CMD, WinGet i npm). Poprawki w kolejności: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser; albo wywołanie claude.cmd (zasady nie obejmują plików .cmd); albo zastąpienie instalacji npm instalatorem natywnym.⁴

4. Błędy parsowania iex cytujące znaczniki HTML lub CSS albo curl: (22) The requested URL returned error: 403. Adres instalacyjny zwrócił stronę internetową zamiast skryptu. Jeśli strona informuje „App unavailable in region”, Claude Code nie jest oferowany w danym kraju; w przeciwnym razie na drodze stoi serwer proxy lub filtr. Dostępność można sprawdzić poleceniem curl.exe -sI https://downloads.claude.ai/claude-code-releases/latest (należy jawnie wywołać curl.exe, bo alias curl w PowerShellu odrzuca -sI); pierwszy wiersz z 200 oznacza, że host jest osiągalny, a błąd był przejściowy. Udokumentowaną alternatywą jest winget install Anthropic.ClaudeCode.⁴

5. Could not establish trust relationship for the SSL/TLS secure channel lub CRYPT_E_NO_REVOCATION_CHECK (0x80092012). W pierwszym przypadku należy wymusić TLS 1.2 przed uruchomieniem instalatora: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12. Błędy unieważnienia oznaczają, że sieć blokuje sprawdzanie odwołania certyfikatów; wystarczy dodać --ssl-revoke-best-effort do wiersza curl w CMD albo użyć instalatora PowerShell, który pobiera przez .NET i toleruje nieosiągalny serwer list odwołań.⁴

6. The process cannot access the file ... because it is being used by another process. Poprzedni instalator wciąż działa albo program antywirusowy skanuje częściowo pobrany plik w %USERPROFILE%\.claude\downloads. Należy zamknąć pozostałe okna PowerShella, poczekać na koniec skanowania, a następnie:⁴

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\downloads"
irm https://claude.ai/install.ps1 | iex

7. Uruchamia się niewłaściwa wersja albo dwie instalacje sobie przeczą. where.exe claude wypisuje każde claude w PATH; Test-Path "$env:USERPROFILE\.local\bin\claude.exe" pokazuje, czy instalator natywny umieścił swój plik binarny. Warto zostawić natywny, a resztę usunąć (winget uninstall Anthropic.ClaudeCode, npm uninstall -g @anthropic-ai/claude-code, Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\local" dla starszej lokalnej instalacji npm). claude doctor wypisuje typ instalacji i wersję, która faktycznie działa.⁴

8. Claude Code on Windows requires either Git for Windows (for bash) or PowerShell. Nie znaleziono żadnej z tych powłok. Git for Windows jest opcjonalny: bez niego Claude Code wykonuje polecenia przez narzędzie PowerShell; z nim narzędzie Bash korzysta z Git Bash. Jeśli Git Bash jest zainstalowany, ale nie został znaleziony, należy wskazać go w settings.json:³

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

9. Claude Code does not support 32-bit Windows. Na 64-bitowym komputerze otwarto pozycję PowerShella x86. Należy otworzyć „Windows PowerShell”, a nie wersję „(x86)”.⁴

Jeśli żaden z tych przypadków nie pasuje, claude doctor (tylko odczyt, bez uruchamiania sesji) raportuje stan instalacji, błędy w plikach ustawień i wynik ostatniej próby aktualizacji, a strona Anthropic o rozwiązywaniu problemów zawiera pełną tabelę błędów i poprawek.³⁴

Często zadawane pytania

Jak zaktualizować Claude Code CLI do najnowszej wersji?

Wystarczy uruchomić claude update albo po prostu zrestartować program – domyślnie Claude Code sprawdza aktualizacje przy starcie i w trakcie sesji, pobiera je w tle i stosuje przy kolejnym uruchomieniu. Instalacje z Homebrew i winget aktualizuje się zamiast tego przez brew upgrade --cask claude-code oraz winget upgrade Anthropic.ClaudeCode.

Czy Claude Code aktualizuje się automatycznie?

Tak, domyślnie: sprawdza aktualizacje przy starcie i okresowo w trakcie działania, a pobraną aktualizację stosuje przy kolejnym uruchomieniu. DISABLE_AUTOUPDATER=1 wyłącza aktualizacje w tle, zachowując ręczne claude update; DISABLE_UPDATES=1 blokuje wszystkie ścieżki aktualizacji.

Jak zainstalować Claude Code w systemie Windows?

Należy uruchomić irm https://claude.ai/install.ps1 | iex w PowerShellu (albo winget install Anthropic.ClaudeCode). Natywny Windows 10 (1809+) jest obsługiwany na x64 i ARM64 bez uprawnień administratora; WSL 2 warto wybrać, gdy potrzebne są linuksowe łańcuchy narzędzi lub wykonywanie poleceń w piaskownicy, i dla pełnej zgodności z Linuksem uruchomić w nim polecenie instalacyjne dla Linuksa.

Czy do instalacji Claude Code potrzebny jest Node.js?

Nie – zalecany instalator natywny nie ma żadnej zależności od Node.js. Node wymaga wyłącznie starszy pakiet npm (npm install -g @anthropic-ai/claude-code, wycofywany od wersji v2.1.15), i to w wersji 22 lub nowszej. Przy instalacji z npm polecenie claude install przenosi wszystko na natywny plik binarny.

Jak sprawdzić, która wersja Claude Code jest zainstalowana?

claude --version z powłoki albo /release-notes w sesji, gdzie otwiera się interaktywny selektor listy zmian. claude doctor dodatkowo raportuje typ instalacji oraz wszelkie wykryte problemy z konfiguracją.