Errores comunes de Claude Code y cómo solucionarlos — La referencia completa
Claude Code se detiene de repente con «vuelve a iniciar sesión», «límite de tasa», «el prompt es demasiado largo», «MCP no conecta», y buscar cada uno en Google acaba siendo tedioso. Esta es una referencia práctica que cataloga los errores que verás con más frecuencia, con la causa y el comando que debes ejecutar para cada uno. Empieza con los tres comandos de diagnóstico iniciales (claude doctor para el diagnóstico completo, /status para la autenticación activa, /context para el desglose del contexto), y luego se centra en las cuatro familias comunes (uso/límites de tasa, desbordamiento de contexto, autenticación caducada, fallos de conexión de MCP) con tablas de síntoma→causa→comando de solución sobre autenticación e inicio de sesión, uso/límites de tasa (Claude Code consume entre 10 y 100 veces más tokens que el chat), contexto y tokens (prompt demasiado largo, compactación en bucle), servidor y modelo (500/529/timeout/modelo no encontrado), instalación/PATH/actualización, red y proxy (ECONNREFUSED, TLS), MCP, permisos (denegar gana a bypass) y otros (error 400 de thinking blocks, imagen/PDF, IDE). Termina con una chuleta de error→solución y preguntas frecuentes. Basado en la documentación oficial de Claude Code (a fecha de 2026): cuando te atasques, ejecuta los tres comandos de diagnóstico y, si no se arregla, ejecuta claude update.