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.