El Parpadeo de Terminal en Claude Code: Más de 700 Votos, 9 Meses, Aún Sin Resolver
Claude Code tiene un problema de renderizado de terminal tan grave que puede bloquear tu IDE completo, hacer tu sistema inutilizable y potencialmente desencadenar convulsiones en usuarios fotosensibles. Este error ha sido documentado desde marzo de 2025. Ha acumulado más de 1000 votos combinados a través de múltiples reportes. Y a diciembre de 2025, permanece sin solución.
La Magnitud de Este Desastre
El issue #3648 que documenta el desplazamiento de terminal completamente descontrolado tiene 282 reacciones de pulgar arriba. El issue #1913 tiene 181 pulgares arriba. El issue #769 de abril de 2025 tiene 168 pulgares arriba. Hay al menos una docena más de duplicados dispersos por el repositorio, todos describiendo el mismo problema fundamental.
Más de 1000 desarrolladores gritando sobre el mismo error no es un problema marginal, es una falla sistémica.
Un desarrollador realmente instrumentó lo que Claude Code hace a las terminales. Los hallazgos del issue #9935 son genuinamente impactantes: 4,000 a 6,700 eventos de desplazamiento por segundo. La causa raíz es que Claude Code realiza un redibujado completo de la terminal en cada fragmento de salida en streaming en lugar de hacer actualizaciones incrementales como cualquier aplicación de terminal sensata.
Lo Que Experimentan Los Usuarios
Míralo en acción: El [reporte de error original] incluye un video mostrando la terminal convirtiéndose en una luz estroboscópica durante el uso normal.
En VS Code y Cursor, la terminal comienza a parpadear, empeora progresivamente, luego todo el editor se congela y bloquea después de 10 a 20 minutos, llevándose todo el trabajo no guardado.
En terminales independientes, obtienes el efecto de luz estroboscópica sin los bloqueos. El historial de conversaciones antiguas parpadea mezclado con la nueva salida. La barra de desplazamiento salta erráticamente. Escribir mientras Claude piensa es un ejercicio de frustración.
La terminal comienza a desplazarse superrápido por sí sola y a menudo no puedes detenerla a menos que cierres la pestaña de terminal y reinicies Claude. Otras veces cuando intentas escribir tu prompt tienes que desplazarte repetidamente hacia abajo para encontrar dónde estás escribiendo.
Algunos usuarios reportan que el error genera hasta siete procesos paralelos de Claude Code, cada uno consumiendo CPU mientras la terminal parpadea sin cesar sin respuesta.
El Problema de Accesibilidad
El reporte de error original marcó explícitamente esto como una preocupación de accesibilidad. El parpadeo rápido de pantalla es un desencadenante conocido para la epilepsia fotosensible. Las Pautas de Accesibilidad para el Contenido Web advierten contra contenido que parpadea más de tres veces por segundo. Claude Code parpadea miles de veces por segundo.
Anthropic se promociona como profundamente comprometida con la seguridad de la IA, sin embargo han lanzado un producto con un peligro de accesibilidad conocido durante nueve meses.
Por Qué Esto Debería Ser Fácil de Arreglar
Esto no es algún problema arquitectónico profundo. La solución es conceptualmente simple: dejar de redibujar todo el búfer de terminal en cada actualización. Usar posicionamiento de cursor para actualizar solo lo que cambió. Esto es programación básica de terminal entendida desde los años 1970.
Si la interfaz visual elegante es demasiado compleja para renderizar incrementalmente, simplifícala. Dale a los usuarios un modo de texto plano que funcione sobre una interfaz bonita que bloquea su IDE.
Cómo Sobrevivir Hasta Que Lo Arreglen
Basado en hallazgos de la comunidad, aquí están las mejores soluciones temporales:
Para usuarios de Mac, abandona completamente la terminal del IDE. Usa una terminal bash independiente simple como la Terminal.app nativa o iTerm2. El parpadeo aún ocurre pero al menos no bloqueará todo tu entorno de desarrollo.
Reduce el historial de desplazamiento de terminal a 500 líneas o menos en la configuración de tu terminal. Esto no arregla el error pero reduce la severidad.
Usa /clear frecuentemente entre prompts para reiniciar el búfer. Esto retrasa pero no previene el eventual colapso.
Evita completamente las terminales integradas de VS Code y Cursor para sesiones de Claude Code. Las terminales externas manejan mejor el abuso.
Mantén las sesiones cortas. Si estás haciendo trabajo agéntico pesado con subagentes, espera que el parpadeo empeore. Reinicia antes de que se bloquee.
Desactiva la aceleración GPU y el desplazamiento suave en tu terminal si esas opciones existen.
La conclusión: nueve meses, más de 700 votos, 6,700 eventos de desplazamiento por segundo, cero solución. Usa soluciones temporales, mantén la paciencia y tal vez agrega tu voto a la pila.
Issues Relacionados en GitHub
- [#3648 - Terminal Scrolling Uncontrollably] - 282 votos, el issue de parpadeo más votado
- [#1913 - Terminal Flickering] - 181 votos
- [#769 - In-progress Call causes Screen Flickering] - 168 votos, el reporte comprensivo original de abril de 2025
- [#9935 - Excessive scroll events causing UI jitter] - Análisis técnico profundo mostrando 6,700 desplazamientos por segundo
- [#10794 - Critical: Terminal Flickering Causes Complete VSCode Crashes] - Documenta bloqueos completos del IDE en macOS
- [#9658 - Multiple Claude Code instances spawning] - Documenta generación descontrolada de procesos
- [#7276 - VS Code Terminal Flickering and Crash During Long Conversations] - Reportes de bloqueos de VS Code
- [#392 - Flickering display] - Uno de los reportes más tempranos de marzo de 2025
