Jak zainstalować Claude Code z oficjalnej strony

Czym jest Claude Code i dlaczego działa w terminalu?#

Terminal przeraża niemal każdego, kto zaczyna przygodę z vibe codingiem bez doświadczenia w tworzeniu oprogramowania. Wygląda jak czarne okno z filmów o hakerach, ale w rzeczywistości to po prostu wiersz, w którym wpisuje się polecenia. Claude Code potrzebuje terminala właśnie po to, by móc otwierać i zmieniać Twoje pliki oraz samodzielnie uruchamiać kontrole, gdy opisujesz zadanie własnymi słowami.

Anthropic opisuje ten produkt w następujący sposób.

Różnica w porównaniu ze znanym czatem jest prosta. W przeglądarce ręcznie kopiujesz kod między oknem a edytorem. Claude Code sam przechodzi do folderu projektu, odczytuje potrzebne pliki, wprowadza zmiany i pokazuje, co zmienił. To Ty podejmujesz decyzje i zatwierdzasz zmiany; on wykonuje za Ciebie mechaniczne zadania.

Jeśli naprawdę nie chcesz korzystać z terminala, Anthropic oferuje aplikację desktopową ze zwykłym oknem oraz wersję internetową pod adresem claude.ai/code, działającą bezpośrednio w przeglądarce. Najpotężniejsza i najbardziej elastyczna jest jednak wersja terminalowa, której dotyczy cały ten artykuł.

Gdzie znajduje się oficjalna strona Claude Code i co pobrać?#

Pierwszą zagwozdką dla początkujących jest to, gdzie znajduje się oficjalna strona Claude Code i co kliknąć, aby pobrać program. Oto tabela ze wszystkimi oficjalnymi adresami Anthropic, dzięki której nie musisz zgadywać.

Nie pobierasz ze strony instalatora tak jak w przypadku zwykłego programu, co może być zaskakujące. Instalujesz go za pomocą polecenia terminalowego, które pobiera wersję odpowiednią dla Twojego systemu. W artykule znajdziesz dokładne polecenia dla Maca, Windowsa i Linuksa.

Częstą pułapką jest nazwa: wiele osób błędnie wpisuje clode code, clade code, слод код albo clode design. Produkt nazywa się Claude Code, z literami au. Pamiętaj o tym podczas szukania oficjalnej strony: domeny o podobnej pisowni należą do kogoś innego.

Warto też znać dokładną nazwę pakietu npm. Kanoniczny pakiet to @anthropic-ai/claude-code, z prefiksem @anthropic-ai/. Anthropic używa krótszej nazwy claude-code bez prefiksu jako oficjalnego odnośnika do tego samego pakietu. Prosta zasada: wydawcą powinien być Anthropic, a nazwa używana do instalacji powinna mieć prefiks.

Instalacja Claude Code CLI: jakie wymagania musi spełniać komputer?#

Wymagania Claude Code są niewielkie: najcięższe zadania wykonują serwery Anthropic; Twój komputer wysyła tylko żądania i odbiera odpowiedzi.

Osobna uwaga o Node.js, ponieważ narosło wokół niego najwięcej mitów. Instalator natywny — zalecany przez samo Anthropic — w ogóle nie wymaga Node.js: instaluje się jako pojedynczy samodzielny plik. Node.js jest potrzebny tylko wtedy, gdy instalujesz Claude Code przez npm; w takim przypadku wymagana jest wersja 22 lub nowsza. Starsze artykuły podają „Node 18 i nowszy”, ale to nieaktualne informacje — przyjmij wersję 22+.

Do korzystania z głównej wersji potrzebujesz terminala. Jeśli nie chcesz go używać, zainstaluj aplikację desktopową ze zwykłym oknem albo skorzystaj z wersji internetowej pod adresem claude.ai/code. Wersja terminalowa nadal oferuje więcej funkcji, dlatego dalsza część artykułu wyjaśnia, jak ją zainstalować.

Instalacja Claude Code jest jak zdobycie narzędzia. Samo w sobie często jednak halucynuje: zapomina o Twoim projekcie, zmyśla i gubi wątek w połowie zadania. Połączenie trzech elementów zapewnia niezawodność: klon AI, Drugi Mózg i inżynieria kontekstu. To trzy filary, które powstrzymują AI przed halucynowaniem.

Instalacja Claude Code w terminalu macOS: instalator natywny czy Homebrew?#

Otwórz Terminal (jest na każdym Macu: naciśnij Cmd+Space, aby otworzyć Spotlight, wpisz „Terminal”) i wklej tę jedną linię:

curl -fsSL https://claude.ai/install.sh | bash

Polecenie pobiera instalator z oficjalnego adresu Anthropic i instaluje Claude Code. Node.js nie jest potrzebny. Metoda natywna jest też wygodna ze względu na aktualizacje.

Jeśli korzystasz już z Homebrew, możesz wybrać drugą opcję:

brew install --cask claude-code

Różnica dotyczy aktualizacji: instalator natywny aktualizuje się sam, a Homebrew nie — musisz ręcznie uruchomić polecenie brew upgrade claude-code. Sam program jest taki sam, więc wybierz metodę, do której jesteś przyzwyczajony. Jeśli nie masz pewności, wybierz pierwszą.

Claude Code instalacja Windows: PowerShell, CMD czy WinGet?#

Najpierw sprawdź, w którym środowisku jesteś. Windows ma dwie powłoki, a każda wymaga innego polecenia. Otwórz okno i spójrz na początek znaku zachęty: PS C:\> oznacza PowerShell, a samo C:\> bez PS oznacza Wiersz polecenia (CMD).

Dla PowerShella (najłatwiej otworzyć go, klikając prawym przyciskiem przycisk Start i wybierając „Terminal”):

irm https://claude.ai/install.ps1 | iex

Dla Wiersza polecenia (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Trzecią opcją jest użycie wbudowanego menedżera pakietów WinGet:

winget install Anthropic.ClaudeCode

Jeśli masz już działające środowisko WSL (Linuksa w Windowsie), zainstaluj Claude Code bezpośrednio w WSL, używając tego samego polecenia co w Linuksie. WSL ma osobny problem związany z Node, który omówię niżej, w sekcji o częstych błędach.

Instalacja Claude Code Linux: polecenie i wymagania systemu#

Podstawowa metoda jest taka sama dla każdej popularnej dystrybucji — użyj samodzielnego instalatora:

curl -fsSL https://claude.ai/install.sh | bash

Node.js nie jest wymagany; program jest dostarczany jako pojedynczy plik i od tej pory aktualizuje się samodzielnie.

Jeśli zwykle instalujesz programy wyłącznie przez systemowy menedżer pakietów, możesz dodać oficjalne repozytoria Anthropic: apt dla Debiana i Ubuntu, dnf dla Fedory i RHEL oraz apk dla Alpine. Są podpisane kluczem i mają kanały stable oraz latest. Dla początkujących to zbyt skomplikowane, więc szczegóły pozostawiam dokumentacji wymienionej w sekcji źródeł i domyślnie polecam powyższe polecenie.

Na niedrogich serwerach może pojawić się jeden problem. Jeśli komputer ma bardzo mało wolnej pamięci, instalacja może się zatrzymać z komunikatem Killed (kod 137) — system przerwał proces, ponieważ zabrakło pamięci. Rozwiązaniem jest dodanie pliku swap: Claude Code potrzebuje do instalacji około 512 MB wolnej pamięci.

Jak po raz pierwszy uruchomić Claude Code?#

Pierwsze uruchomienie trwa kilka minut. Oto kolejne kroki.

1. Przejdź do folderu projektu

   W terminalu użyj polecenia cd path-to-project, aby przejść do folderu, nad którym chcesz pracować, a następnie wpisz claude.

2. Zaloguj się na konto

   Otworzy się przeglądarka z oknem logowania. Jeśli nie uruchomi się automatycznie, naciśnij c, aby skopiować link, i ręcznie wklej go do przeglądarki. Jeśli przeglądarka wyświetli kod (może się to zdarzyć w WSL i na serwerach zdalnych), wklej go z powrotem do terminala.

3. Poczekaj na potwierdzenie

   Po zalogowaniu terminal wyświetli Login successful i poprosi o naciśnięcie Enter.

4. Zadaj pierwsze pytanie

   Zapytaj o coś prostego związanego z projektem, na przykład „co robi ten projekt?”. Claude odczyta pliki i odpowie.

5. Zatwierdź pierwszą zmianę

   Gdy poprosisz o wprowadzenie zmiany, Claude pokaże proponowane modyfikacje i poprosi o potwierdzenie. Tryb dostępu możesz zmienić, naciskając Shift+Tab.

Od razu warto poznać kilka podstawowych poleceń dostępnych w sesji: /help wyświetla listę poleceń, /clear czyści historię rozmowy, a /exit zamyka sesję (to samo robi dwukrotne naciśnięcie Ctrl+D). Po wpisaniu /help Claude sam pokaże wszystkie te informacje.

Logowanie przez subskrypcję czy klucz API — co wybrać?#

To pierwsze pytanie, które pojawia się podczas logowania.

Są dwa sposoby logowania i różnią się tym, jak płacisz.

Aby zalogować się przez subskrypcję, po prostu użyj konta Claude.ai. Aby zalogować się kluczem API, pobierz klucz z Claude Console (platform.claude.com); podczas pracy opłaty są potrącane z przedpłaconego salda. Ustaw klucz w zmiennej środowiskowej ANTHROPIC_API_KEY, a Claude Code nie będzie za każdym razem otwierać przeglądarki.

Konta możesz przełączać w sesji poleceniem /login, a wylogować się poleceniem /logout.

Claude Code nie uruchomi się jednak bez płatnego dostępu. Jeśli nie masz jeszcze konta, najpierw dowiedz się, którego adresu e-mail użyć do rejestracji: później nie można go zmienić.

Jak sprawdzić, czy instalacja przebiegła prawidłowo?#

Od początku warto znać trzy polecenia.

Pierwsze sprawdza wersję:

claude --version

Prawidłowo działająca instalacja zwraca numer w formacie X.Y.Z (Claude Code). Konkretne cyfry zmieniają się w kolejnych wersjach; ważne, żeby polecenie w ogóle zwracało numer wersji. Komunikat „command not found” oznacza coś innego — omówię to w następnej sekcji.

Drugie polecenie służy do diagnostyki, gdy coś pójdzie nie tak.

Trzecie polecenie to /status w sesji: pokazuje, jak się zalogowano, jaki adres e-mail lub organizacja są powiązane z kontem oraz czy dostęp wygasł. Polecenie claude update natychmiast instaluje najnowszą aktualizację, zamiast czekać na aktualizację w tle.

Dlaczego po instalacji nie można znaleźć polecenia claude?#

To najczęstsza skarga początkujących i brzmi groźniej, niż jest w rzeczywistości. Terminal nie przeszukuje całego komputera w poszukiwaniu poleceń — sprawdza tylko foldery z PATH. Claude Code umieszcza się w ~/.local/bin/claude (na Macu i Linuksie) lub %USERPROFILE%\\.local\\bin\\claude.exe (w Windowsie). Jeśli tego folderu nie ma w PATH, terminal po prostu nie widzi programu.

Na Macu i Linuksie dodaj folder do listy. Otwórz plik ustawień swojej powłoki (~/.zshrc w Zsh, ~/.bashrc w Bash) i dodaj na końcu tę linię:

export PATH="$HOME/.local/bin:$PATH"

Następnie zamknij i ponownie otwórz terminal (albo uruchom source ~/.zshrc). Potem polecenie claude będzie już dostępne.

Częste błędy podczas instalacji i pierwszego uruchomienia#

Omówmy je po kolei; wszystkie opisano w oficjalnym poradniku Anthropic dotyczącym rozwiązywania problemów.

1. Stary Node przy instalacji przez npm. Pakiet @anthropic-ai/claude-code wymaga Node.js w wersji 22 lub nowszej. W Windowsie npm może zawieść z komunikatem o wyłączonych skryptach — zasady PowerShella blokują ich uruchamianie. W WSL częstym błędem jest exec: node: not found: WSL korzysta z Windowsowej wersji Node zamiast linuksowej. Jeśli npm sprawia problemy, przejdź na instalator natywny; nie wymaga Node.
2. Instalator niepasujący do powłoki. 'irm' is not recognized oznacza, że wklejono polecenie PowerShella do Wiersza polecenia. The token '&&' is not a valid statement separator oznacza odwrotną sytuację — uruchomienie polecenia CMD w PowerShellu. A parameter cannot be found that matches parameter name 'fsSL' oznacza, że w PowerShellu uruchomiono polecenie dla Maca lub Linuksa. Sprawdź początek znaku zachęty: PS C:\ oznacza PowerShell, a C:\ — CMD.
3. Stary klucz API nadpisuje subskrypcję. Jeśli subskrypcja jest aktywna, ale w środowisku nadal ustawiony jest stary klucz, pojawi się komunikat API Error: 400 ... This organization has been disabled. Klucz ma pierwszeństwo przed logowaniem przez subskrypcję. Usuń go poleceniem unset ANTHROPIC_API_KEY (w PowerShellu użyj Remove-Item Env:ANTHROPIC_API_KEY), sprawdź pliki ~/.zshrc i ~/.bashrc, a następnie wpisz /status.
4. Za mało pamięci na słabym serwerze. Instalacja zatrzymuje się z komunikatem Killed i kodem 137 — oznacza to, że zabrakło RAM-u. Potrzeba około 512 MB wolnej pamięci; dodanie swap rozwiązuje problem.
5. Instalator zwrócił coś innego. Błąd syntax error near unexpected token '<' albo odwołanie do <!DOCTYPE html> oznacza, że adres instalacyjny zwrócił stronę internetową zamiast skryptu instalacyjnego — zwykle z powodu regionu, firmowej zapory sieciowej lub tymczasowej awarii. Spróbuj innej metody (Homebrew, WinGet) albo ponów próbę za kilka minut.

Przy każdym z tych błędów zacznij tak samo: uruchom claude doctor. Pokaże, co nie działa, i zasugeruje, gdzie szukać przyczyny.

W diagnostyce jest jeszcze jeden szczegół: sam kod 403 podczas instalacji może też pochodzić od firmowej zapory lub serwera proxy. Jeśli korzystasz z sieci biurowej, najpierw sprawdź, czy nie blokuje dostępu.

Co zrobić po instalacji: pierwsze kroki#

Instalacja to dopiero początek. Prawdziwa praca zaczyna się później, a pierwszym problemem, na który natrafiają użytkownicy, jest pamięć. Model językowy nie pamięta Cię między rozmowami: w nowym czacie zna tylko to, co zostało umieszczone w jego kontekście.

Dlatego pierwszym rzeczywistym krokiem po instalacji jest utworzenie pliku CLAUDE.md w katalogu głównym projektu. To plik tekstowy z regułami projektu i kontekstem, który Claude Code odczytuje przy każdym uruchomieniu. Opisz raz, czym się zajmujesz, jak zorganizowany jest projekt i co jest ważne — nie trzeba będzie powtarzać tego w każdej rozmowie.

W osobnym poradniku pokazuję, jak przygotować ten plik i dostosować Claude: jak dostosować Claude. Przygotowałem też ogólną mapę narzędzi do vibe codingu na 2026 rok.

O co jeszcze pytają użytkownicy?#

Kompletny framework vibe codingu: klon AI + Drugi Mózg + inżynieria kontekstu.