Szybkie podsumowanie: Claude Code CLI jest instalowany za pomocą pojedynczej komendy, która automatycznie pobiera i konfiguruje narzędzie. Na macOS i Linux użyj oficjalnego skryptu powłoki z dokumentacji Anthropic’s, podczas gdy użytkownicy Windows uruchamiają polecenia PowerShell lub WSL. Po instalacji uwierzytelnij się za pomocą swojego klucza API, aby zacząć korzystać z asystenta kodowania AI Claude’a w swoim terminalu.
Claude Code to agentowe narzędzie do kodowania, które działa w Twoim terminalu i rozumie cały Twój kod źródłowy. Według oficjalnej dokumentacji Claude Code, może ono czytać pliki, wykonywać polecenia, edytować kod i integrować się z narzędziami deweloperskimi za pomocą rozmów w języku naturalnym.
Ale rozpoczęcie pracy wymaga prawidłowej instalacji. Oto wszystko, co potrzebne do zainstalowania Claude Code CLI i jego poprawnej konfiguracji.
Wymagania systemowe przed instalacją
Przed zainstalowaniem Claude Code upewnij się, że system spełnia podstawowe wymagania. Zgodnie z oficjalną dokumentacją zaawansowanej konfiguracji, usuń to zdanie całkowicie.
Sprawdź instalację Node.js, otwierając terminal i wpisując:
| node –version |
Jeśli Node.js nie jest zainstalowany lub jego wersja jest niższa niż 18, pobierz go z oficjalnej strony Node.js. Wersja Long-Term Support (LTS) działa doskonale z Claude Code.
Oprócz Node.js, system wymaga podstawowych wymagań: macOS 13.0 lub nowszy dla użytkowników Mac, Windows 10 lub nowszy dla systemów Windows, a większość nowoczesnych dystrybucji Linux działa bez problemów. Do uwierzytelnienia po instalacji wymagane jest również konto Claude od Anthropic.
Instalacja Claude Code na macOS i Linux
Proces instalacji na macOS i Linux wykorzystuje pojedynczą komendę powłoki, która automatycznie obsługuje wszystko. Ta metoda jest udokumentowana w oficjalnym przewodniku szybkim startem Claude Code.
Otwórz Terminal i uruchom skrypt instalacyjny:
| curl -fsSL claude.ai/install.sh | bash |
Skrypt pobiera plik wykonywalny Claude Code, umieszcza go we właściwym katalogu i automatycznie konfiguruje ścieżkę PATH. Cały proces zazwyczaj kończy się w ciągu minuty.
Dla użytkowników macOS, którzy preferują Homebrew, istnieje alternatywna metoda instalacji, choć nie jest ona oficjalnie udokumentowana w głównych źródłach. Metoda curl pozostaje zalecanym podejściem zgodnie z oficjalną dokumentacją.
Weryfikacja instalacji
Po zakończeniu instalacji sprawdź, czy Claude Code jest dostępny:
| claude –version |
Ta komenda powinna wyświetlić numer zainstalowanej wersji. Jeśli pojawi się błąd typu „command not found”, konfiguracja PATH wymaga dostosowania.
Według oficjalnej dokumentacji rozwiązywania problemów, problemy z PATH są najczęstszym problemem instalacyjnym. Rozwiązanie polega na dodaniu katalogu instalacyjnego Claude do pliku konfiguracyjnego powłoki.
Instalacja Claude Code na macOS i Linux
Proces instalacji na macOS i Linux opiera się na npm (Node Package Manager). Według oficjalnej dokumentacji, przed przystąpieniem do pracy musisz mieć zainstalowany Node.js w wersji 18+ na swoim systemie. W przeciwieństwie do tradycyjnych narzędzi CLI używających skryptów powłoki, Claude Code jest instalowany globalnie przez terminal, aby zapewnić prawidłowe zarządzanie wszystkimi zależnościami.
Otwórz swój Terminal i uruchom następującą komendę, aby zainstalować pakiet:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Uwaga: Zmienna środowiskowa CLAUDE_CODE_RELEASE_ALPHA=1 jest obecnie wymagana podczas publicznej fazy beta/alfa, aby potwierdzić status podglądu narzędzia.
Ta komenda pobiera pakiet z oficjalnego rejestru npm i linkuje plik wykonywalny claude do globalnego katalogu bin swojego systemu. Chociaż niektórzy użytkownicy mogą próbować znaleźć formuły Homebrew, metoda npm jest jedyną oficjalnie wspieraną i udokumentowaną ścieżką instalacji.
Weryfikacja instalacji
Po zakończeniu instalacji sprawdź, czy CLI jest poprawnie zmapowany do Twojego środowiska, uruchamiając:
| claude –version |
Ta komenda powinna wyświetlić aktualny numer wersji (np. 0.2.9). Jeśli napotkasz błąd „command not found”, zazwyczaj oznacza to, że globalny katalog npm nie znajduje się w ścieżce PATH systemu.
Według oficjalnej dokumentacji rozwiązywania problemów, możesz to naprawić, identyfikując swój prefiks npm za pomocą polecenia npm config get prefix i upewniając się, że powstały folder /bin zostanie dodany do Twojego pliku .zshrc lub .bashrc.
Instalacja Claude Code na Windows
Instalacja w systemie Windows oferuje dwa główne podejścia: natywną instalację PowerShell lub użycie Windows Subsystem for Linux (WSL). Oficjalna dokumentacja zaleca PowerShell dla większości użytkowników.
Metoda instalacji przez PowerShell
Otwórz PowerShell jako Administrator (kliknij prawym przyciskiem myszy na menu Start i wybierz „Windows PowerShell (Admin)”"). Uruchom następującą komendę:
| irm claude.ai/install.ps1 | iex |
Skrypt PowerShell automatycznie obsługuje pobieranie, instalację i konfigurację PATH. Po zakończeniu zamknij i ponownie otwórz PowerShell, aby upewnić się, że aktualizacje PATH zostały zastosowane.
Metoda instalacji przez WSL
Deweloperzy korzystający już z WSL mogą zainstalować Claude Code za pomocą metody dla systemu Linux. Otwórz terminal WSL i uruchom tę samą komendę curl, która jest używana w systemie Linux:
| curl -fsSL claude.ai/install.sh | bash |
Podejście WSL działa identycznie jak natywne instalacje w systemie Linux. Jedna z zalet: WSL zapewnia środowisko bardziej zbliżone do Unix, które odpowiada konfiguracjom serwerów produkcyjnych.
Według oficjalnej dokumentacji rozwiązywania problemów, użytkownicy WSL czasami napotykają problemy z łącznością sieciową. Jeśli instalacja się zawiesi, sprawdź, czy WSL ma dostęp do sieci zewnętrznych i czy reguły zapory sieciowej nie blokują ruchu.
Znajdź kredyty na narzędzia Claude i AI w jednym miejscu
Instalacja Claude Code CLI to jeden krok. Długoterminowe płacenie za narzędzia AI to inny. Get AI Perks gromadzi kredyty startowe i zniżki na oprogramowanie dla narzędzi AI i chmurowych w jednym miejscu. Zapewnia założycielom dostęp do ponad 200 ofert, w tym od Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom i innych. Platforma pokazuje również warunki ofert i przewodniki po sposobach ich uzyskania.
Szukasz kredytów na Claude lub Anthropic?
Sprawdź Get AI Perks, aby:
- znaleźć kredyty i zniżki na narzędzia AI w jednym miejscu
- przejrzeć warunki ofert przed ich złożeniem
- uzyskać dostęp do przewodników po sposobach uzyskania ofert dla startupów
👉 Odwiedź Get AI Perks, aby przejrzeć dostępne oferty na narzędzia Claude, Anthropic i inne oprogramowanie AI.
Uwierzytelnianie i początkowa konfiguracja
Po instalacji Claude Code wymaga uwierzytelnienia, zanim zacznie działać. Narzędzie wykorzystuje klucze API od Anthropic do weryfikacji dostępu.
Rozpocznij proces uwierzytelniania, wpisując:
| claude |
Przy pierwszym uruchomieniu tej komendy, Claude Code poprosi o uwierzytelnienie. Według oficjalnego przewodnika szybkiego startu, otworzy się okno przeglądarki do zalogowania się do konta Anthropic.
Po zalogowaniu przez przeglądarkę, CLI automatycznie otrzyma token uwierzytelniający. Token ten jest przechowywany lokalnie i pozostaje aktywny między sesjami, więc powtarzające się uwierzytelnianie nie jest konieczne.
Konfiguracja ustawień na poziomie projektu
Claude Code obsługuje konfigurację na wielu poziomach, zgodnie z oficjalną dokumentacją ustawień. Najczęstsze poziomy konfiguracji to:
| Zakres | Lokalizacja | Przypadek użycia |
|---|---|---|
| Użytkownik | ~/.claude/ directory | Preferencje osobiste dla wszystkich projektów |
| Projekt | .claude/ w repozytorium | Wspólna konfiguracja zespołowa |
| Lokalny | .claude/settings.local.json | Nadpisania specyficzne dla maszyny |
Przy pierwszym uruchomieniu wystarczy konfiguracja na poziomie użytkownika. Ustawienia na poziomie projektu stają się ważne podczas pracy z zespołami, które dzielą standardy kodowania.
Rozpoczęcie pierwszej sesji Claude Code
Po zakończeniu instalacji i uwierzytelnienia, uruchom Claude Code, wpisując komendę bez argumentów:
| claude |
To rozpoczyna tryb interaktywny, w którym Claude odpowiada na żądania w języku naturalnym. Oficjalna dokumentacja opisuje tryb interaktywny jako główny sposób korzystania z Claude Code w zadaniach deweloperskich.
Wypróbuj prostą komendę testową:
| Pokaż mi strukturę tego projektu |
Claude Code analizuje bieżący katalog i przedstawia ogólny zarys struktury kodu. To pokazuje, że instalacja działa poprawnie i Claude ma dostęp do odczytu plików.
Niezbędne komendy do codziennego użytku
Oprócz trybu interaktywnego, Claude Code obsługuje kilka wzorców komend udokumentowanych w dokumentacji CLI:
| Wzorzec komendy | Przeznaczenie | Przykład |
|---|---|---|
| claude | Uruchom sesję interaktywną | claude |
| claude “zadanie” | Uruchom jednorazowe zadanie | claude “napraw błędy lintowania” |
| claude -p “zapytanie” | Szybkie zapytanie bez sesji | claude -p “co robi ta funkcja” |
Wzorzec jednorazowego zadania jest szczególnie przydatny w potokach CI/CD i skryptach automatyzacji, gdzie sesja interaktywna nie jest odpowiednia.
Typowe problemy z instalacją i ich rozwiązywanie
Nawet przy zautomatyzowanych skryptach instalacyjnych, problemy czasami występują. Oficjalna dokumentacja rozwiązywania problemów obejmuje najczęstsze problemy.
Błędy „Command Not Found”
Jeśli po instalacji terminal wyświetla komunikat „command not found: claude”, konfiguracja PATH nie została ukończona poprawnie. W systemach macOS i Linux dodaj lokalizację pliku wykonywalnego Claude do pliku konfiguracyjnego powłoki ręcznie.
Dla użytkowników bash, edytuj ~/.bashrc lub ~/.bash_profile i dodaj:
| export PATH=”$HOME/.local/bin:$PATH” |
Dla użytkowników zsh (domyślnie w nowoczesnych macOS), edytuj ~/.zshrc z tą samą linią. Po zapisaniu, przeładuj konfigurację poleceniem source ~/.zshrc lub otwórz nowe okno terminala.
Problemy z siecią i zaporą ogniową
Sieci korporacyjne i restrykcyjne zapory sieciowe czasami blokują skrypt instalacyjny. Zgodnie z dokumentacją rozwiązywania problemów, jeśli instalacja się zawiesza lub zwraca HTML zamiast wykonywać polecenia, dostęp do serwerów Anthropic może być zablokowany.
Rozwiązaniem jest pobranie skryptu instalacyjnego osobno:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
To podejście zapewnia większą przejrzystość, jeśli wystąpią błędy podczas pobierania lub wykonywania.
Problemy specyficzne dla WSL
Użytkownicy Windows korzystający z WSL czasami napotykają problemy z łącznością między podsystemem Linux a systemem Windows. Oficjalna dokumentacja wspomina, że reguły zapory sieciowej mogą wymagać dostosowania, aby zezwolić na ruch WSL.
Jeśli Claude Code zainstaluje się pomyślnie, ale nie może nawiązać połączenia z serwerami Anthropic w celu uwierzytelnienia, sprawdź, czy zapora sieciowa systemu Windows zezwala na dostęp sieciowy WSL. Przewodnik po rozwiązywaniu problemów zawiera konkretne polecenia PowerShell do konfiguracji reguł zapory sieciowej.
Aktualizacja Claude Code
Claude Code otrzymuje regularne aktualizacje z nowymi funkcjami i usprawnieniami. Według oficjalnej dokumentacji, aktualizacje są instalowane za pomocą tej samej komendy, co instalacja początkowa.
Uruchom ponownie skrypt instalacyjny:
| curl -fsSL code.anthropic.com/install.sh | sh |
Skrypt wykrywa istniejącą instalację i aktualizuje ją do najnowszej wersji. Żadna konfiguracja ani uwierzytelnienie nie są tracone podczas procesu aktualizacji.
Sprawdź aktualną wersję przed i po aktualizacji:
| claude –version |
Lista zmian w oficjalnej dokumentacji Claude Code zawiera wszystkie zmiany między wersjami, co pomaga określić, czy aktualizacja wprowadza funkcje istotne dla określonych przepływów pracy.
Następne kroki po instalacji
Po zainstalowaniu i skonfigurowaniu Claude Code, staje się możliwe eksplorowanie zaawansowanych funkcji. Oficjalna dokumentacja opisuje kilka obszarów, które warto zbadać:
- Umiejętności i personalizacja: Zgodnie z oficjalną dokumentacją umiejętności, Claude Code obsługuje niestandardowe umiejętności zdefiniowane w plikach Markdown w katalogu .claude/skills/. Te umiejętności rozszerzają możliwości Claude o polecenia i przepływy pracy specyficzne dla projektu.
- Model Context Protocol (MCP): Integracja MCP pozwala Claude Code na połączenie z zewnętrznymi narzędziami i usługami. Zamienia to Claude w centrum, które może uzyskiwać dostęp do baz danych, API i innych zasobów deweloperskich.
- Współpraca zespołowa: Pliki konfiguracyjne na poziomie projektu w katalogu .claude/ mogą być zatwierdzane w systemie kontroli wersji, udostępniając ustawienia Claude Code całym zespołom deweloperskim.
- Oficjalna dokumentacja zawiera szczegółowe przewodniki po każdym z tych obszarów, bazując na podstawowej instalacji omówionej tutaj.
Często zadawane pytania
Czy potrzebuję płatnej subskrypcji Claude, aby korzystać z Claude Code CLI?
Claude Code wymaga konta Claude od Anthropic, ale wymagany poziom subskrypcji zależy od sposobu użycia. Według oficjalnej dokumentacji, uwierzytelnienie jest konieczne, ale szczegóły cenowe powinny być weryfikowane na oficjalnej stronie Anthropic, ponieważ plany zmieniają się z czasem.
Czy mogę zainstalować Claude Code bez uprawnień administratora?
Na macOS i Linux, Claude Code jest domyślnie instalowany w katalogu domowym użytkownika i nie wymaga uprawnień administratora. Użytkownicy Windows mogą potrzebować uprawnień administratora do metody instalacji PowerShell, chociaż instalacje WSL nie wymagają uprawnień administratora.
Czy Claude Code działa offline?
Nie. Claude Code to narzędzie oparte na AI, które komunikuje się z serwerami Anthropic w celu przetwarzania żądań. Według oficjalnej dokumentacji, do analizy kodu i generowania odpowiedzi przez Claude wymagane jest aktywne połączenie internetowe.
Jak odinstalować Claude Code?
Oficjalna dokumentacja zaawansowanej konfiguracji wyjaśnia, że odinstalowanie polega na usunięciu pliku wykonywalnego i plików konfiguracyjnych. W systemach macOS i Linux usuń katalog ~/.claude i usuń modyfikację PATH z plików konfiguracyjnych powłoki. Użytkownicy Windows powinni usunąć katalog instalacyjny i wyczyścić zmienną środowiskową PATH.
Czy Claude Code ma dostęp do mojego całego systemu plików?
Domyślnie Claude Code działa w obrębie bieżącego katalogu roboczego i jego podkatalogów. Zgodnie z oficjalną dokumentacją uprawnień, dostęp można dodatkowo ograniczyć za pomocą ustawień piaskownicy w plikach konfiguracyjnych. Claude zawsze prosi o potwierdzenie przed wykonaniem potencjalnie destrukcyjnych operacji.
Jaka jest różnica między Claude Code CLI a Claude Desktop?
Claude Code CLI działa w terminalu i skupia się na przepływach pracy deweloperskich z bezpośrednim dostępem do systemu plików i wykonywaniem poleceń. Claude Desktop to samodzielna aplikacja z graficznym interfejsem użytkownika. Oba narzędzia służą różnym zastosowaniom, przy czym CLI jest zoptymalizowany dla deweloperów preferujących przepływy pracy oparte na terminalu.
Jak często powinienem aktualizować Claude Code?
Aktualizacje można instalować, kiedy jest to wygodne. Oficjalna lista zmian dokumentuje nowe funkcje i poprawki błędów. W przypadku zespołów koordynowanie aktualizacji zapewnia, że wszyscy korzystają z kompatybilnych wersji, chociaż Claude Code utrzymuje wsteczną kompatybilność z plikami konfiguracyjnymi między wersjami.
Wnioski
Instalacja Claude Code CLI zajmuje zaledwie kilka minut, niezależnie od systemu operacyjnego. Zautomatyzowane skrypty instalacyjne obsługują konfigurację, ustawienie ścieżki PATH i umieszczenie plików wykonywalnych bez ręcznej interwencji.
Po instalacji i uwierzytelnieniu, Claude Code staje się potężnym asystentem kodowania AI dostępnym z każdego terminala. Komendy w języku naturalnym pozwalają deweloperom na pisanie kodu, naprawianie błędów i automatyzowanie zadań bez opuszczania linii poleceń.
Gotowy, by doświadczyć rozwoju wspomaganego przez AI? Uruchom komendę instalacyjną dla swojego systemu i rozpocznij pierwszą sesję Claude Code już dziś. Oficjalna dokumentacja pod adresem code.claude.com zawiera kompleksowe przewodniki po zaawansowanych funkcjach po zakończeniu podstawowej konfiguracji.
