De meeste storingsbeelden in Claude Desktop hebben bekende oorzaken. Voordat ik aan de configuratie draai, doorloop ik drie diagnosestappen – dat scheelt in de praktijk aanzienlijk veel tijd.
Eerst drie diagnosestappen
Logbestand openen. Op macOS onder ~/Library/Logs/Claude, op Windows in %APPDATA%\Claude\logs, op Linux onder ~/.config/Claude/logs. De laatste 50 regels verraden in de meeste gevallen het probleem.
Status van Anthropic controleren. Een blik op status.anthropic.com sluit uit dat de fout buiten de eigen opzet ligt. Dat scheelt naar mijn ervaring uren verkeerd zoeken.
Netwerkpad isoleren. Tethering via de mobiele telefoon laat snel zien of VPN, proxy of Zscaler de oorzaak is. Werkt de app via de hotspot, dan weet u waar u moet zoeken.
Symptomenindex: de meest voorkomende storingsbeelden
Zwart of leeg scherm bij het starten. Oorzaak: GPU-conflict of beschadigde cache. Cachemap verwijderen, hardwareversnelling uitschakelen, opnieuw starten.
App laadt eindeloos, het draaiwieltje blijft draaien. Oorzaak: netwerkblokkade door VPN, proxy of Zscaler. api.anthropic.com vrijgeven, kort zonder VPN testen.
403 Forbidden of „invalid authorization“. Oorzaak: token verlopen of regio-header aangepast. Nieuw token aanmaken, abonnementsstatus controleren, de proxy op headermanipulatie onderzoeken.
500 Internal Server Error. Oorzaak: serverprobleem aan de kant van Anthropic. status.anthropic.com controleren, na vijf minuten opnieuw proberen.
Hamerpictogram ontbreekt, geen MCP-servers zichtbaar. Oorzaak: syntaxfout in claude_desktop_config.json of verkeerd opdrachtpad. Een JSON-lint laten lopen, paden absoluut maken, de app volledig opnieuw starten.
App start en sluit op Linux meteen weer. Oorzaak: ontbrekende systeembibliotheken. De app via de terminal starten, de foutmelding lezen, ontbrekende pakketten alsnog installeren.
Wat in bedrijfsnetwerken vaak misgaat
Zscaler. Wanneer Zscaler het dataverkeer opnieuw ondertekent, weigert Claude Desktop het certificaat. Oplossing: api.anthropic.com uitzonderen van de TLS-inspectie of het Zscaler-hoofdcertificaat in de systeem-truststore plaatsen.
Intune. App-packages voor Intune hebben het juiste detectiepad nodig. Wie dat overslaat, ziet de app pas na handmatig ingrijpen op de apparaten.
Proxy met authenticatie. HTTPS_PROXY en HTTP_PROXY in de systeemcontext vastleggen, niet alleen in de gebruikersshell. Anders gebruikt de app de proxy niet en loopt hij in time-outs.