Erros Comuns do Claude Code e Como Resolver — A Referência Completa
O Claude Code para de repente com "faça login novamente", "limite de taxa", "prompt longo demais", "o MCP não conecta" — e pesquisar cada um no Google vira um saco. Esta é uma referência prática que cataloga os erros que você costuma encontrar, com a causa e o comando a rodar para cada um. Começa pelos três comandos de diagnóstico para rodar primeiro (claude doctor para diagnóstico completo, /status para a autenticação ativa, /context para o detalhamento do contexto), depois foca nas quatro famílias mais comuns (uso/limites de taxa, estouro de contexto, autenticação expirada, falhas de conexão do MCP) com tabelas sintoma→causa→comando-de-solução para autenticação e login, uso/limites de taxa (o Claude Code queima de 10 a 100x os tokens do chat), contexto e tokens (prompt longo demais, compactação travando), servidor e modelo (500/529/timeout/model not found), instalação/PATH/atualização, rede e proxy (ECONNREFUSED, TLS), MCP, permissões (deny vence o bypass) e diversos (thinking blocks 400, imagem/PDF, IDE). Termina com um guia rápido erro→solução e um FAQ. Baseado na documentação oficial do Claude Code (em 2026): quando travar, rode os três comandos de diagnóstico, e se não resolver, rode claude update.