Instalacja Claude Code

Twój team lead właśnie wysłał Ci wiadomość na Slack: “Standaryzujemy Claude Code do wspomaganego przez AI rozwoju. Zainstaluj do jutrzejszego standupa.” Otwierasz dokumentację, widzisz trzy różne metody instalacji i zastanawiasz się, która faktycznie działa bez psującej konfiguracji Node lub zaśmiecania globalnych pakietów.

Ten przewodnik precyzuje opcje i pozwala Ci uzyskać działającą komendę claude w mniej niż 10 minut, niezależnie od systemu operacyjnego.

Co zdobędziesz

• Zainstalowany CLI Claude Code dostępny w PATH
• Skonfigurowane automatyczne aktualizacje, abyś nigdy nie pozostawał w tyle z wersjami
• Zweryfikowaną instalację, która odpowiada na claude --version
• Wiedzę, którą metodę instalacji wybrać i dlaczego

Wymagania systemowe

Przed instalacją potwierdź, że Twój system spełnia te minimalne wymagania:

Wymaganie	Szczegóły
System operacyjny	macOS 13.0+, Ubuntu 20.04+ / Debian 10+, Windows 10 1809+ lub Windows Server 2019+ (natywnie przez PowerShell/CMD lub opcjonalnie WSL), Alpine Linux 3.19+
RAM	Minimum 4 GB
Sieć	Wymagane połączenie internetowe do uwierzytelniania i wywołań API
Powłoka	Bash, Zsh, PowerShell lub CMD
Lokalizacja	Musi być w kraju obsługiwanym przez Anthropic

Notatka

Node.js nie jest wymagany dla natywnego instalatora — samodzielny plik binarny zawiera własne środowisko uruchomieniowe. Wspierana opcja npm instaluje ten sam natywny plik binarny i od v2.1.198 wymaga Node.js 22+ podczas instalacji (starszy Node wypisuje EBADENGINE, choć zainstalowany program nie używa Node w runtime). Na Alpine i innych dystrybucjach opartych na musl natywny plik dodatkowo wymaga libgcc, libstdc++ oraz ripgrep (następnie ustaw USE_BUILTIN_RIPGREP=0).

Wybierz metodę instalacji

Instalacja natywna (zalecana)

Natywny instalator to zalecana metoda. Pobiera samodzielny binarny plik, dodaje go do PATH i konfiguruje automatyczne aktualizacje w tle.

macOS i Linux:

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

Po instalacji otwórz nowe okno terminala (lub uruchom source ~/.zshrc / source ~/.bashrc) i zweryfikuj:

claude --version

Natywny instalator domyślnie śledzi kanał latest i aktualizuje się w tle. Później możesz przejść na opóźniony kanał stable albo wyłączyć sprawdzanie aktualizacji w tle.

Homebrew (macOS)

Jeśli wolisz zarządzać pakietami przez Homebrew, wybierz stabilny cask (zwykle około tygodnia za najnowszym wydaniem) lub natychmiastowy kanał latest:

brew install --cask claude-code
# lub: brew install --cask claude-code@latest

Zweryfikuj instalację:

claude --version

Uwaga

Instalacje Homebrew domyślnie nie aktualizują się automatycznie. Okresowo uruchamiaj brew upgrade claude-code (lub claude-code@latest) albo włącz aktualizacje wywoływane przez Claude przez CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1.

WinGet (Windows)

W Windows możesz również użyć WinGet:

winget install Anthropic.ClaudeCode

Zweryfikuj:

claude --version

Podobnie jak Homebrew, WinGet domyślnie nie aktualizuje się automatycznie. Uruchom ręcznie winget upgrade Anthropic.ClaudeCode albo ustaw CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1, aby Claude Code wywoływał upgrade po pojawieniu się wydania. Windows może wymagać wcześniejszego zamknięcia Claude Code, bo uruchomiony plik wykonywalny bywa zablokowany.

Menedżery pakietów Linux

Anthropic publikuje podpisane repozytoria apt, dnf i apk z kanałami stable oraz latest. Te instalacje aktualizuje systemowy menedżer pakietów, a nie updater Claude Code:

# Debian / Ubuntu
sudo apt update && sudo apt upgrade claude-code

# Fedora / RHEL
sudo dnf upgrade claude-code

# Alpine
apk update && apk upgrade claude-code

Skopiuj dokładne komendy repozytorium i klucza podpisu z oficjalnego przewodnika instalacji; przed zaufaniem nowemu repozytorium zweryfikuj opublikowany fingerprint klucza.

npm (opcja zaawansowana)

Wspierana opcja npm wymaga Node.js 22+ do instalacji i instaluje ten sam natywny plik binarny:

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

Aktualizuj przez npm install -g @anthropic-ai/claude-code@latest. Nie używaj npm update -g: może pozostać w zakresie semver zapisanym przy pierwotnej instalacji i ominąć najnowsze wydanie. Menedżer pakietów musi zachować zależności opcjonalne.

W natywnym Windows Git for Windows jest opcjonalny: z nim Claude używa Git Bash, bez niego korzysta z narzędzia PowerShell. WSL nadal przydaje się do toolchainów linuksowych i jest obecnie wymagany dla sandboxowanego wykonywania komend, ale nie jest potrzebny do samego uruchomienia Claude Code.

Weryfikacja po instalacji

Uruchom te trzy polecenia, aby potwierdzić, że wszystko działa:

# 1. Sprawdź wersję
claude --version

# 2. Sprawdź, czy binarny plik jest w PATH
which claude

# 3. Rozpocznij sesję (poprosi o uwierzytelnienie przy pierwszym uruchomieniu)
claude

Jeśli which claude nic nie zwraca, Twój PATH wymaga aktualizacji. Natywny instalator dodaje binarny plik do ~/.local/bin/ (z danymi w ~/.local/share/claude) i aktualizuje profil powłoki. Jeśli widzisz błędy, otwórz świeże okno terminala — Twoja obecna sesja może mieć nieaktualne zmienne PATH.

Wskazówka

Polecenie diagnostyczne do skopiowania i wklejenia:

echo "PATH: $(which claude)" && claude --version && echo "Installation OK"

Jeśli to wydrukuje ścieżkę, wersję i “Installation OK”, jesteś gotowy przejść do uwierzytelniania.

Aktualizacja Claude Code

Sposób aktualizacji zależy od tego, jak zainstalowałeś:

Metoda	Polecenie aktualizacji	Automatyczna aktualizacja?
Natywny instalator	Automatyczna	Tak
Homebrew	brew upgrade claude-code lub claude-code@latest	Domyślnie nie; dostępny opt-in przez env
WinGet	winget upgrade Anthropic.ClaudeCode	Domyślnie nie; dostępny opt-in przez env
apt / dnf / apk	Zwykła aktualizacja systemowych pakietów	Nie; zarządza systemowy menedżer pakietów
npm	npm install -g @anthropic-ai/claude-code@latest	Aktualizacja w tle zależy od praw katalogu globalnego

Dla natywnego instalatora możesz kontrolować kanał aktualizacji:

// W ~/.claude/settings.json
{
  "autoUpdatesChannel": "stable"
}

Kanał "stable" daje wersje, które mają około tygodnia i pomija wydania ze znanymi regresjami. Domyślny kanał "latest" daje najnowsze wydanie natychmiast.

Odinstalowywanie

Jeśli musisz usunąć Claude Code:

Instalacja natywna

Usuń binarny plik i pliki wersji bezpośrednio. Na macOS, Linux lub WSL:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

W Windows PowerShell:

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

Homebrew

brew uninstall --cask claude-code

WinGet

winget uninstall Anthropic.ClaudeCode

Aby również usunąć całą konfigurację i dane sesji:

rm -rf ~/.claude
rm -f ~/.claude.json

Aby usunąć także stan przypisany do projektu, uruchom to z wnętrza katalogu projektu:

rm -rf .claude
rm -f .mcp.json

Gdy coś nie działa

“Permission denied” podczas instalacji — Nie używaj sudo z żadną metodą instalacji. Natywny instalator zapisuje do ~/.local/bin/, co nie wymaga podwyższonych uprawnień. Jeśli wcześniej zainstalowałeś za pomocą sudo npm install -g, najpierw odinstaluj i zainstaluj ponownie bez sudo.

“command not found: claude” po instalacji — Otwórz nowe okno terminala. Instalator modyfikuje profil powłoki (.zshrc, .bashrc lub .profile), ale zmiany zaczynają obowiązywać dopiero w nowych sesjach. Jeśli nadal nie działa, sprawdź, czy ~/.local/bin jest w PATH: echo $PATH | tr ':' '\n' | grep -F "$HOME/.local/bin".

Błąd “EACCES” przy instalacji npm — Nie używaj sudo npm install -g. Napraw uprawnienia globalnego katalogu przez npm config set prefix ~/.npm-global i dodaj ~/.npm-global/bin do PATH albo użyj zalecanego natywnego instalatora (curl -fsSL https://claude.ai/install.sh | bash).

Instalacja się powiodła, ale claude zawiesza się — Sprawdź połączenie sieciowe. Claude Code musi dotrzeć do api.anthropic.com podczas uruchamiania. Jeśli jesteś za korporacyjnym proxy, ustaw zmienne środowiskowe HTTP_PROXY i HTTPS_PROXY.

Windows: instalator PowerShell jest blokowany przez execution policy — Użyj udokumentowanego instalatora CMD albo poproś administratora o zatwierdzoną politykę. Sam Claude Code działa natywnie z PowerShell lub CMD; nie osłabiaj zarządzanej polityki organizacji tylko po to, aby go zainstalować.

Co dalej

Gdy Claude Code jest zainstalowany, następnym krokiem jest uwierzytelnienie — połączenie CLI z Twoim kontem Anthropic, aby mogło wykonywać wywołania API.

Uwierzytelnianie Połącz się z kluczem API, subskrypcją Max lub SSO

Konfiguracja Skonfiguruj uprawnienia, modele i reguły automatycznego zatwierdzania