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).¹ {.answer-block}

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, ale to WSL 2 daje doświadczenie identyczne z Linuksem, a instalator natywny uruchamia się w nim dokładnie tak samo.¹

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.

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+ jest obsługiwany na x64 i ARM64, ale zalecaną ścieżką pozostaje WSL 2, dający pełną zgodność z Linuksem – polecenie instalacyjne dla Linuksa uruchamia się właśnie w nim.

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