Instalacja Claude Code na macOS. Jedno polecenie, a potem nowe okno Terminala

Jak zainstalować Claude Code na Macu instalatorem, przez Homebrew albo npm, jak sprawdzić instalację, naprawić command not found i wszystko odinstalować.

Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy

W tym tekście
  1. Wymagania przed instalacją Claude Code na macOS
  2. Instalacja jednym poleceniem
  3. Homebrew i npm, czyli dwie inne drogi
  4. Gdy Terminal odpowiada command not found
  5. Aktualizacje i odinstalowanie na Macu

W skrócie

Claude Code instaluje się na Macu jednym poleceniem w Terminalu, a wersja z instalatora sama się aktualizuje. Opisujemy też Homebrew i npm, sprawdzenie instalacji, najczęstszy błąd ze ścieżką PATH i pełne odinstalowanie.

Wklejacie do Terminala jedno polecenie, instalator przez chwilę nic nie pokazuje, kończy pracę, a claude i tak nie działa. Tak najczęściej wygląda pierwsza instalacja Claude Code na macOS. Program jest już na dysku, tylko otwarte okno Terminala jeszcze o nim nie wie. Poniżej cała droga od wymagań do odinstalowania, sprawdzona w dokumentacji Anthropic, stan na 10 listopada 2026.

My na co dzień pracujemy w Claude Code na Macu. Czym jest samo narzędzie, opisaliśmy w tekście Claude Code. Co robi poza czatem, a cały cykl zbiera przewodnik po Claude Code.

Wymagania przed instalacją Claude Code na macOS

Claude Code działa na macOS 13.0 i nowszych, na Macach z procesorem Apple i z procesorem Intel. Potrzeba co najmniej 4 GB pamięci RAM i stałego połączenia z internetem. Git nie jest wymagany, choć przy pracy z kodem i tak się przyda.

Do logowania potrzebne jest konto Claude w planie Pro, Max, Ultra, Team albo Enterprise, konto w Claude Console albo dostęp przez chmurę firmową. Darmowy plan claude.ai nie obejmuje Claude Code. Jeśli terminal Was zniechęca, Anthropic udostępnia też aplikację desktopową, w której Claude Code działa bez wpisywania poleceń. Ten tekst dotyczy wersji w Terminalu.

Instalacja jednym poleceniem

Otwórzcie Terminal i wklejcie polecenie instalatora. Anthropic nazywa tę metodę natywną i ją zaleca.

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

W czasie pobierania instalator nie pokazuje paska postępu, więc chwila ciszy jest normalna. Program trafia do Waszego katalogu domowego. Polecenie claude ląduje w ~/.local/bin/claude jako skrót do właściwej wersji w ~/.local/share/claude/versions/.

Gdy instalator skończy, zamknijcie okno i otwórzcie nowe. Dopiero w nim sprawdźcie instalację.

bash
claude --version
claude doctor

Pierwsze polecenie wypisuje numer wersji z dopiskiem (Claude Code). Drugie robi przegląd instalacji i plików ustawień bez uruchamiania sesji, pokazuje ostrzeżenia i podpowiada poprawki. Program jest podpisany przez Anthropic i poświadczony przez Apple, co można sprawdzić poleceniem codesign --verify --verbose na pliku programu.

Homebrew i npm, czyli dwie inne drogi

Jeśli instalujecie programy przez Homebrew, wystarczy jedno polecenie.

bash
brew install --cask claude-code

Homebrew ma dwa warianty. claude-code idzie kanałem stable, który zwykle jest mniej więcej tydzień za najnowszym wydaniem i pomija wydania z poważnymi błędami. claude-code@latest dostaje każdą wersję od razu. Instalacja z Homebrew sama się nie aktualizuje. Robicie to poleceniem brew upgrade claude-code albo brew upgrade claude-code@latest, zależnie od wariantu. Homebrew trzyma stare wersje na dysku, więc co jakiś czas przyda się brew cleanup.

Gdy brew odpowiada, że claude-code nie istnieje, lokalny indeks Homebrew jest po prostu stary. Pomaga brew update i ponowna instalacja.

Trzecia droga to npm. Paczka wymaga Node.js w wersji 22 lub nowszej i instaluje ten sam program co instalator. Nigdy nie dopisujcie przed nią sudo, bo potem Claude Code nie zaktualizuje się sam.

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

Wybierzcie jedną metodę. Dwie instalacje naraz kończą się tym, że Terminal uruchamia inną wersję, niż myślicie. Polecenie which -a claude pokaże wszystkie kopie, które system widzi.

Gdy Terminal odpowiada command not found

Komunikat zsh: command not found: claude zaraz po instalacji prawie zawsze oznacza, że folder ~/.local/bin nie jest na ścieżce PATH. Najpierw sprawdźcie, czy program w ogóle jest na dysku, poleceniem ls -la ~/.local/bin/claude. Jeśli jest, dopiszcie folder do konfiguracji powłoki. Na Macu domyślną powłoką jest zsh.

bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Jeśli używacie basha, dopiszcie tę linijkę do ~/.bash_profile, a nie do ~/.bashrc. Terminal na Macu uruchamia basha jako powłokę logowania, a ona pomija ~/.bashrc. Terminal wbudowany w edytor bierze PATH od edytora, więc VS Code trzeba zamknąć i otworzyć ponownie.

Kilka innych objawów, które dokumentacja opisuje osobno dla Maca.

  • zsh: permission denied: /Users/…/.zshrc oznacza, że plik należy do innego użytkownika, zwykle do roota. Naprawia to sudo chown $(whoami) ~/.zshrc.
  • dyld: Symbol not found albo dyld: cannot load oznacza za stary system. Homebrew nie pomoże, bo pobiera ten sam program. Trzeba zaktualizować macOS do wersji 13.0 lub nowszej.
  • W sesji SSH Pęk kluczy bywa zablokowany. Claude Code zapisuje tam login, a gdy zapis się nie uda, przechodzi na plik ~/.claude/.credentials.json. claude doctor ostrzega wtedy, że Pęk kluczy nie przyjmuje zapisu, a odblokowuje go security unlock-keychain ~/Library/Keychains/login.keychain-db.

Skróty z klawiszem Option, na przykład Option+Enter dla nowej linii, wymagają ustawienia Option jako klawisza Meta. Najprościej wpisać w sesji /terminal-setup. W Terminalu Apple to polecenie włącza Option jako Meta i wyłącza dźwięk dzwonka.

Aktualizacje i odinstalowanie na Macu

Wersja z instalatora sprawdza aktualizacje przy starcie i w trakcie pracy. Nowa wersja pobiera się w tle i działa od następnego uruchomienia. Żeby zaktualizować od razu, wpiszcie claude update. Wolniejszy kanał stable ustawicie w /config albo kluczem autoUpdatesChannel w pliku ustawień.

Odinstalowanie wersji z instalatora to dwa polecenia.

bash
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Dla Homebrew jest to brew uninstall --cask claude-code, a dla npm npm uninstall -g @anthropic-ai/claude-code. Ustawienia zostają w folderze ~/.claude i w pliku ~/.claude.json. Usunięcie ich kasuje ustawienia, zapisane zgody, konfigurację serwerów MCP i historię sesji. Rozszerzenie VS Code i aplikacja desktopowa też piszą do ~/.claude, więc odinstalujcie je wcześniej, jeśli chcecie usunąć wszystko.

Po instalacji przejdźcie do pierwszego uruchomienia i logowania, a potem do najważniejszych poleceń. Instalację na innych systemach opisują Windows i Linux.

Jeśli po instalacji claude nie działa, zacznijcie od nowego okna Terminala i claude doctor, a dopiero potem szukajcie dalej. Jeśli zastanawiacie się, czy AI w ogóle ma sens w Waszej firmie, w darmowym audycie AI sprawdzimy, gdzie może zdjąć z zespołu część pracy.

Co chcecie zmienić w swojej firmie?

Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.