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.