Claude Desktop nie odpowiada? Moja uporządkowana ścieżka diagnostyczna

Większość objawów błędów w Claude Desktop ma znane przyczyny. Zanim zacznę zmieniać konfigurację, wykonuję trzy kroki diagnostyczne – w praktyce oszczędza to sporo czasu.

Najpierw trzy kroki diagnostyczne

Otworzyć plik logu. W macOS w katalogu ~/Library/Logs/Claude, w Windows w %APPDATA%\Claude\logs, w Linux w ~/.config/Claude/logs. Ostatnie 50 wierszy w większości przypadków zdradza problem.

Sprawdzić status Anthropic. Rzut oka na status.anthropic.com wyklucza, że błąd leży poza własnym środowiskiem. Z doświadczenia oszczędza to godziny szukania w złym miejscu.

Wyizolować ścieżkę sieciową. Tethering przez telefon komórkowy szybko pokazuje, czy odpowiada VPN, proxy czy Zscaler. Jeśli aplikacja działa na hotspocie, wiadomo, gdzie szukać.

Indeks objawów: najczęstsze obrazy błędów

Czarny lub pusty ekran przy starcie. Przyczyna: konflikt GPU lub uszkodzona pamięć podręczna. Usunąć katalog cache, wyłączyć akcelerację sprzętową, uruchomić ponownie.

Aplikacja ładuje się bez końca, kręci się wskaźnik. Przyczyna: blokada sieciowa przez VPN, proxy lub Zscaler. Odblokować api.anthropic.com, przetestować na chwilę bez VPN.

403 Forbidden lub „invalid authorization”. Przyczyna: wygasły token lub zmieniony nagłówek regionu. Utworzyć nowy token, sprawdzić status planu, zbadać proxy pod kątem manipulacji nagłówkami.

500 Internal Server Error. Przyczyna: problem serwera po stronie Anthropic. Sprawdzić status.anthropic.com, powtórzyć po pięciu minutach.

Brak ikony młotka, nie widać serwerów MCP. Przyczyna: błąd składni w claude_desktop_config.json lub zła ścieżka polecenia. Uruchomić JSON-Lint, ustawić ścieżki bezwzględne, całkowicie zrestartować aplikację.

Aplikacja startuje i natychmiast zamyka się w Linux. Przyczyna: brakujące biblioteki systemowe. Uruchomić aplikację z terminala, przeczytać komunikat błędu, doinstalować brakujące pakiety.

Co często zawodzi w sieci firmowej

Zscaler. Gdy Zscaler ponownie podpisuje ruch sieciowy, Claude Desktop odrzuca certyfikat. Rozwiązanie: wyłączyć api.anthropic.com z inspekcji TLS albo umieścić certyfikat główny Zscalera w systemowym magazynie zaufania.

Intune. Pakiety aplikacji dla Intune wymagają właściwej ścieżki wykrywania. Kto to pominie, zobaczy aplikację na urządzeniach dopiero po ręcznej interwencji.

Proxy z uwierzytelnianiem. HTTPS_PROXY i HTTP_PROXY należy ustawić w kontekście systemowym, nie tylko w powłoce użytkownika. Inaczej aplikacja nie użyje proxy i będzie wpadać w timeouty.