Die meisten Fehlerbilder in Claude Desktop haben bekannte Ursachen. Bevor ich an der Konfiguration drehe, gehe ich drei Diagnose-Schritte – das spart in der Praxis erhebliche Zeit.
Drei Diagnose-Schritte zuerst
Logfile öffnen. Auf macOS unter ~/Library/Logs/Claude, auf Windows in %APPDATA%Claudelogs, auf Linux unter ~/.config/Claude/logs. Die letzten 50 Zeilen verraten in den meisten Fällen das Problem.
Anthropic-Status prüfen. Ein Blick auf status.anthropic.com schließt aus, dass der Fehler außerhalb des eigenen Setups liegt. Das spart erfahrungsgemäß Stunden falscher Suche.
Netzwerkpfad isolieren. Tethering über das Mobiltelefon zeigt schnell, ob VPN, Proxy oder Zscaler verantwortlich sind. Wenn die App im Hotspot funktioniert, weiß man, wo zu suchen ist.
Symptom-Index: die häufigsten Fehlerbilder
Schwarzer oder leerer Bildschirm beim Start. Ursache: GPU-Konflikt oder beschädigter Cache. Cache-Verzeichnis löschen, Hardware-Beschleunigung deaktivieren, neu starten.
App lädt endlos, Spinner dreht. Ursache: Netzwerk-Blockade durch VPN, Proxy oder Zscaler. api.anthropic.com freigeben, kurzzeitig ohne VPN testen.
403 Forbidden oder „invalid authorization“. Ursache: Token abgelaufen oder Region-Header verändert. Neuen Token erstellen, Plan-Status prüfen, Proxy auf Header-Manipulation untersuchen.
500 Internal Server Error. Ursache: Server-Problem auf Anthropic-Seite. status.anthropic.com prüfen, nach fünf Minuten wiederholen.
Hammer-Icon fehlt, keine MCP-Server sichtbar. Ursache: Syntaxfehler in claude_desktop_config.json oder falscher Befehlspfad. JSON-Lint laufen lassen, Pfade absolut setzen, App vollständig neu starten.
App startet, schließt sich auf Linux sofort. Ursache: Fehlende System-Bibliotheken. App über das Terminal starten, Fehlermeldung lesen, fehlende Pakete nachinstallieren.
Was im Firmennetz häufig schiefläuft
Zscaler. Wenn Zscaler den Datenverkehr neu signiert, lehnt Claude Desktop das Zertifikat ab. Lösung: api.anthropic.com aus der TLS-Inspection ausnehmen oder das Zscaler-Wurzelzertifikat in den System-Trust-Store legen.
Intune. App-Packages für Intune brauchen den richtigen Detection-Pfad. Wer das überspringt, sieht die App auf den Geräten erst nach manuellem Eingriff.
Authentifizierter Proxy. HTTPS_PROXY und HTTP_PROXY im Systemkontext hinterlegen, nicht nur in der User-Shell. Sonst nutzt die App den Proxy nicht und läuft in Timeouts.
Häufige Fragen
Was prüfe ich zuerst, wenn Claude Desktop nicht reagiert?
Drei Schritte: das Logfile öffnen, status.anthropic.com prüfen und den Netzwerkpfad isolieren. Das spart in der Praxis viel Zeit.
Wo finde ich die Logdateien?
Auf macOS unter ~/Library/Logs/Claude, auf Windows unter %APPDATA%Claudelogs, auf Linux unter ~/.config/Claude/logs. Die letzten 50 Zeilen zeigen meist die Ursache.
Die App lädt endlos – woran liegt das?
Meist an einer Netzwerk-Blockade durch VPN, Proxy oder Zscaler. Geben Sie api.anthropic.com frei und testen Sie kurz ohne VPN.
Ich sehe einen schwarzen oder leeren Bildschirm. Was hilft?
Das deutet auf einen GPU-Konflikt oder beschädigten Cache hin. Löschen Sie das Cache-Verzeichnis, deaktivieren Sie die Hardware-Beschleunigung und starten Sie neu.