O Claude Desktop não responde? O meu percurso de diagnóstico estruturado

A maioria dos sintomas de erro no Claude Desktop tem causas conhecidas. Antes de mexer na configuração, percorro três passos de diagnóstico – na prática poupa bastante tempo.

Primeiro, três passos de diagnóstico

Abrir o ficheiro de registo. No macOS em ~/Library/Logs/Claude, no Windows em %APPDATA%\Claude\logs, no Linux em ~/.config/Claude/logs. Na maioria dos casos, as últimas 50 linhas revelam o problema.

Verificar o estado da Anthropic. Um olhar a status.anthropic.com exclui que o erro esteja fora da própria instalação. Pela experiência, poupa horas de procura errada.

Isolar o caminho de rede. O tethering pelo telemóvel mostra depressa se a VPN, o proxy ou o Zscaler são os responsáveis. Se a aplicação funcionar no hotspot, já se sabe onde procurar.

Índice de sintomas: os erros mais frequentes

Ecrã preto ou vazio ao arrancar. Causa: conflito de GPU ou cache danificada. Apagar a pasta da cache, desativar a aceleração por hardware, reiniciar.

A aplicação carrega sem fim, o indicador roda. Causa: bloqueio de rede pela VPN, pelo proxy ou pelo Zscaler. Autorizar api.anthropic.com, testar por breves instantes sem VPN.

403 Forbidden ou „invalid authorization“. Causa: token expirado ou cabeçalho de região alterado. Criar um token novo, verificar o estado do plano, examinar o proxy quanto a manipulação de cabeçalhos.

500 Internal Server Error. Causa: problema de servidor do lado da Anthropic. Consultar status.anthropic.com, repetir passados cinco minutos.

Falta o ícone do martelo, não se veem servidores MCP. Causa: erro de sintaxe em claude_desktop_config.json ou caminho de comando errado. Passar um JSON-Lint, usar caminhos absolutos, reiniciar a aplicação por completo.

A aplicação arranca e fecha-se logo no Linux. Causa: bibliotecas de sistema em falta. Iniciar a aplicação pelo terminal, ler a mensagem de erro, instalar os pacotes em falta.

O que corre mal com frequência na rede da empresa

Zscaler. Quando o Zscaler assina de novo o tráfego, o Claude Desktop rejeita o certificado. Solução: excluir api.anthropic.com da inspeção TLS ou colocar o certificado raiz do Zscaler no trust store do sistema.

Intune. Os pacotes de aplicação para o Intune precisam do caminho de deteção correto. Quem salta este passo só vê a aplicação nos dispositivos após intervenção manual.

Proxy autenticado. Definir HTTPS_PROXY e HTTP_PROXY no contexto do sistema, não apenas na shell do utilizador. Caso contrário a aplicação não usa o proxy e cai em timeouts.