La plupart des symptômes dans Claude Desktop ont des causes connues. Avant de toucher à la configuration, je passe par trois étapes de diagnostic – dans la pratique, cela fait gagner un temps considérable.
Trois étapes de diagnostic d’abord
Ouvrir le fichier journal. Sur macOS sous ~/Library/Logs/Claude, sur Windows dans %APPDATA%\Claude\logs, sur Linux sous ~/.config/Claude/logs. Les 50 dernières lignes révèlent le problème dans la plupart des cas.
Vérifier le statut d’Anthropic. Un coup d’œil à status.anthropic.com permet d’exclure que l’erreur vienne d’ailleurs que de votre propre installation. D’expérience, cela évite des heures de recherche à côté.
Isoler le chemin réseau. Le partage de connexion via le téléphone montre vite si le VPN, le proxy ou Zscaler sont en cause. Si l’application fonctionne sur le hotspot, on sait où chercher.
Index des symptômes : les défauts les plus fréquents
Écran noir ou vide au démarrage. Cause : conflit GPU ou cache corrompu. Supprimer le répertoire de cache, désactiver l’accélération matérielle, redémarrer.
L’application charge sans fin, le spinner tourne. Cause : blocage réseau par VPN, proxy ou Zscaler. Autoriser api.anthropic.com, tester brièvement sans VPN.
403 Forbidden ou « invalid authorization ». Cause : jeton expiré ou en-tête de région modifié. Créer un nouveau jeton, vérifier le statut du plan, examiner le proxy pour d’éventuelles manipulations d’en-têtes.
500 Internal Server Error. Cause : problème serveur du côté d’Anthropic. Vérifier status.anthropic.com, réessayer après cinq minutes.
L’icône marteau manque, aucun serveur MCP visible. Cause : erreur de syntaxe dans claude_desktop_config.json ou chemin de commande erroné. Passer un JSON-Lint, mettre des chemins absolus, redémarrer complètement l’application.
L’application démarre puis se ferme aussitôt sous Linux. Cause : bibliothèques système manquantes. Lancer l’application depuis le terminal, lire le message d’erreur, installer les paquets manquants.
Ce qui coince souvent dans un réseau d’entreprise
Zscaler. Quand Zscaler resigne le trafic, Claude Desktop refuse le certificat. Solution : exclure api.anthropic.com de l’inspection TLS ou placer le certificat racine Zscaler dans le magasin de confiance du système.
Intune. Les packages d’application pour Intune ont besoin du bon chemin de détection. Qui saute cette étape ne voit l’application sur les appareils qu’après une intervention manuelle.
Proxy authentifié. Enregistrer HTTPS_PROXY et HTTP_PROXY dans le contexte système, pas seulement dans le shell utilisateur. Sinon l’application n’utilise pas le proxy et tombe en timeout.