{"id":2315,"date":"2026-06-10T21:15:23","date_gmt":"2026-06-10T19:15:23","guid":{"rendered":"https:\/\/pletzenauer.com\/?p=2315"},"modified":"2026-08-21T12:41:13","modified_gmt":"2026-08-21T10:41:13","slug":"claude-desktop-resolver-erros","status":"publish","type":"post","link":"https:\/\/pletzenauer.com\/pt-pt\/2026\/06\/10\/claude-desktop-resolver-erros\/","title":{"rendered":"O Claude Desktop n\u00e3o responde? O meu percurso de diagn\u00f3stico estruturado"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">A maioria dos sintomas de erro no Claude Desktop tem causas conhecidas. Antes de mexer na configura\u00e7\u00e3o, percorro tr\u00eas passos de diagn\u00f3stico \u2013 na pr\u00e1tica poupa bastante tempo.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Primeiro, tr\u00eas passos de diagn\u00f3stico<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Abrir o ficheiro de registo.<\/strong> No macOS em <code>~\/Library\/Logs\/Claude<\/code>, no Windows em <code>%APPDATA%\\Claude\\logs<\/code>, no Linux em <code>~\/.config\/Claude\/logs<\/code>. Na maioria dos casos, as \u00faltimas 50 linhas revelam o problema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Verificar o estado da Anthropic.<\/strong> Um olhar a status.anthropic.com exclui que o erro esteja fora da pr\u00f3pria instala\u00e7\u00e3o. Pela experi\u00eancia, poupa horas de procura errada.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Isolar o caminho de rede.<\/strong> O tethering pelo telem\u00f3vel mostra depressa se a VPN, o proxy ou o Zscaler s\u00e3o os respons\u00e1veis. Se a aplica\u00e7\u00e3o funcionar no hotspot, j\u00e1 se sabe onde procurar.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">\u00cdndice de sintomas: os erros mais frequentes<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Ecr\u00e3 preto ou vazio ao arrancar.<\/strong> Causa: conflito de GPU ou cache danificada. Apagar a pasta da cache, desativar a acelera\u00e7\u00e3o por hardware, reiniciar.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>A aplica\u00e7\u00e3o carrega sem fim, o indicador roda.<\/strong> Causa: bloqueio de rede pela VPN, pelo proxy ou pelo Zscaler. Autorizar api.anthropic.com, testar por breves instantes sem VPN.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>403 Forbidden ou \u201einvalid authorization\u201c.<\/strong> Causa: token expirado ou cabe\u00e7alho de regi\u00e3o alterado. Criar um token novo, verificar o estado do plano, examinar o proxy quanto a manipula\u00e7\u00e3o de cabe\u00e7alhos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>500 Internal Server Error.<\/strong> Causa: problema de servidor do lado da Anthropic. Consultar status.anthropic.com, repetir passados cinco minutos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Falta o \u00edcone do martelo, n\u00e3o se veem servidores MCP.<\/strong> Causa: erro de sintaxe em claude_desktop_config.json ou caminho de comando errado. Passar um JSON-Lint, usar caminhos absolutos, reiniciar a aplica\u00e7\u00e3o por completo.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>A aplica\u00e7\u00e3o arranca e fecha-se logo no Linux.<\/strong> Causa: bibliotecas de sistema em falta. Iniciar a aplica\u00e7\u00e3o pelo terminal, ler a mensagem de erro, instalar os pacotes em falta.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">O que corre mal com frequ\u00eancia na rede da empresa<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Zscaler.<\/strong> Quando o Zscaler assina de novo o tr\u00e1fego, o Claude Desktop rejeita o certificado. Solu\u00e7\u00e3o: excluir api.anthropic.com da inspe\u00e7\u00e3o TLS ou colocar o certificado raiz do Zscaler no trust store do sistema.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Intune.<\/strong> Os pacotes de aplica\u00e7\u00e3o para o Intune precisam do caminho de dete\u00e7\u00e3o correto. Quem salta este passo s\u00f3 v\u00ea a aplica\u00e7\u00e3o nos dispositivos ap\u00f3s interven\u00e7\u00e3o manual.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Proxy autenticado.<\/strong> Definir HTTPS_PROXY e HTTP_PROXY no contexto do sistema, n\u00e3o apenas na shell do utilizador. Caso contr\u00e1rio a aplica\u00e7\u00e3o n\u00e3o usa o proxy e cai em timeouts.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>O Claude Desktop n\u00e3o responde? O meu percurso de diagn\u00f3stico estruturado, dos registos aos servidores MCP at\u00e9 ao rein\u00edcio \u2013 para resolver os erros rapidamente por si pr\u00f3prio.<\/p>\n","protected":false},"author":0,"featured_media":1460,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-2315","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-unkategorisiert"],"_links":{"self":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2315","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=2315"}],"version-history":[{"count":2,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2315\/revisions"}],"predecessor-version":[{"id":3161,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/posts\/2315\/revisions\/3161"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/media\/1460"}],"wp:attachment":[{"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=2315"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=2315"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pletzenauer.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=2315"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}