Seria tutoriali Claude Code 5: Jak zainstalować Claude Code?

Jak zainstalować Claude Code

Instalacja Claude Code nie ma graficznego interfejsu "dalej", wszystko odbywa się w wierszu poleceń. Jeśli zwykle używasz npm, cały proces zajmie nie więcej niż dwie minuty.

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

Node.js 18 lub nowszy
Sprawdź: w terminalu wpisz node -v. Jeśli wersja jest niższa niż 18, zaktualizuj za pomocą nvm, fnm lub pobierz ze strony nodejs.org.
Konto Anthropic
Rejestracja na https://console.anthropic.com. Konto zapewni klucz API, który będzie potrzebny po instalacji. Rejestracja jest bezpłatna, a koszty naliczane są według użycia.
Dostęp sieciowy do punktów końcowych API Anthropic
Domyślna domena to api.anthropic.com. Jeśli środowisko wymaga proxy, ustaw w terminalu zmienne HTTP_PROXY lub HTTPS_PROXY.

Sposób 1: Instalacja globalna npm

To najczęstszy sposób – instalujesz raz i używasz wszędzie.

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

Po zakończeniu wykonaj claude --version. Jeśli wyświetli się numer wersji, instalacja się powiodła. Po globalnej instalacji polecenie claude jest dostępne w każdym katalogu.

Jeśli wystąpi błąd uprawnień (częsty w macOS w katalogu /usr/local/lib), są dwa rozwiązania:

Użyj sudo do instalacji (wygodne, ale budzi wątpliwości bezpieczeństwa).
Skonfiguruj npm, aby używał katalogu użytkownika, unikając sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Następnie dodaj ~/.npm-global/bin do zmiennej PATH i uruchom ponownie terminal.

Sposób 2: Użycie npx (bez instalacji)

Jeśli nie chcesz instalować niczego globalnie lub tylko chcesz wypróbować, npx jest prostszy.

npx @anthropic-ai/claude-code

npx tymczasowo pobierze najnowszy pakiet, uruchomi go i nie pozostawi żadnego globalnego polecenia. Każde użycie sprawdza aktualizacje, więc zawsze masz najnowszą wersję. Wadą jest nieco wolniejsze działanie (pobieranie za każdym razem) i nie nadaje się do częstego wywoływania w skryptach.

Pasuje do: pierwszego zapoznania się, tymczasowego użycia na cudzym komputerze lub sporadycznego użytku.

Weryfikacja uruchomienia

Po instalacji nie spiesz się z uwierzytelnianiem. Uruchom proste polecenie, aby sprawdzić, czy narzędzie działa:

claude --help

Jeśli wyświetli się pomoc, plik binarny jest poprawny. Następnym krokiem jest połączenie z kontem – o tym później.

Niezależnie od wybranej metody, podstawowa wersja jest taka sama, a dalsze uwierzytelnianie i użytkowanie są identyczne. Wybierz tę, która Ci odpowiada.

Często zadawane pytania

Zbyt niska wersja Node
Wersja poniżej 18 spowoduje błąd, a nie ostrzeżenie. Aktualizacja Node to najprostsze rozwiązanie.
Przekroczenie czasu sieciowego
Zarówno pobieranie npm, jak i późniejsze połączenie z API mogą być blokowane przez proxy lub zaporę. Najpierw sprawdź, czy curl https://api.anthropic.com działa.
Windows – używanie natywnego cmd
Choć teoretycznie możliwe, zaleca się użycie Git Bash, WSL2 lub Windows Terminal, aby uniknąć dziwnych problemów z transliteracją ścieżek.