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
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.
curl -fsSL https://claude.ai/install.sh | bashW 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ę.
claude --version
claude doctorPierwsze 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.
brew install --cask claude-codeHomebrew 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.
npm install -g @anthropic-ai/claude-codeWybierzcie 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.
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrcJeś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/…/.zshrcoznacza, że plik należy do innego użytkownika, zwykle do roota. Naprawia tosudo chown $(whoami) ~/.zshrc.dyld: Symbol not foundalbodyld: cannot loadoznacza 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 doctorostrzega wtedy, że Pęk kluczy nie przyjmuje zapisu, a odblokowuje gosecurity 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.
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claudeDla 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.
Usługa, o której jest ten tekst
Automatyzacja i AI / OCRAutomatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.