Claude Code: Bash command failed - jak naprawić

Claude Code

Claude Code: Bash command failed - jak naprawić

W skrócie

Gdy Claude Code uruchamia komendę przez narzędzie Bash, a ta kończy się kodem wyjścia różnym od zera, dostajesz "Bash command failed (non-zero exit code)". W większości przypadków to nie błąd Claude, tylko realny błąd komendy, który zobaczyłbyś tak samo w swoim terminalu.

Jak to wygląda w praktyce

Claude uruchamia komendę shellową, a ta zwraca niezerowy kod wyjścia. W rozmowie pojawia się "Bash command failed (non-zero exit code)", zwykle wraz z wypisem tego, co komenda wysłała na standardowe wyjście błędów.

Zadanie, które zależało od tej komendy (np. build, test, uruchomienie skryptu), nie kończy się sukcesem, bo powłoka zgłosiła niepowodzenie.

Zobacz też: Szkolenie Claude Code - od zera do zespołu agentów AI

Dlaczego tak się dzieje

Konwencja jest prosta: kod wyjścia 0 oznacza sukces, każdy inny oznacza błąd. Najczęstsze przyczyny niezerowego kodu to: brak programu, którego komenda używa, złe argumenty lub flagi, błąd w samym uruchamianym skrypcie, brak wskazanego pliku, brak uprawnień, albo komenda interaktywna, która czeka na wejście od użytkownika i nigdy się go nie doczeka.

Warto podkreślić: to nie zawsze błąd Claude. Bardzo często jest to prawdziwy błąd komendy - dokładnie ten sam, który zobaczyłbyś, wpisując ją własnoręcznie w terminalu. Claude tylko wiernie pokazuje, że powłoka zwróciła niepowodzenie.

Jak to rozwiązać krok po kroku

1. Odczytaj kod wyjścia oraz treść z stderr - to tam powłoka opisuje, co konkretnie poszło nie tak.
2. Uruchom tę samą komendę ręcznie w swoim terminalu, żeby na własne oczy zobaczyć pełny błąd.
3. Jeśli brakuje programu, zainstaluj go i sprawdź dostępność przez which nazwa_programu.
4. Popraw błędne argumenty, flagi i ścieżki - sprawdź w dokumentacji komendy poprawną składnię.
5. Unikaj komend interaktywnych - dodawaj flagi nieinteraktywne (np. -y, --yes, --no-input), żeby komenda nie czekała na wejście.
6. Rozbij długą, złożoną komendę na mniejsze kroki, żeby łatwiej wskazać, który fragment zawodzi.
7. Po poprawce poproś Claude o ponowne uruchomienie komendy.

Jak sprawdzić, że zadziałało

Uruchom komendę ponownie - ręcznie lub przez Claude. Kod wyjścia równy 0 oznacza sukces. W wielu powłokach sprawdzisz go od razu po komendzie przez echo $?.

Potwierdź też realny efekt: czy build się zbudował, czy testy przeszły, czy plik powstał. Zerowy kod wyjścia i oczekiwany skutek razem potwierdzają, że problem został usunięty.

Wróć do listy problemów z Claude Code