La mayoría de los fallos en Claude Desktop tienen causas conocidas. Antes de tocar la configuración, recorro tres pasos de diagnóstico; en la práctica eso ahorra un tiempo considerable.
Primero, tres pasos de diagnóstico
Abrir el archivo de registro. En macOS en ~/Library/Logs/Claude, en Windows en %APPDATA%\Claude\logs, en Linux en ~/.config/Claude/logs. Las últimas 50 líneas revelan el problema en la mayoría de los casos.
Comprobar el estado de Anthropic. Un vistazo a status.anthropic.com descarta que el fallo esté fuera de su propia instalación. Por experiencia, eso ahorra horas de búsqueda equivocada.
Aislar la ruta de red. Compartir la conexión desde el teléfono móvil muestra rápido si el responsable es la VPN, el proxy o Zscaler. Si la aplicación funciona con el punto de acceso, ya se sabe dónde buscar.
Índice de síntomas: los fallos más frecuentes
Pantalla negra o vacía al arrancar. Causa: conflicto de GPU o caché dañada. Borrar el directorio de caché, desactivar la aceleración por hardware y reiniciar.
La aplicación carga sin fin, el indicador gira. Causa: bloqueo de red por VPN, proxy o Zscaler. Permitir api.anthropic.com y probar brevemente sin VPN.
403 Forbidden o «invalid authorization». Causa: token caducado o cabecera de región modificada. Crear un token nuevo, comprobar el estado del plan y revisar si el proxy manipula cabeceras.
500 Internal Server Error. Causa: problema de servidor del lado de Anthropic. Comprobar status.anthropic.com y repetir pasados cinco minutos.
Falta el icono del martillo, no se ve ningún servidor MCP. Causa: error de sintaxis en claude_desktop_config.json o ruta de comando incorrecta. Pasar un JSON-Lint, poner rutas absolutas y reiniciar la aplicación por completo.
La aplicación arranca y se cierra de inmediato en Linux. Causa: faltan bibliotecas del sistema. Iniciar la aplicación desde el terminal, leer el mensaje de error e instalar los paquetes que falten.
Lo que suele fallar en la red corporativa
Zscaler. Cuando Zscaler vuelve a firmar el tráfico, Claude Desktop rechaza el certificado. Solución: excluir api.anthropic.com de la inspección TLS o instalar el certificado raíz de Zscaler en el almacén de confianza del sistema.
Intune. Los paquetes de aplicación para Intune necesitan la ruta de detección correcta. Quien se salta ese paso solo ve la aplicación en los dispositivos tras una intervención manual.
Proxy con autenticación. Definir HTTPS_PROXY y HTTP_PROXY en el contexto del sistema, no solo en el shell del usuario. De lo contrario la aplicación no usa el proxy y acaba en tiempos de espera agotados.