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

👁 124 przeczytań

Claude Code instalujesz jedną komendą: na Windows w PowerShellu, na macOS i Linuksie w terminalu, bez Node.js i bez uprawnień administratora. Potem claude --version, logowanie w przeglądarce i możesz pracować. Poniżej komendy dla każdego systemu, sposób naprawy błędu „claude is not recognized” i pułapki z Windowsa, na które wpadłem. Co robić po instalacji, opisuję w hubie Claude Code.

Windows: instalacja w PowerShellu

Otwórz PowerShell (menu Start, wpisz „PowerShell”). Wiersz zaczyna się od PS C:\Users\.... Wklej:

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

Instalator nie pokazuje paska postępu, chwilę trwa bez komunikatów. Gdy skończy, otwórz nowe okno i sprawdź:

claude --version

Jeśli wolisz zwykły wiersz poleceń (CMD, bez PS na początku):

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

Albo przez menedżer pakietów Windows. Ta wersja nie aktualizuje się sama, co jakiś czas trzeba wpisać winget upgrade Anthropic.ClaudeCode:

winget install Anthropic.ClaudeCode

Git for Windows: opcjonalny, ale go instaluję

Bez Gita Claude Code wykonuje polecenia w PowerShellu. Z Git for Windows dostaje dodatkowo Git Bash, czyli te same polecenia, które zna z Linuksa i macOS, i Git do zapisywania wersji projektu. Jeśli agent nie znajduje Basha, ścieżkę wskazujesz w %USERPROFILE%\.claude\settings.json:

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

Błąd: claude is not recognized

Instalator wrzuca program do %USERPROFILE%\.local\bin\claude.exe. Jeśli ten katalog nie jest w PATH, Windows go nie widzi. Najpierw sprawdź, czy plik istnieje:

Test-Path "$env:USERPROFILE\.local\bin\claude.exe"

Jeśli wychodzi True, dopisz katalog do PATH użytkownika i otwórz terminal ponownie:

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

Inne błędy na Windows

• „The token '&&’ is not a valid statement separator” - wkleiłeś komendę dla CMD do PowerShella. „’irm’ is not recognized” - odwrotnie.
• „running scripts is disabled on this system” - pojawia się przy instalacji przez npm. Rozwiązanie: instalator PowerShell zamiast npm albo Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser.
• Komenda claude otwiera aplikację Claude zamiast terminala - starsza wersja Claude Desktop rejestruje własny Claude.exe. Wystarczy zaktualizować aplikację.
• Windows 32-bitowy nie jest obsługiwany.

Moje pułapki z Git Bash

Pracuję na Windows 11 i dwie rzeczy kosztowały mnie najwięcej czasu. Git Bash przerabia argumenty zaczynające się od / na ścieżki Windows, więc przy skryptach, którym podaję adresy typu /slug/, ustawiam MSYS_NO_PATHCONV=1. Druga: zapisywanie plików przez heredoc (cat <<EOF) potrafi zjeść backslashe w kodzie, więc każę agentowi zapisywać skrypty narzędziem do plików.

WSL: kiedy wybrać Linuksa w Windows

Jeśli Twoje projekty i narzędzia są linuksowe, zainstaluj Claude Code wewnątrz WSL tak jak na Linuksie. Tylko w WSL 2 działa sandbox, który izoluje polecenia agenta. W WSL Git for Windows nie jest potrzebny.

macOS: terminal albo Homebrew

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

Albo przez Homebrew. Pakiet claude-code to kanał stable (ok. tydzień za najnowszą wersją, bez wydań z poważnymi błędami), claude-code@latest dostaje każdą wersję od razu. Homebrew nie aktualizuje się sam:

brew install --cask claude-code
brew upgrade claude-code

Program ląduje w ~/.local/bin/claude. Jeśli terminal odpowiada zsh: command not found: claude, ten katalog nie jest w PATH.

Linux: jedna komenda albo repozytorium pakietów

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

Na serwerach wolę repozytorium, bo aktualizacje przychodzą razem z resztą systemu. Debian i Ubuntu (kanał stable):

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
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

Odcisk klucza według dokumentacji to 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE, sprawdzisz go przez gpg --show-keys /etc/apt/keyrings/claude-code.asc. Dla Fedory i RHEL jest repozytorium dnf, dla Alpine apk. Na Alpine trzeba najpierw doinstalować bash curl libgcc libstdc++ ripgrep.

Instalacja przez npm (jeśli musisz)

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

Wymaga Node.js 22 lub nowszego i instaluje ten sam program co instalator natywny. Dokumentacja wprost odradza sudo npm install -g. Aktualizacja: npm install -g @anthropic-ai/claude-code@latest, a nie npm update -g.

Pierwsze uruchomienie i logowanie

cd moj-projekt
claude

Otworzy się przeglądarka z logowaniem. Wybierasz konto z planem Pro, Max, Team lub Enterprise albo konto Console (płatność za tokeny). Dane logowania zostają zapisane, więc robisz to raz. Zmiana konta w trakcie: /login.

Ważne: jeśli w systemie jest ustawiona zmienna ANTHROPIC_API_KEY, Claude Code zapyta, czy jej użyć. Gdy się zgodzisz, płacisz za tokeny, nawet jeśli masz abonament. Który plan wybrać i ile kosztuje praca na tokenach, rozpisuję w tekście Claude Code cena.

Na koniec diagnostyka, która sprawdza instalację, PATH i pliki ustawień bez uruchamiania sesji:

claude doctor

Bez terminala: VS Code, JetBrains i aplikacja

• VS Code i Cursor - w widoku Extensions (Ctrl+Shift+X) wyszukaj „Claude Code”. Wymaga VS Code 1.94 lub nowszego. Rozszerzenie ma własną kopię programu i nie dodaje claude do PATH.
• JetBrains - wtyczka Claude Code z JetBrains Marketplace, ale wymaga osobno zainstalowanego CLI.
• Aplikacja Claude na komputer - macOS, Windows x64 i ARM64 (Linux w wersji beta). Po zalogowaniu zakładka Code, CLI nie jest potrzebne. Wymaga płatnego planu.

Aktualizacja i odinstalowanie

Wersja z instalatora natywnego aktualizuje się w tle przy starcie i w trakcie pracy, a ręcznie wymusisz to przez claude update. Ustawienie "autoUpdatesChannel": "stable" w settings.json przełącza na wersje ok. tydzień starsze, bez wydań z poważnymi błędami.

Odinstalowanie wersji natywnej na Windows:

Remove-Item "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Na macOS i Linuksie: rm -f ~/.local/bin/claude i rm -rf ~/.local/share/claude. Ustawienia i historia zostają w ~/.claude, który usuwasz osobno.

Najczęstsze pytania

Jak zainstalować Claude Code na Windows?

W PowerShellu wpisz irm https://claude.ai/install.ps1 | iex, otwórz nowe okno i sprawdź claude --version. Uprawnienia administratora nie są potrzebne.

Czy Claude Code wymaga Node.js?

Nie. Instalator natywny, WinGet, Homebrew i repozytoria Linuksa instalują gotowy program. Node.js 22+ jest potrzebny tylko przy instalacji przez npm.

Gdzie Claude Code instaluje się na dysku?

Na Windows w %USERPROFILE%\.local\bin\claude.exe, na macOS i Linuksie w ~/.local/bin/claude, a wersje w ~/.local/share/claude. Ustawienia są w ~/.claude.

Czy Claude Code działa na Windows bez WSL?

Tak, natywnie od Windows 10 1809. WSL 2 przydaje się, gdy potrzebujesz sandboxa do izolowania poleceń albo pracujesz z linuksowymi narzędziami.

Dlaczego po instalacji „claude” nie działa?

Najczęściej katalog z programem nie jest w PATH albo terminal nie został otwarty ponownie. Na Windows dopisz %USERPROFILE%\.local\bin do PATH użytkownika, na macOS i Linuksie ~/.local/bin.

Jak zaktualizować Claude Code?

Wersja natywna robi to sama. Ręcznie: claude update. Przy WinGet winget upgrade Anthropic.ClaudeCode, przy Homebrew brew upgrade claude-code.

Źródła i data sprawdzenia

• Claude Code Docs: wymagania, instalacja, aktualizacja, odinstalowanie (odczyt 25.10.2026)
• Claude Code Docs: błędy instalacji - PATH, polityka skryptów, Claude Desktop (odczyt 25.10.2026)
• Claude Code Docs: quickstart - logowanie, typy kont (odczyt 25.10.2026)
• Docs: rozszerzenie VS Code i JetBrains (odczyt 25.10.2026)
• Claude Code: changelog - wersja 2.1.310 z 23.10.2026