Ta lekcja z naszego kursu Claude Code zbiera najczestsze awarie i pokazuje, jak je rozbroic komendami /doctor i /status, zanim zmarnujesz czas na zgadywanie. Oryginal opublikowalismy na naszym blogu.
Kurs Claude Code - Lekcja 8 z 29
Ten artykuł jest częścią bezpłatnego kursu Claude Code - największej polskojęzycznej serii 29 lekcji dla programistów. Od pierwszego uruchomienia do autonomicznych agentów AI.
<-- Lekcja 7: Skróty i sztuczki w terminaluLekcja 9: Tryby uprawnień
Z tego artykułu dowiesz się:
- Jak
/doctordiagnozuje instalację i wykrywa nieaktualną wersję Claude Code - Jak
/statussprawdza połączenie i zalogowane konto - Ściąga najczęstszych problemów i szybkich napraw
- Co zrobić, gdy diagnostyka nie wystarczy (
/feedback)
Każde narzędzie czasem płata figla. Claude Code nie odpowiada, coś się nie instaluje, integracja nie działa, terminal dziwnie się zachowuje. Naturalny odruch to wkleić komunikat do ChatGPT albo wpisać go w wyszukiwarkę. Ale w większości przypadków szybsza droga prowadzi przez dwie wbudowane komendy diagnostyczne - /doctor i /status - które w kilka sekund pokażą, co jest nie tak. Zacznij od nich, zanim zaczniesz szukać gdziekolwiek indziej.
Trzy komendy, od których zaczynasz, gdy coś nie działa: /doctor sprawdza instalację, /status połączenie, /feedback zgłasza problem
1. /doctor - sprawdź instalację
Komenda /doctor to pełen przegląd stanu Twojej instalacji. Pokazuje wersję, sposób instalacji, ścieżkę, dostępne aktualizacje i status komponentów - wszystko w jednym miejscu:
/doctor pokazuje, jak i skąd działa Claude Code: wersję, sposób instalacji, ścieżkę, stan aktualizacji (tu: stabilna i najnowsza wersja) oraz status serwera w tle
Tu wyłapiesz najczęstszą przyczynę dziwnych zachowań: nieaktualną wersję. Jeśli /doctor pokazuje, że jest dostępna nowsza, sama aktualizacja często rozwiązuje problem. Zobaczysz też, czy instalacja jest poprawna i jaką metodą została zrobiona - co bywa kluczowe przy problemach z uprawnieniami.
2. /status - sprawdź połączenie
Druga komenda, /status, odpowiada na pytanie „czy ja w ogóle jestem połączony". Pokazuje wersję, wybrany model, zalogowane konto, łączność z API i status narzędzi. Gdy Claude nie odpowiada albo zwraca błędy, najczęściej winne jest jedno z dwóch: brak zalogowania albo problem z łącznością. /status pokaże oba od razu. Jeśli to kwestia logowania, naprawiasz ją komendą /login.
/status na jednym ekranie: wersja, metoda logowania i konto, wybrany model, stan serwerów MCP (tu 1 połączony, 3 wymagają autoryzacji) oraz diagnostyka systemu. Interfejs Claude Code jest anglojęzyczny; dane konta zamaskowano.
3. Najczęstsze problemy i szybkie naprawy
Większość kłopotów to drobiazgi z prostym rozwiązaniem. Oto ściąga:
| Objaw | Co sprawdzić / zrobić |
|---|---|
| Dziwne zachowanie, błędy bez powodu |
/doctor - czy jest nowsza wersja. Aktualizacja często załatwia sprawę. |
| Brak odpowiedzi, błędy logowania |
/status sprawdza łączność i konto; /login loguje ponownie. |
| Serwer MCP nie działa |
/mcp pokazuje stan serwerów (połączony / błąd) i pozwala je zarządzać. |
| Agent ciągle pyta albo nie może czegoś zrobić | Sprawdź tryb (Shift+Tab) i reguły uprawnień - być może coś jest twardo zablokowane. |
| Enter wysyła wiadomość zamiast przejść do nowej linii |
/terminal-setup sprawdza konfigurację terminala (m.in. obsługę Shift+Enter). |
| Agent gubi wątek, miesza fakty | Prawdopodobnie przepełniony kontekst - /context to potwierdzi, a /compact naprawi. |
4. Gdy diagnostyka nie wystarczy
Jeśli /doctor i /status nie wskazały przyczyny, a problem zostaje, jest jeszcze /feedback. Wysyła zgłoszenie z detalami sesji, dzięki czemu ktoś może przyjrzeć się sprawie z pełnym kontekstem - to lepsze niż opisywanie problemu z pamięci. Sam /doctor zresztą kieruje do niej na końcu - ostatnia linia diagnostyki podpowiada, żeby przy dalszych problemach uruchomić /feedback (widać ją na zrzucie w sekcji 1).
Reguła jest prosta i oszczędza mnóstwo czasu: zanim zaczniesz szukać rozwiązania na zewnątrz, zapytaj samo narzędzie. W ogromnej większości przypadków /doctor albo /status pokażą przyczynę w kilka sekund - nieaktualną wersję, wylogowane konto, zerwane połączenie albo problem z konfiguracją. Dopiero gdy to nie pomoże, warto sięgać dalej. Wszystkie te komendy zebraliśmy zresztą w osobnej ściądze wbudowanych komend.
Szkolenie Claude Code - od zera do zespołu agentów AI
Diagnostyka i troubleshooting, komendy, kontekst, uprawnienia i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma termin gwarantowany - odbędzie się niezależnie od liczby zgłoszeń.
To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.
★★★★★Średnia ocena naszych szkoleń w Google: 5/5
Poprzednia lekcja
<-- Lekcja 7: Skróty i sztuczki w terminalu
Następna lekcja
Top comments (0)