Kluczowe wnioski
- Dwie metody instalacji: Użyj natywnego instalatora (
curl -fsSL https://claude.ai/install.sh | bash) dla konfiguracji bez zależności lub npm (npm install -g @anthropic-ai/claude-code), jeśli potrzebujesz przypinania wersji. - Wymagania systemowe są minimalne: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+) lub Windows 10+ z WSL. Co najmniej 4GB RAM. Nie jest wymagana karta GPU.
- Wymagane konto: Potrzebujesz konta Claude Pro, Max, Teams, Enterprise lub Console (API). Bezpłatny plan Claude.ai nie obejmuje dostępu do Claude Code.
- Konfiguracja zajmuje mniej niż pięć minut: Zainstaluj, uwierzytelnij się w przeglądarce i natychmiast zacznij korzystać z Claude Code w dowolnym katalogu projektu.
Jak zainstalować Claude Code: Kompletny przewodnik konfiguracji (2026)
Claude Code to asystent kodowania AI od Anthropic, który działa bezpośrednio w Twoim terminalu. Odczytuje Twoją bazę kodu, pisze kod, uruchamia polecenia i obsługuje złożone edycje wieloplikowe – wszystko z poziomu jednego CLI.
W przeciwieństwie do narzędzi czatu AI opartych na przeglądarce, Claude Code działa wewnątrz Twojego rzeczywistego środowiska programistycznego. Widzi strukturę plików, rozumie kontekst projektu i wprowadza zmiany w rzeczywistych plikach na Twojej maszynie.
Ten przewodnik przeprowadzi Cię przez każdy krok instalacji Claude Code w 2026 roku, od sprawdzenia wymagań wstępnych po uruchomienie pierwszej sesji kodowania wspomaganej przez AI. Niezależnie od tego, czy korzystasz z macOS, Linux czy Windows, uruchomisz Claude Code w mniej niż pięć minut.
Co jest potrzebne (Lista wymagań wstępnych)
Przed instalacją Claude Code potwierdź, że posiadasz następujące elementy:
- System operacyjny: macOS 13.0 (Ventura) lub nowszy, Ubuntu 20.04+ lub Debian 10+, lub Windows 10 (wersja 1809+) z WSL
- RAM: Co najmniej 4GB (8GB zalecane dla większych baz kodu)
- Połączenie internetowe: Claude Code łączy się z chmurowym API Anthropic, więc wymagane jest aktywne połączenie
- Konto Anthropic: Konto Claude Pro ($20/miesiąc), Claude Max ($100-200/miesiąc), Teams, Enterprise lub Console (API)
- Terminal: Bash, Zsh lub PowerShell
- Node.js 18+ (wymagane tylko dla metody instalacji przez npm)
Nie potrzebujesz GPU. Całe przetwarzanie AI odbywa się na serwerach Anthropic. Twoja maszyna musi jedynie uruchamiać klienta CLI i wysyłać żądania przez sieć.
Krok 1: Zainstaluj Node.js (jeśli go nie masz)
Jeśli planujesz użyć metody instalacji przez npm, potrzebujesz Node.js w wersji 18 lub wyższej. Jeśli masz już zainstalowany Node.js, sprawdź swoją wersję:
node --version
Jeśli wynik pokazuje v18.0.0 lub nowszą wersję, przejdź do Kroku 2. Jeśli nie, zainstaluj lub zaktualizuj Node.js używając nvm (Node Version Manager), co jest zalecanym podejściem, ponieważ pozwala uniknąć problemów z uprawnieniami i umożliwia łatwe przełączanie się między wersjami Node.
Zainstaluj nvm na macOS lub Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Zamknij i otwórz ponownie terminal, a następnie zainstaluj Node.js:
nvm install 22
nvm use 22
node --version
Powinieneś zobaczyć numer wersji zaczynający się od v22. Node.js 22 jest obecnym wydaniem LTS i działa idealnie z Claude Code.
Zainstaluj Node.js na Windows (wewnątrz WSL):
Najpierw upewnij się, że WSL jest zainstalowany (zobacz sekcję Windows poniżej). Następnie otwórz terminal WSL i uruchom te same polecenia nvm co powyżej.
Krok 2: Zainstaluj Claude Code
Masz dwie opcje instalacji Claude Code. Natywny instalator jest obecnie zalecaną metodą, ale npm pozostaje w pełni wspierany.
Opcja A: Natywny instalator (Zalecane)
Natywny instalator nie wymaga żadnych zależności – ani Node.js, ani npm. Aktualizuje się automatycznie w tle i jest główną metodą testowaną i wspieraną przez Anthropic.
macOS i Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, jako Administrator):
irm https://claude.ai/install.ps1 | iex
Instalator pobiera plik binarny Claude Code, umieszcza go w Twojej PATH i konfiguruje automatyczne aktualizacje. Cały proces zajmuje mniej niż minutę.
Opcja B: Instalacja przez npm
Jeśli wolisz npm – na przykład, aby przypiąć konkretną wersję lub ponieważ npm jest standardem w Twoim przepływie pracy – uruchom:
npm install -g @anthropic-ai/claude-code
Ważne: Nie używaj sudo z npm install. Jeśli wystąpią błędy uprawnień, poprawnym rozwiązaniem jest użycie nvm (który instaluje Node.js w Twoim katalogu domowym) zamiast uruchamiania npm jako root.
Weryfikacja instalacji
Niezależnie od wybranej metody, sprawdź, czy Claude Code jest zainstalowany:
claude --version
Powinieneś zobaczyć numer wersji. Możesz również uruchomić wbudowaną diagnostykę:
claude doctor
To polecenie sprawdza Twoje środowisko i zgłasza wszelkie problemy z konfiguracją.
Krok 3: Uwierzytelnij
Claude Code wymaga uwierzytelnienia przed użyciem. Uruchom:
claude
Przy pierwszym uruchomieniu tego polecenia Claude Code otworzy Twoją domyślną przeglądarkę internetową i poprosi o zalogowanie się do konta Anthropic. Postępuj zgodnie z instrukcjami, aby autoryzować CLI.
Opcje uwierzytelniania
Logowanie przez przeglądarkę (domyślne): Najlepsze dla maszyn osobistych. Claude Code otwiera okno przeglądarki, logujesz się, a CLI automatycznie otrzymuje token uwierzytelniający. Działa to z kontami Claude Pro, Max, Teams i Enterprise.
Klucz API (dla CI/CD i automatyzacji): Jeśli uruchamiasz Claude Code w środowisku bezinterfejsowym (headless) lub potoku CI/CD, ustaw swój klucz API jako zmienną środowiskową:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Możesz wygenerować klucz API w Anthropic Console. Użycie API jest rozliczane za tokens według opublikowanych stawek Anthropic.
Subskrypcja vs rozliczanie API: Z subskrypcją Pro lub Max, korzystanie z Claude Code jest wliczone w Twój miesięczny plan (z zastrzeżeniem limitów użycia). Z kluczem API z Console płacisz za każdy token. Wybierz opcję na podstawie wolumenu użycia – subskrypcje są prostsze przy regularnym użytkowaniu, podczas gdy rozliczanie API daje większą kontrolę przy zmiennych lub zautomatyzowanych obciążeniach pracy.
Krok 4: Twój pierwszy projekt
Teraz, gdy Claude Code jest zainstalowany i uwierzytelniony, wypróbuj go na rzeczywistym projekcie.
Przejdź do dowolnego katalogu projektu:
cd ~/my-project
Uruchom Claude Code:
claude
Jesteś teraz w sesji interaktywnej. Claude Code odczytał strukturę Twojego projektu i jest gotowy do pomocy. Spróbuj zadać mu zadanie:
> Wyjaśnij architekturę tego projektu
Claude Code przeskanuje Twoje pliki, zidentyfikuje stos technologiczny i poda podsumowanie tego, jak zorganizowany jest projekt.
Spróbuj czegoś bardziej praktycznego:
> Dodaj walidację danych wejściowych do formularza rejestracji użytkownika
Claude Code zidentyfikuje odpowiednie pliki, zaproponuje zmiany i poprosi o potwierdzenie przed zmodyfikowaniem czegokolwiek. Przeglądasz każdą zmianę w widoku diff i akceptujesz ją lub odrzucasz.
Dla jednorazowego zadania bez wchodzenia w tryb interaktywny, użyj flagi -p:
claude -p "Napisz testy jednostkowe dla modułu auth"
To polecenie wykona zadanie, wyświetli wynik i zakończy działanie – przydatne w skryptach i przy szybkich pytaniach.
Krok 5: Podstawowa konfiguracja
Claude Code działa od razu po wyjęciu z pudełka z rozsądnymi ustawieniami domyślnymi, ale możesz dostosować jego zachowanie do swojego przepływu pracy.
Wybór modelu
Claude Code domyślnie używa najnowszego modelu Claude. Aby określić inny model:
claude config set model claude-opus-4-6
Lub dla pojedynczej sesji:
claude --model claude-sonnet-4-20250514
Uprawnienia
Claude Code prosi o potwierdzenie przed wykonaniem potencjalnie destrukcyjnych działań, takich jak zapisywanie plików czy uruchamianie poleceń powłoki. Możesz skonfigurować to zachowanie:
claude config set permissions.auto-accept-edits true
Ustawienia na poziomie projektu
Utwórz plik .claude/settings.json w głównym katalogu projektu, aby zdefiniować konfigurację współdzieloną przez zespół:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Ten plik powinien zostać przesłany do systemu kontroli wersji, aby cały zespół korzystał z tego samego zachowania Claude Code.
Dla osobistych nadpisań, które nie powinny być przesyłane do repozytorium, użyj zamiast tego .claude/settings.local.json.
Konfiguracja serwera MCP
Claude Code wspiera serwery Model Context Protocol (MCP) w celu rozszerzenia swoich możliwości. Skonfiguruj je w .mcp.json w głównym katalogu projektu:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Instalacja w różnych środowiskach
macOS
Natywny instalator to najprostsza ścieżka na macOS. Wspierane są zarówno maszyny Apple Silicon (M1/M2/M3/M4), jak i te z procesorami Intel:
curl -fsSL https://claude.ai/install.sh | bash
Alternatywnie, Claude Code jest dostępny przez Homebrew:
brew install --cask claude-code
Linux
Działa na Ubuntu 20.04+, Debian 10+ oraz większości nowoczesnych dystrybucji:
curl -fsSL https://claude.ai/install.sh | bash
Jeśli korzystasz ze starszej dystrybucji, użyj metody npm z nvm, aby uniknąć problemów z zależnościami na poziomie systemu.
Windows (WSL)
Claude Code na Windows wymaga WSL lub Git for Windows. WSL jest zalecanym podejściem:
- Otwórz PowerShell jako Administrator i zainstaluj WSL:
wsl --install
-
Zrestartuj komputer po wyświetleniu monitu.
-
Otwórz terminal WSL (domyślnie Ubuntu) i zainstaluj Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Alternatywnie, możesz użyć natywnego instalatora Windows bezpośrednio w PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
W środowiskach skonteneryzowanych dodaj Claude Code do swojego Dockerfile:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
W przypadku potoków CI/CD przekazuj klucz API w czasie uruchamiania, zamiast umieszczać go na stałe w obrazie:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Uruchom zestaw testów i napraw wszelkie błędy"
Potoki CI/CD
Tryb bezinterfejsowy Claude Code (flaga -p) jest zaprojektowany do automatyzacji. Oto przykład GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Przejrzyj zmiany w tym PR i zasugeruj ulepszenia" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Flaga --output-format json zwraca ustrukturyzowany wynik, który może być przetwarzany przez kolejne kroki.
Aktualizacja Claude Code
Natywny instalator
Jeśli zainstalowałeś Claude Code za pomocą natywnego instalatora, aktualizacje odbywają się automatycznie w tle. Nie jest wymagane żadne działanie. Możesz skonfigurować kanał aktualizacji:
claude config set update-channel stable
Aby sprawdzić obecną wersję:
claude --version
npm
Jeśli zainstalowałeś przez npm, wykonaj aktualizację ręcznie:
npm update -g @anthropic-ai/claude-code
Lub zainstaluj konkretną wersję:
npm install -g @anthropic-ai/claude-code@latest
Integracja z IDE
Mimo że Claude Code to narzędzie przede wszystkim terminalowe, integruje się bezpośrednio z popularnymi IDE dla bardziej wizualnego doświadczenia.
Rozszerzenie VS Code
Rozszerzenie VS Code zapewnia natywny interfejs graficzny dla Claude Code wewnątrz edytora. Zawiera panel czatu, cofanie oparte na punktach kontrolnych, odniesienia do plików za pomocą symbolu @ oraz możliwość prowadzenia wielu rozmów w równoległych zakładach.
Aby zainstalować, otwórz VS Code i wyszukaj „Claude Code” w panelu Rozszerzenia lub uruchom:
code --install-extension anthropic.claude-code
Po zainstalowaniu możesz otworzyć panel Claude Code z paska bocznego i wchodzić z nim w interakcję tak samo jak w wersji terminalowej, ale z dodatkową korzyścią w postaci widoku diff renderowanego w natywnej przeglądarce różnic VS Code.
Wtyczka JetBrains
Dla IntelliJ IDEA, PyCharm, WebStorm, GoLand i innych IDE JetBrains, zainstaluj wtyczkę Claude Code z JetBrains Marketplace:
- Otwórz swoje IDE JetBrains
- Przejdź do Settings, następnie Plugins, a potem Marketplace
- Wyszukaj „Claude Code”
- Kliknij Install i zrestartuj IDE
Wtyczka JetBrains uruchamia CLI Claude Code wewnątrz zintegrowanego terminala IDE i otwiera proponowane zmiany w przeglądarce diff edytora. Obecnie znajduje się w fazie beta, ale jest w pełni funkcjonalna do codziennego użytku.
Rozwiązywanie problemów
„command not found: claude”
Plik binarny Claude Code nie znajduje się w Twojej PATH. Jeśli użyłeś natywnego instalatora, spróbuj otworzyć nowe okno terminala. Jeśli to nie pomoże, uruchom skrypt instalacyjny ponownie. W przypadku instalacji przez npm upewnij się, że Twój globalny katalog bin npm znajduje się w PATH:
npm config get prefix
Dodaj podkatalog bin tej ścieżki do zmiennej PATH swojej powłoki.
„Node.js version too old”
Claude Code wymaga Node.js 18+. Sprawdź swoją wersję za pomocą node --version. Jeśli jest niższa niż 18, zainstaluj nowszą wersję używając nvm:
nvm install 22
nvm use 22
Błędy uprawnień npm (EACCES)
Nigdy nie używaj sudo npm install -g. Zamiast tego napraw domyślny katalog npm lub użyj nvm, który instaluje wszystko w Twoim katalogu domowym i całkowicie unika konfliktów uprawnień:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Uwierzytelnianie nie udaje się lub przeglądarka się nie otwiera
Jeśli logowanie przez przeglądarkę nie działa (częste na zdalnych serwerach lub WSL), możesz zamiast tego uwierzytelnić się za pomocą klucza API:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Wygeneruj swój klucz API na console.anthropic.com.
„Network Error” lub przekroczenie czasu podczas instalacji
Twoja sieć lub firewall mogą blokować npm lub natywny instalator. Spróbuj:
npm config set registry https://registry.npmjs.org/
Jeśli jesteś za korporacyjnym proxy, skonfiguruj npm, aby go używał:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code działa powoli
Sam Claude Code jest lekki – powolne działanie zazwyczaj oznacza opóźnienia sieciowe do API Anthropic. Sprawdź swoje połączenie internetowe. Jeśli korzystasz z VPN, spróbuj go rozłączyć. Możesz również sprawdzić status API na status.anthropic.com.
Następne kroki
Masz zainstalowany, uwierzytelniony i działający Claude Code. Oto co możesz zrobić dalej:
- Poznaj przepływ pracy: Przeczytaj nasz tutorial Claude Code, aby zgłębić strategie promptowania, edycję wieloplikową i wyciągnąć jak najwięcej z programowania wspomaganego przez AI.
- Porównaj swoje opcje: Zobacz, jak Claude Code wypada w naszym porównaniu Claude Code vs Cursor, jeśli decydujesz między narzędziami do kodowania AI.
- Odkryj zaawansowane funkcje: Claude Code wspiera serwery MCP, niestandardowe hooki, automatyzację headless i konfiguracje wielomodelowe. Oficjalna dokumentacja szczegółowo opisuje te zagadnienia.
Claude Code to najszybszy sposób na wprowadzenie AI do istniejącego przepływu pracy bez zmiany narzędzi i opuszczania terminala. Teraz, gdy jest już zainstalowany, zacznij od małego zadania w rzeczywistym projekcie – od razu zobaczysz różnicę.
