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 Git Bash lub WSL), Alpine Linux 3.19+
RAM	Minimum 4 GB
Sieć	Wymagane połączenie internetowe do uwierzytelniania i wywołań API
Powłoka	Bash, Zsh, Fish lub PowerShell
Lokalizacja	Musi być w kraju obsługiwanym przez Anthropic

Notatka

Node.js nie jest już wymagany dla natywnego instalatora — samodzielny binarny plik zawiera własne środowisko uruchomieniowe. Metoda instalacji przez npm jest wycofywana; jeśli nadal jej używasz, potrzebujesz Node.js 18+, a istniejącą instalację npm możesz zmigrować do natywnej za pomocą claude install. Na Alpine i innych dystrybucjach opartych na musl natywny binarny 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 automatycznie aktualizuje w tle. Zawsze będziesz miał najnowszą wersję bez uruchamiania żadnych poleceń aktualizacji.

Homebrew (macOS)

Jeśli wolisz zarządzać pakietami przez Homebrew:

brew install --cask claude-code

Zweryfikuj instalację:

claude --version

Uwaga

Instalacje Homebrew nie aktualizują się automatycznie. Musisz okresowo uruchamiać brew upgrade claude-code, aby otrzymywać nowe funkcje i poprawki bezpieczeństwa. Z tego powodu preferowany jest natywny instalator.

WinGet (Windows)

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

winget install Anthropic.ClaudeCode

Zweryfikuj:

claude --version

Podobnie jak Homebrew, WinGet nie aktualizuje się automatycznie. Uruchom ręcznie winget upgrade Anthropic.ClaudeCode.

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	Nie
WinGet	winget upgrade Anthropic.ClaudeCode	Nie

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 — Metoda instalacji przez npm jest wycofywana, więc najczystszą poprawką jest przejście na natywny instalator (curl -fsSL https://claude.ai/install.sh | bash) lub zmigrowanie istniejącej instalacji npm za pomocą claude install. Jeśli musisz pozostać przy npm, napraw uprawnienia globalnego katalogu za pomocą npm config set prefix ~/.npm-global i dodaj ~/.npm-global/bin do PATH.

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.

Specyficzne dla Windows: “execution of scripts is disabled” — Uruchom PowerShell jako administrator i wykonaj Set-ExecutionPolicy RemoteSigned, następnie ponów instalację.

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