La maggior parte dei problemi in Claude Desktop ha cause note. Prima di mettere mano alla configurazione, seguo tre passi di diagnosi: nella pratica fa risparmiare parecchio tempo.
Prima tre passi di diagnosi
Apra il file di log. Su macOS in ~/Library/Logs/Claude, su Windows in %APPDATA%\Claude\logs, su Linux in ~/.config/Claude/logs. Nella maggior parte dei casi le ultime 50 righe rivelano il problema.
Controlli lo stato di Anthropic. Un’occhiata a status.anthropic.com esclude che l’errore stia fuori dal proprio setup. Per esperienza fa risparmiare ore di ricerca sbagliata.
Isoli il percorso di rete. Il tethering dal telefono mostra subito se sono responsabili VPN, proxy o Zscaler. Se l’applicazione funziona sull’hotspot, si sa dove cercare.
Indice dei sintomi: i problemi più frequenti
Schermo nero o vuoto all’avvio. Causa: conflitto con la GPU o cache danneggiata. Elimini la cartella della cache, disattivi l’accelerazione hardware e riavvii.
L’applicazione carica all’infinito, l’indicatore continua a girare. Causa: blocco di rete dovuto a VPN, proxy o Zscaler. Sblocchi api.anthropic.com e provi brevemente senza VPN.
403 Forbidden oppure «invalid authorization». Causa: token scaduto o header di regione modificato. Crei un nuovo token, controlli lo stato del piano ed esamini il proxy per eventuali manipolazioni degli header.
500 Internal Server Error. Causa: problema del server lato Anthropic. Controlli status.anthropic.com e riprovi dopo cinque minuti.
Manca l’icona del martello, nessun server MCP visibile. Causa: errore di sintassi in claude_desktop_config.json o percorso del comando errato. Esegua un lint JSON, imposti percorsi assoluti e riavvii completamente l’applicazione.
L’applicazione si avvia e su Linux si chiude subito. Causa: librerie di sistema mancanti. Avvii l’applicazione dal terminale, legga il messaggio di errore e installi i pacchetti mancanti.
Cosa va storto spesso nella rete aziendale
Zscaler. Quando Zscaler rifirma il traffico, Claude Desktop rifiuta il certificato. Soluzione: escludere api.anthropic.com dalla TLS inspection oppure inserire il certificato radice di Zscaler nel trust store di sistema.
Intune. I pacchetti applicativi per Intune richiedono il percorso di rilevamento corretto. Se lo si salta, l’applicazione compare sui dispositivi solo dopo un intervento manuale.
Proxy con autenticazione. Imposti HTTPS_PROXY e HTTP_PROXY nel contesto di sistema, non solo nella shell dell’utente. Altrimenti l’applicazione non usa il proxy e va in timeout.