Jak zainstalować Claude Code: Kompleksowy przewodnik (2026)

Krótkie podsumowanie: Claude Code można zainstalować za pomocą natywnych instalatorów na macOS, Windows i Linux ze strony oficjalnej Claude Code. Użytkownicy systemu Windows muszą najpierw zainstalować WSL2 przed uruchomieniem Claude Code. Po instalacji uwierzytelnij się za pomocą swojego konta Claude, gdy Claude Code otworzy okno przeglądarki, aby zalogować się przy pierwszym uruchomieniu, aby zacząć kodować z pomocą SI bezpośrednio z terminala lub aplikacji desktopowej.

Claude Code reprezentuje działania Anthropic w kierunku narzędzi do rozwoju agentów SI. Ten asystent wiersza poleceń odczytuje bazy kodu, edytuje pliki, uruchamia polecenia i integruje się z przepływami pracy deweloperów.

Jednak jego instalacja nie zawsze jest prosta. Różne platformy wymagają różnych podejść. Windows wymaga dodatkowej konfiguracji. A dokumentacja, choć kompleksowa, może przytłoczyć nowych użytkowników.

Ten przewodnik przechodzi przez złożoność. Obejmuje wymagania systemowe, specyficzne dla platformy kroki instalacji, uwierzytelnianie i weryfikację – wszystko, co jest potrzebne do prawidłowego uruchomienia Claude Code.

Wymagania systemowe przed instalacją

Według oficjalnej dokumentacji Claude Code, narzędzie obsługuje macOS, Windows i Linux. Jednak każda platforma ma specyficzne wymagania wstępne.

Dla macOS wymagania są minimalne. System potrzebuje macOS 13.0 lub nowszego. Zarówno procesory Intel, jak i Apple Silicon działają dobrze.

Windows stanowi większe wyzwanie. System operacyjny musi być Windows 10 Build 19041 lub nowszy, lub Windows 11. Ale jest haczyk – Claude Code nie działa natywnie na Windows.

Windows Subsystem for Linux 2 (WSL2) jest obowiązkowy. Tworzy to środowisko Linuksa, w którym faktycznie działa Claude Code. Bez WSL2 instalacja zakończy się niepowodzeniem.

Użytkownicy Linuksa potrzebują dystrybucji 64-bitowej. Oficjalna dokumentacja potwierdza wsparcie dla Ubuntu, Debiana, Fedory i innych głównych dystrybucji. Alpine Linux i systemy oparte na musl wymagają dodatkowej konfiguracji.

Wszystkie platformy potrzebują stabilnego połączenia internetowego podczas instalacji. Rozmiary pobierania są różne, ale zazwyczaj wahają się od 50 MB do 500 MB, w zależności od tego, co jest już zainstalowane.

Instalacja Claude Code na macOS

Proces instalacji na macOS wykorzystuje natywny instalator. Jest to najprostsza ścieżka spośród wszystkich platform.

Najpierw pobierz instalator ze oficjalnej strony Claude Code. Strona pobierania automatycznie wykrywa macOS i oferuje odpowiedni pakiet.

Otwórz pobrany plik .dmg. Przeciągnij aplikację Claude Code do folderu Aplikacje. Standardowa instalacja macOS – nic niezwykłego.

Niektórzy użytkownicy napotykają monit bezpieczeństwa przy pierwszym uruchomieniu. macOS domyślnie blokuje aplikacje od nieznanych deweloperów. Kliknij prawym przyciskiem myszy aplikację Claude Code i wybierz „Otwórz”, aby pominąć to jednorazowe ostrzeżenie.

Narzędzie wiersza poleceń instaluje się automatycznie wraz z aplikacją desktopową. Otwórz Terminal i wpisz `claude --version`, aby zweryfikować. Jeśli pojawi się numer wersji, instalacja zakończyła się powodzeniem.

Weryfikacja instalacji na macOS

Uruchom następujące polecenia, aby potwierdzić, że wszystko działa:

Oba polecenia powinny zwrócić dane wyjściowe bez błędów. Polecenie wersji wyświetla zainstalowaną wersję Claude Code. Polecenie pomocy wyświetla dostępne opcje i polecenia.

Utworzenie katalogu testowego pomaga zweryfikować pełną funkcjonalność. Przejdź do folderu projektu i uruchom `claude`, aby rozpocząć interaktywną sesję. Narzędzie powinno się zainicjalizować i wyświetlić monit o uwierzytelnienie, jeśli nie jesteś jeszcze zalogowany.

Instalacja w systemie Windows z WSL2

Instalacja w systemie Windows wymaga wielu kroków. Proces trwa dłużej niż na macOS, ale pozostaje wykonalny.

Najpierw należy zainstalować WSL2. Otwórz PowerShell jako administrator i uruchom:

To polecenie instaluje WSL2 i domyślnie Ubuntu. System będzie wymagał ponownego uruchomienia. Po ponownym uruchomieniu Ubuntu uruchamia się automatycznie, aby zakończyć początkową konfigurację.

Utwórz nazwę użytkownika i hasło systemu Unix, gdy zostaniesz o to poproszony. Te dane uwierzytelniające są oddzielne od danych logowania do systemu Windows.

Gdy WSL2 działa, stosuje się proces instalacji Linuksa. Otwórz terminal Ubuntu (zainstalowany z WSL2) i pobierz instalator Claude Code dla Linuksa.

Instalacja Claude Code w WSL2

Według oficjalnej dokumentacji, polecenie instalacji pobiera i uruchamia natywny instalator:

Ten skrypt automatycznie obsługuje zależności. Instaluje Node.js, jeśli jest potrzebny, konfiguruje binarny plik Claude Code i ustawia zmienne PATH.

Instalacja trwa kilka minut. Paski postępu i komunikaty o stanie wskazują, co się dzieje. Po zakończeniu zamknij i ponownie otwórz terminal, aby odświeżyć zmienne środowiskowe.

Testowanie instalacji przebiega tak samo jak na macOS. Uruchom `claude --version`, aby zweryfikować.

Proces instalacji w systemie Linux

Użytkownicy Linuksa mają najprostszy proces instalacji. Natywny instalator działa bezpośrednio bez dodatkowych warstw, takich jak WSL2.

Pobierz i uruchom skrypt instalacyjny:

To pobiera binarny plik Claude Code, instaluje zależności i konfiguruje środowisko powłoki. Skrypt wykrywa dystrybucję i odpowiednio się dostosowuje.

Dla systemów opartych na Ubuntu i Debianie skrypt konfiguruje instalację. Oficjalna dokumentacja potwierdza wsparcie dla Ubuntu 20.04+, Debian 10+ i innych dystrybucji.

Uwagi dotyczące Alpine Linux

Alpine Linux i dystrybucje oparte na musl wymagają dodatkowych kroków. Oficjalna dokumentacja zaznacza, że te systemy wymagają ręcznej konfiguracji.

Standardowy instalator może zakończyć się niepowodzeniem w Alpine. Zamiast tego pobierz binarny plik zgodny z musl bezpośrednio ze strony wydań. Rozpakuj go do katalogu w systemowym PATH, zazwyczaj /usr/local/bin.

Ustaw uprawnienia do wykonywania:

Użytkownicy Alpine powinni sprawdzić kompatybilność przed przystąpieniem do pracy. Niektóre funkcje mogą nie działać identycznie jak w dystrybucjach opartych na glibc.

Uwierzytelnianie i konfiguracja konta

Po zainstalowaniu Claude Code uruchom `claude` w terminalu. Przy pierwszym uruchomieniu Claude Code otworzy okno przeglądarki, aby się zalogować.

Otwiera to stronę uwierzytelniania Claude. Zaloguj się przy użyciu istniejącego konta Claude lub utwórz nowe.

Przeglądarka wyświetli kod autoryzacji. Skopiuj ten kod i wróć do terminala. Wklej kod, gdy zostaniesz o to poproszony.

Pomyślne uwierzytelnienie zapisuje dane uwierzytelniające lokalnie. Przyszłe sesje nie będą wymagały logowania, chyba że dane uwierzytelniające wygasną lub zostaną ręcznie usunięte.

Uwierzytelnianie zespołów i przedsiębiorstw

Według oficjalnej dokumentacji uwierzytelniania, zespoły korzystające z Claude for Teams lub Enterprise mają dodatkowe opcje. Organizacje mogą konfigurować uwierzytelnianie jednokrotnego logowania (SSO) lub uwierzytelnianie dostawcy chmury.

Konfiguracja SSO wymaga konfiguracji administratora. Poszczególni deweloperzy uwierzytelniają się następnie za pośrednictwem dostawcy tożsamości swojej organizacji, a nie indywidualnych kont Claude.

Uwierzytelnianie dostawcy chmury działa w przypadku wdrożeń AWS, Google Cloud i Azure. Ta metoda wykorzystuje istniejące dane uwierzytelniające chmury zamiast oddzielnych kont Claude.

Instalacja aplikacji desktopowej

Claude Code oferuje zarówno aplikacje wiersza poleceń, jak i aplikacje desktopowe. Aplikacja desktopowa zapewnia interfejs graficzny, zachowując pełną funkcjonalność terminala.

Pobierz instalator desktopowy z oficjalnej strony Claude. Strona oferuje wersje macOS, Windows i Windows ARM64. Wybierz odpowiednią wersję dla systemu.

Instalacja na macOS przebiega tak samo, jak opisano wcześniej za pomocą procesu .dmg. Użytkownicy systemu Windows mogą pobrać aplikację desktopową, aby uzyskać interfejs graficzny, bez konieczności konfiguracji WSL2.

Aplikacja desktopowa zawiera zintegrowany dostęp do terminala. Może uruchamiać sesje Claude Code bez przełączania się na zewnętrzne aplikacje terminalowe.

Jedną z zalet aplikacji desktopowej jest jej dostępność w tle. Według oficjalnej strony pobierania, aplikacja „pozostaje gotowa w tle” i można ją uruchomić z dowolnej aplikacji bez przełączania okien lub utraty fokusu.

Skorzystaj z Get AI Perks, aby znaleźć kredyty na swoją platformę Claude Code

Instalacja to łatwa część. Prawdziwy koszt zwykle pochodzi ze wszystkiego wokół: infrastruktury, narzędzi pomocniczych i płatnych usług używanych podczas konfiguracji i testowania. Get AI Perks może pomóc, udostępniając listę kredytów startowych i zniżek w jednym miejscu, wraz ze wskazówkami, jak je zastosować.

Dzięki Get AI Perks możesz:

• Znaleźć kredyty na narzędzia chmurowe i związane z SI
• Sprawdzić warunki ofert przed złożeniem wniosku
• Uniknąć marnowania czasu na oferty, do których możesz nie kwalifikować się
• Zmniejszyć koszt konfiguracji

Odwiedź Get AI Perks, aby sprawdzić, czy dostępne oferty pasują do narzędzi, których planujesz używać z Claude Code.

Rozszerzenia IDE i integracje

Oprócz samodzielnej instalacji, Claude Code integruje się z popularnymi środowiskami programistycznymi. Istnieją rozszerzenia dla Visual Studio Code i IDE JetBrains.

Rozszerzenie VS Code instaluje się poprzez marketplace. Wyszukaj „Claude Code” w panelu Rozszerzenia i kliknij „Zainstaluj”. Rozszerzenie wymaga wcześniejszej instalacji narzędzia wiersza poleceń.

Niektórzy użytkownicy zgłaszają problemy z dołączonym plikiem rozszerzenia VS Code. Jeśli automatyczna instalacja zakończy się błędem „End of central directory record signature not found”, dołączony plik .vsix może być uszkodzony.

Rozwiązaniem jest ręczna instalacja rozszerzenia z marketplace VS Code zamiast polegania na wersji dołączonej do linii poleceń. Oddziela to dwa komponenty i zapobiega konfliktom instalacji.

Integracja z JetBrains działa podobnie. Zainstaluj wtyczkę z marketplace JetBrains w IntelliJ IDEA, PyCharm, WebStorm lub innych produktach JetBrains.

Weryfikacja pomyślnej instalacji

Prawidłowa weryfikacja zapewnia, że Claude Code działa poprawnie przed rozpoczęciem faktycznych zadań programistycznych.

Podstawowa weryfikacja sprawdza dostępność poleceń:

Te polecenia powinny zostać wykonane bez błędów. Polecenie `help` wyświetla dostępne opcje. Polecenie `version` pokazuje zainstalowaną wersję.

Testowanie funkcjonalne wymaga rozpoczęcia sesji. Utwórz katalog testowy:

To inicjuje interaktywną sesję Claude Code. Narzędzie powinno przeanalizować katalog (w tym przypadku pusty) i wyświetlić monit.

Spróbuj wykonać proste polecenia w sesji. Wpisz `help`, aby zobaczyć dostępne akcje. Poproś o proste zadania, takie jak „utwórz plik README” lub „wyjaśnij, co potrafisz”.

Pomyślne odpowiedzi wskazują na prawidłową instalację. Jeśli wystąpią błędy, zazwyczaj są one związane z uwierzytelnianiem, łącznością sieciową lub brakującymi zależnościami.

Zarządzanie aktualizacjami i wersjami

Claude Code aktualizuje się automatycznie domyślnie. Oficjalna dokumentacja wyjaśnia, że narzędzie sprawdza nowe wersje i instaluje je bez interwencji użytkownika.

Zachowanie aktualizacji można skonfigurować za pomocą ustawień Claude Code. Oficjalna dokumentacja opisuje konfigurację kanałów wydawniczych i opcje ręcznej aktualizacji.

Ręczne aktualizacje wymagają ponownego uruchomienia skryptu instalacyjnego. To samo polecenie użyte do początkowej instalacji pobiera najnowszą wersję:

Instalacja określonych wersji jest możliwa do celów testowych lub zgodności. Zaawansowana dokumentacja konfiguracji obejmuje blokowanie wersji i konfigurację kanałów wydawniczych.

Kanały wydawnicze obejmują stabilne, beta i nocne. Stabilne są zalecane do pracy produkcyjnej. Kanały beta i nocne zapewniają wczesny dostęp do nowych funkcji, ale mogą zawierać błędy.

Typowe problemy z instalacją

Kilka problemów pojawia się często w dyskusjach społeczności na temat instalacji Claude Code.

Konfiguracja PATH powoduje wiele problemów. Jeśli polecenie `claude` nie zostanie znalezione po instalacji, katalog binarny nie znajduje się w systemowym PATH.

Na macOS i Linuksie dodanie katalogu do PATH zazwyczaj wiąże się z edycją plików konfiguracyjnych powłoki, takich jak ~/.bashrc, ~/.zshrc lub podobnych. Skrypt instalacyjny zazwyczaj obsługuje to automatycznie, ale ręczna weryfikacja pomaga w rozwiązywaniu problemów.

Użytkownicy systemu Windows w WSL2 mogą potrzebować zamknąć i ponownie otworzyć terminal po instalacji. Zmienne środowiskowe nie odświeżają się w istniejących sesjach.

Ograniczenia sieciowe blokują niektóre instalacje. Korporacyjne zapory sieciowe lub serwery proxy mogą uniemożliwić pobranie instalatora lub połączenie z serwerami uwierzytelniającymi.

Konfiguracja proxy wymaga zmiennych środowiskowych:

Błędy uprawnień występują podczas instalacji do chronionych katalogów. Instalator wymaga dostępu do zapisu w /usr/local/bin lub równoważnych lokalizacjach. Uruchomienie z sudo rozwiązuje ten problem, ale należy go unikać, chyba że jest to konieczne.

Często zadawane pytania

Pierwsze kroki po instalacji

Po zainstalowaniu i zweryfikowaniu Claude Code, następnym krokiem jest zrozumienie, jak go skutecznie używać.

Dokumentacja szybkiego startu zaleca rozpoczęcie od prostych zadań. Przejdź do istniejącego projektu i uruchom `claude`, aby rozpocząć interaktywną sesję.

Poproś Claude o wyjaśnienie struktury projektu. Poproś o podsumowanie tego, co robi baza kodu. Te zapytania eksploracyjne pomagają zrozumieć, jak narzędzie interpretuje kod.

Spróbuj wprowadzić drobne zmiany. Poproś Claude o dodanie komentarzy do funkcji, utworzenie prostych plików testowych lub refaktoryzację prostych bloków kodu. Te zadania demonstrują możliwości edycji bez ryzyka.

Integracja z Git działa automatycznie, jeśli projekt korzysta z kontroli wersji. Claude Code może tworzyć commity, wyjaśniać diffy i sugerować ulepszenia na podstawie zmian.

Oficjalna dokumentacja zawiera przykłady przepływów pracy dla typowych zadań programistycznych. Obejmują one naprawianie błędów, implementację funkcji, przegląd kodu i automatyczne testowanie.

Claude Code to ewoluujące narzędzie. Instalacja to tylko podstawa. Zrozumienie jego możliwości, ograniczeń i najlepszych praktyk wymaga eksperymentowania i praktyki.

Gotowy do zainstalowania Claude Code? Pobierz odpowiedni instalator dla swojej platformy z oficjalnej strony internetowej i postępuj zgodnie z krokami opisanymi w tym przewodniku. Uwierzytelnij się za pomocą swojego konta Claude, zweryfikuj poprawność działania instalacji i zacznij odkrywać rozwój wspomagany przez SI.