Instalacja i konfiguracja - krok po kroku | Kurs Claude AI

Metody instalacji - przegląd kanałów

Stan na 1 października 2026: Claude Code zainstalujesz na kilka sposobów. Natywny instalator (skrypt dla macOS/Linux/WSL oraz wersje dla PowerShell i CMD na Windows) to droga zalecana. Obok niego działają menedżery pakietów (Homebrew, WinGet, na Linuksie apt, dnf i apk), paczka npm, rozszerzenie VS Code oraz aplikacja desktopowa Claude, która ma Claude Code w środku. Wtyczka JetBrains nie zawiera CLI, więc instalujesz je osobno.

Zanim zaczniesz: Claude Code wymaga planu Pro, Max, Team, Enterprise albo konta Anthropic Console (rozliczanego za tokeny). Na planie Free go nie ma.

Metoda 1: Native Installer (zalecana)

Nie wymaga Node.js i aktualizuje się sam w tle. Program trafia do ~/.local/bin (Windows: %USERPROFILE%\.local\bin). Po instalacji otwórz nowe okno terminala. Jeśli claude nie jest rozpoznawany, dodaj ten katalog do PATH (opis niżej, w rozwiązywaniu problemów).

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

Wolisz menedżer pakietów? Te same binarki dostaniesz przez Homebrew (macOS) lub WinGet (Windows):

brew install --cask claude-code          # kanał stabilny, nowe wersje z ok. tygodniowym opóźnieniem
brew install --cask claude-code@latest   # każda nowa wersja od razu

winget install Anthropic.ClaudeCode

Na Linuksie są też paczki apt, dnf i apk. Jedna różnica ma znaczenie: instalacja natywna i paczka npm aktualizują się same w tle. Homebrew, WinGet, apt, dnf i apk domyślnie NIE, więc aktualizujesz je ręcznie (brew upgrade claude-code albo brew upgrade claude-code@latest, zależnie od wybranej paczki, oraz winget upgrade Anthropic.ClaudeCode). Przy Homebrew i WinGet możesz to zlecić Claude Code: ustaw zmienną CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1.

Metoda 2: npm (wymaga Node.js 22+)

Od wersji 2.1.198 paczka npm wymaga Node.js 22 lub nowszego. Żaden inny kanał instalacji Node.js nie potrzebuje.

Alternatywa dla natywnego instalatora - np. gdy npm już zarządza Twoimi narzędziami CLI. Paczka npm też aktualizuje się sama, o ile globalny katalog npm jest zapisywalny. Jeśli nie jest, Claude Code pokaże przy starcie jednorazowy komunikat, a claude doctor podpowie poprawkę.

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

Weryfikacja: claude --version

Metoda 3: VS Code Extension i wtyczka JetBrains

Otwórz VS Code → Ctrl+Shift+X (Windows/Linux) lub Cmd+Shift+X (Mac)
Wyszukaj „Claude Code” → Install

Rozszerzenie VS Code (wymaga VS Code 1.94.0 lub nowszego) daje: inline diffs (podgląd proponowanych zmian obok oryginału), @-mentions z zakresem linii, przegląd planu przed akceptacją, historię rozmów i kilka rozmów w kartach. Ma własną kopię CLI, ale tylko dla panelu czatu. Żeby wpisywać claude w terminalu VS Code, zainstaluj CLI osobno (metoda 1 lub 2).

Wtyczka JetBrains działa inaczej. „Claude Code [Beta]” (IntelliJ IDEA, PyCharm, WebStorm, Android Studio, PhpStorm, GoLand) uruchamia claude w terminalu IDE i nie zawiera CLI. Najpierw instalujesz Claude Code metodą 1 lub 2, potem wtyczkę z marketplace'u JetBrains.

Metoda 4: Aplikacja desktopowa Claude

Aplikacja Claude Desktop (macOS Intel i Apple Silicon, Windows x64 i ARM64, Ubuntu/Debian w becie) zawiera Claude Code bez osobnej instalacji CLI. Po zalogowaniu kliknij zakładkę Code: to Claude Code z równoległymi sesjami (każda z izolacją Git) i podglądem diffów. Wymaga płatnego planu.

Reszta okna zależy od konta. Na większości kont obok Code są osobne Chat i Cowork. Na kontach Pro i Max, do których dotarł już „jeden Claude” (wdrażany stopniowo od 16 września 2026), czat i Cowork są połączone w jedną rozmowę.

To dobra droga dla osób, które nie chcą zaczynać od terminala. Pliki CLAUDE.md, ustawienia i serwery MCP są wspólne, więc późniejsze przejście na CLI nic nie psuje. Działającą sesję terminalową przeniesiesz do aplikacji komendą /desktop (macOS i Windows x64). Flaga claude --cloud "opis zadania" nie przenosi sesji, tylko zakłada nową sesję w chmurze dla bieżącego repozytorium.

Wymagania systemowe

OS	Wersja	Uwagi
macOS	13.0+	Pełne wsparcie
Ubuntu	20.04+	Pełne wsparcie
Debian	10+	Pełne wsparcie
Alpine Linux	3.19+	Doinstaluj bash, curl, libgcc, libstdc++ i ripgrep, potem ustaw `USE_BUILTIN_RIPGREP=0`
Windows	10 (1809)+	Wsparcie natywne - PowerShell lub CMD
Windows Server	2019+	Wsparcie natywne - PowerShell lub CMD

Sprzęt: 4 GB+ RAM, procesor x64 lub ARM64.

Windows: Claude Code działa natywnie - odpalasz go w PowerShell albo CMD, bez WSL. Git for Windows (Git Bash) jest opcjonalny, ale zalecany: daje Claude'owi pełne narzędzie Bash. Bez niego Claude korzysta z PowerShella. WSL 2 zostaje opcją dla linuksowych toolchainów i sandboxingu.

Sandbox (piaskownica). Ogranicza zapis na dysku i dostęp do sieci dla komend powłoki, które uruchamia Claude. Domyślnie jest wyłączony. Włączasz go komendą /sandbox albo ustawieniem sandbox.enabled. Działa na macOS, Linuksie i WSL2. Na natywnym Windows go nie ma. Narzędzia plikowe Claude'a, serwery MCP i hooki działają poza piaskownicą, więc nie traktuj jej jak pełnej izolacji.

Autentykacja

OAuth (logowanie przez claude.ai) - zalecane

claude
# Przy pierwszym uruchomieniu otwiera przeglądarkę
# Logujesz się na konto claude.ai
# Autoryzacja wraca do terminala

Zalety: nie trzeba zarządzać kluczami API, używa limitu z subskrypcji (Pro, Max, Team, Enterprise).

API Key

export ANTHROPIC_API_KEY="sk-ant-..."
claude

Gdy zmienna ANTHROPIC_API_KEY jest ustawiona, Claude Code pomija ekran logowania i raz prosi o zatwierdzenie klucza. Bez zmiennej wybierz w /login konto Anthropic Console (w firmie admin musi Cię najpierw zaprosić). Opcja oznaczona jako zalecana loguje Cię przez przeglądarkę bez tworzenia klucza (wymaga 2.1.242 lub nowszej). Opcja „Create an API key” (legacy) sama utworzy i zapisze klucz.

Zalety: pay-per-use, pełna kontrola kosztów, idealne do CI/CD.

Pierwszy prompt

Po instalacji i autentykacji przejdź do katalogu swojego projektu:

cd ~/moj-projekt
claude

Claude Code otworzy interaktywną sesję. Wpisz:

Opisz strukturę tego projektu. Jakie technologie są użyte?

Claude przeanalizuje cały codebase i odpowie. To Twój pierwszy prompt w Claude Code.

Od wersji 2.1.280 sesja startuje na Opus 5.5 z effort medium, na każdym planie. Model i poziom zmienisz komendami /model i /effort - opisuję je w lekcji o codziennych komendach.

Tryb uprawnień na start. Od wersji 2.1.284 (28 września 2026) sesje interaktywne w terminalu i VS Code startują w trybie auto. Dotyczy to każdego planu i każdego dostawcy, także Bedrock, Google Cloud i Foundry. Klasyfikator w tle przepuszcza bezpieczne akcje, a ryzykowne blokuje albo pyta. Wcześniej, od 14 sierpnia 2026, tak było tylko na Pro, Max i Team.

Trzy zastrzeżenia, o które rozbija się większość pytań na forach:

pierwsza sesja po instalacji lub aktualizacji może wystartować w innym trybie, np. default (Manual, pyta o każdą zmianę) - kolejne sesje otwierają się już w auto
na API Anthropic tryb auto działa z Opus 4.6 lub nowszym, Sonnet 4.6 lub nowszym i Fable. Na Bedrock, Google Cloud i Foundry tylko z Opus 4.7 lub nowszym, Sonnet 5 lub nowszym i Fable. Na Haiku i starszych modelach nie ma go u żadnego dostawcy
claude -p i Agent SDK startują w default. Wyjątek to sesje, które nie pobierają od Anthropic przełączników funkcji (feature flags), np. u zewnętrznego dostawcy albo z wyłączoną telemetrią: tam od wersji 2.1.285 startują w auto

Bazowy wymóg wbudowanego trybu auto to wersja 2.1.228 lub nowsza (macOS, Linux, WSL) albo 2.1.233 lub nowsza (natywny Windows). Jeśli masz własny permissions.defaultMode w ustawieniach, on wygrywa.

Tryby przełączasz klawiszem Shift+Tab, a bieżący tryb pokazuje pasek stanu pod polem promptu. Reguły klasyfikatora obejrzysz w zakładce Auto mode w /permissions. Na Pro, Max i Team komenda /auto-mode-setup przygotuje szkic listy zaufanych repozytoriów i domen.

Pro tip: Claude Code najlepiej działa w katalogu z repozytorium Git. Automatycznie rozpoznaje strukturę projektu, .gitignore i historię commitów.

Rozwiązywanie problemów - 7 typowych przypadków

Zanim zaczniesz szukać po forach, wpisz w terminalu claude doctor. Bez startowania sesji wypisze diagnostykę instalacji i ustawień razem z sugerowanymi poprawkami.

1. command not found: claude → Otwórz nowe okno terminala, bo okno, z którego instalowałeś, ma stary PATH. Nadal nie działa? Dopisz katalog instalacji do PATH (przykład dla Zsh, domyślnej powłoki macOS):

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Dla Basha na Linuksie użyj ~/.bashrc, dla Basha na macOS ~/.bash_profile. Sam source nic nie da, jeśli w pliku nie ma tej linii.

2. Ostrzeżenie EBADENGINE (tylko ścieżka npm) → Paczka npm od wersji 2.1.198 deklaruje Node.js 22+. Na starszym Node.js npm tylko ostrzega: instalacja się kończy, a claude działa, bo paczka pobiera natywny plik wykonywalny. Dla porządku zaktualizuj Node.js: nvm install 22. Natywny instalator, WinGet ani Homebrew w ogóle nie potrzebują Node.js.

3. Problemy z autentykacją OAuth → Spróbuj: w sesji /login → wybierz ponownie metodę logowania. Sprawdź też plan: Free nie loguje się do Claude Code.

4. Timeout podczas instalacji npm → Spróbuj: npm install -g @anthropic-ai/claude-code --registry https://registry.npmjs.org

5. Permission denied na macOS/Linux → Nie używaj sudo npm install -g. Zamiast tego skonfiguruj npm prefix lub użyj nvm.

6. Windows: 'claude' is not recognized → Otwórz nowe okno terminala (PowerShell/CMD). Nadal nie działa? Sprawdź, czy %USERPROFILE%\.local\bin jest w zmiennej PATH. Jeśli nie, dopisz go w PowerShell:

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

W samym CMD zrobisz to w oknie Zmienne środowiskowe, w zmiennej PATH użytkownika. Potem znów otwórz nowe okno terminala.

7. Stara wersja mimo „automatycznych aktualizacji” → Sprawdź claude --version, a claude doctor pokaże wynik ostatniej próby aktualizacji. Same aktualizują się instalacja natywna i paczka npm (npm tylko wtedy, gdy globalny katalog npm jest zapisywalny). Homebrew i WinGet aktualizujesz ręcznie (brew upgrade claude-code lub brew upgrade claude-code@latest, zależnie od paczki, i winget upgrade Anthropic.ClaudeCode) albo włączasz CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1.

Ćwiczenie praktyczne: Zainstaluj Claude Code na swoim systemie:

Wybierz metodę instalacji (native installer, WinGet/Homebrew, npm albo aplikacja desktopowa)

Zainstaluj i zweryfikuj: claude --version

Zaloguj się: claude (OAuth) lub ustaw API key

Przejdź do dowolnego projektu z kodem

Uruchom: claude i wpisz „Opisz ten projekt”

Zapisz wynik - to Twój pierwszy prompt w Claude Code

Co dalej

W następnej lekcji skonfigurujesz CLAUDE.md - plik, który sprawia, że Claude Code rozumie Twój projekt.