Claude Code: command not found po instalacji - jak naprawić PATH

Claude Code

Claude Code: command not found po instalacji - jak naprawić PATH

W skrócie

To jeden z najczęstszych zgrzytów zaraz po instalacji Claude Code, narzędzia CLI od Anthropic. Pakiet zainstalował się poprawnie, ale gdy wpisujesz claude, terminal odpowiada command not found (albo w Windows: nie jest rozpoznawane jako polecenie). Plik wykonywalny fizycznie istnieje na dysku, tylko powłoka nie wie, gdzie go szukać. Dotyczy to każdego, kto zainstalował Claude Code do katalogu spoza standardowej ścieżki wyszukiwania - najczęściej po zmianie prefiksu npm albo instalacji przez natywny skrypt.

Jak to wygląda w praktyce

W terminalu widzisz dokładnie to:

$ claude
bash: claude: command not found

A gdy sprawdzisz, czy pakiet jest zainstalowany, npm potwierdza, że owszem jest: npm list -g @anthropic-ai/claude-code pokazuje wersję. To jasny sygnał, że problem nie leży w instalacji, tylko w tym, że katalog z binarką nie jest w PATH. W Windows objaw jest analogiczny - świeżo zainstalowana komenda działa dopiero po ponownym otwarciu terminala, bo stara sesja ma zapamiętaną starą wartość PATH.

Dlaczego Claude Code tak działa

Gdy wpisujesz nazwę komendy, powłoka przechodzi po kolei przez katalogi wymienione w zmiennej środowiskowej PATH i szuka w nich pliku o tej nazwie. Jeśli plik claude leży w katalogu, którego nie ma na tej liście, powłoka go nie znajdzie - mimo że fizycznie istnieje. Tak dzieje się, gdy przeniosłeś prefiks npm do ~/.npm-global, ale nie dopisałeś bin do PATH, albo gdy natywny instalator Anthropic umieścił binarkę w ~/.local/bin, którego Twoja dystrybucja nie ma domyślnie w ścieżce. To standardowe zachowanie każdej powłoki uniksowej i wiersza poleceń Windows, a nie usterka Claude Code.

Jak to rozwiązać krok po kroku

1. Ustal, gdzie leży plik. Na Linux i macOS: npm config get prefix - binarka będzie w podkatalogu bin tego prefiksu. Jeśli instalowałeś natywnym skryptem, sprawdź ~/.local/bin/claude.
2. Dodaj ten katalog do PATH. Do ~/.bashrc (lub ~/.zshrc na macOS) dopisz na końcu: export PATH="$HOME/.npm-global/bin:$PATH" - podmieniając ścieżkę na tę z kroku pierwszego.
3. Przeładuj konfigurację powłoki bez zamykania terminala: source ~/.bashrc (albo po prostu otwórz nowe okno terminala).
4. W Windows dodaj katalog do PATH przez ustawienia systemowe: wpisz w menu Start "zmienne środowiskowe", edytuj zmienną Path użytkownika i dodaj ścieżkę do katalogu z claude.exe (np. folder npm w %AppData%). Po zapisaniu zamknij i otwórz terminal na nowo.
5. Jeśli używasz nvm, upewnij się, że aktywna jest właściwa wersja Node: nvm use --lts. Binarki globalne są przypięte do konkretnej wersji Node w nvm.
6. Jako obejście doraźne możesz uruchomić narzędzie pełną ścieżką, żeby potwierdzić, że plik działa: ~/.npm-global/bin/claude --version.

Jak sprawdzić, że zadziałało

Wpisz which claude (Linux/macOS) lub where claude (Windows) - powinieneś zobaczyć pełną ścieżkę do pliku wykonywalnego. Następnie claude --version ma wypisać numer wersji bez błędu. Ostateczny test to uruchomienie samego claude w katalogu projektu - jeśli otworzy się interfejs narzędzia albo kreator logowania, PATH jest poprawnie ustawiony i problem zniknął na stałe (bo wpis w .bashrc przetrwa restart komputera).

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5