Cómo arreglar el parpadeo de Claude Code en la terminal
Elimina el parpadeo de Claude Code o los saltos de scroll con /tui fullscreen, CLAUDE_CODE_NO_FLICKER o la salida sincronizada. Soluciones para tmux, VS Code y Windows.
- CLI
- 0.2.17
- Ref de preview
- a2c45c8
En resumen
Ejecuta esto dentro de Claude Code:
/tui fullscreenCambia al renderizador a pantalla completa de Claude Code, que Anthropic describe como libre de parpadeo. La conversación se reinicia intacta y el ajuste se guarda para futuras sesiones. Para volver atrás, ejecuta /tui default.
Otras soluciones según la causa:
- Solo parpadea y tu terminal admite salida sincronizada: inicia con
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claude. Así mantienes el renderizador clásico. - Prefieres una variable de entorno:
CLAUDE_CODE_NO_FLICKER=1 claudeactiva el renderizado a pantalla completa al arrancar. - Dentro de tmux: actualiza tmux o ejecuta Claude Code en su propia pestaña de terminal.
- Restos de texto en Windows Terminal:
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1.
El renderizado a pantalla completa es una vista previa de investigación en la documentación de Anthropic, consultada el 26 de octubre de 2026, así que los detalles pueden cambiar.
El problema
Los síntomas son conocidos. La pantalla parpadea mientras llega la salida de las herramientas. El scroll salta arriba mientras Claude trabaja. En una sesión larga la terminal se vuelve más lenta y el parpadeo empeora. Se nota sobre todo en terminales donde la velocidad de dibujo es el cuello de botella. Anthropic menciona la terminal integrada de VS Code, tmux e iTerm2.
La causa es que el renderizador clásico vuelve a dibujar gran parte de la pantalla en cada actualización. Las soluciones cambian la forma en que dibuja Claude Code o le piden a la terminal que aplique cada actualización de una vez.
Solución 1: cambia Claude Code al renderizado a pantalla completa
/tui fullscreenEl renderizado a pantalla completa dibuja en el búfer de pantalla alternativo de la terminal, como hacen vim o htop, y solo renderiza los mensajes visibles. Envía menos datos por actualización, mantiene estable la memoria en conversaciones largas y añade soporte de ratón. "Pantalla completa" se refiere a ocupar la superficie de dibujo. Funciona con cualquier tamaño de ventana.
Lo que se conserva al reiniciar: la conversación tal como se ve en pantalla, tu modo de permisos y nivel de effort, el modelo que elegiste con /model y opciones como --allowed-tools y --agent.
Para ver qué renderizador está activo:
/tuiSi el cuadro de entrada se queda fijo abajo mientras Claude trabaja, la pantalla completa está activada.
Qué cambia en el modo a pantalla completa
Como la conversación vive en el búfer de pantalla alternativo, el historial de scroll y la búsqueda de tu terminal no la ven:
| Antes | En pantalla completa |
|---|---|
Cmd+f o la búsqueda de tmux | Ctrl+o para el modo transcripción y luego / para buscar |
| Seleccionar arrastrando para copiar | Selección dentro de la app, se copia al soltar el ratón |
| Historial de scroll de la terminal | Rueda del ratón, PgUp y PgDn dentro de Claude Code |
En el modo transcripción, [ vuelca toda la conversación en el historial de scroll nativo de la terminal y v la abre en tu editor.
Si la captura del ratón te molesta, mantén el renderizador y desactiva el ratón:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claudeSolución 2: activa la salida sincronizada y mantén el renderizador clásico
Algunas terminales admiten la salida sincronizada, que aplica cada redibujado como una sola actualización, pero no lo anuncian de forma que Claude Code lo detecte. Anthropic pone como ejemplo eat de Emacs. En esos casos, fuérzala:
CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 claudeAsí desaparece el parpadeo sin cambiar de renderizador, y el historial de scroll y la selección nativos siguen funcionando.
Solución 3: define CLAUDE_CODE_NO_FLICKER
Para activar el renderizado a pantalla completa con una variable de entorno:
CLAUDE_CODE_NO_FLICKER=1 claudeEn PowerShell:
$env:CLAUDE_CODE_NO_FLICKER = "1"; claudeO en settings.json:
{
"env": {
"CLAUDE_CODE_NO_FLICKER": "1"
}
}Arreglar el parpadeo de Claude Code en tmux
La página de pantalla completa de Anthropic dice que las versiones de tmux hasta la serie 3.6 no implementan la salida sincronizada, así que los redibujados pueden parpadear más en tmux que directamente en una terminal. El registro de cambios de la v2.1.201 también incluye una corrección del parpadeo en tmux 3.4 y posteriores activando la salida sincronizada. Si sigue parpadeando:
-
Actualiza Claude Code con
claude update. -
Actualiza tmux a una versión reciente.
-
Prueba el renderizado a pantalla completa. Para desplazarte con la rueda del ratón dentro de él, activa el modo ratón de tmux:
# ~/.tmux.conf set -g mouse on -
Si persiste, ejecuta Claude Code en su propia pestaña de terminal fuera de tmux.
No uses el renderizado a pantalla completa con el modo de integración de tmux de iTerm2 (tmux -CC). La documentación de Anthropic dice que la rueda del ratón no hace nada y que el doble clic puede corromper el estado de la terminal. tmux normal dentro de iTerm2 funciona.
Arreglar el parpadeo en la terminal de VS Code
La terminal integrada de VS Code es una de las que Anthropic señala como limitadas en rendimiento. La solución principal es el renderizado a pantalla completa. Para la selección nativa con el ratón capturado, mantén pulsado Shift, o Option en macOS con terminal.integrated.macOptionClickForcesSelection activado.
Arreglar restos de texto en Windows Terminal
Si quedan fragmentos antiguos en pantalla hasta que cambias el tamaño de la ventana, la terminal está combinando mal las actualizaciones incrementales de Claude Code. Anthropic menciona Windows Terminal y otros hosts basados en ConPTY. Haz que repinte todas las celdas:
$env:CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT = "1"
claudePara un redibujado puntual, pulsa Ctrl+L. Conserva la conversación y lo que estés escribiendo.
Seguir la sesión fuera de la terminal
Algunos casos de parpadeo vienen de vigilar una ejecución larga en una terminal pequeña, a menudo por SSH desde otro dispositivo. Si el objetivo es seguir la sesión más que escribir en la TUI, otra vista ayuda más que ajustar el renderizador.
Si quieres seguir y guiar Claude Code desde el móvil o un navegador en lugar de una ventana de terminal, Happier es una app de código abierto para ejecutar y orquestar Claude Code, Codex y otros agentes entre dispositivos, desde el móvil, el escritorio o la web. Muestra la sesión como una transcripción de mensajes y llamadas a herramientas en su propia interfaz, así que en ese dispositivo no interviene el renderizador de la terminal. Cuando sí quieres la TUI real de Claude, la opción de terminal unificada de Claude de Happier puede ejecutarla en tmux o zellij. Hay que activarla y se aplica a sesiones nuevas.
La configuración está en Cómo usar Happier desde el móvil. Happier está en GitHub, puedes descargarlo aquí y hay un Discord.
Solución de problemas
Cannot switch renderers in this session
Claude Code muestra los motivos y no cambia. En el modo lector de pantalla siempre usa el renderizador clásico, salvo en sesiones en segundo plano adjuntas. Inicia una sesión nueva con CLAUDE_CODE_NO_FLICKER=1 si el motivo lo permite.
Un aviso de que el renderizador a pantalla completa no terminó de arrancar
Claude Code cuenta los arranques fallidos a pantalla completa y vuelve al renderizador clásico. Tras un arranque fallido sigue respetando CLAUDE_CODE_NO_FLICKER, pero no el ajuste guardado. Actualiza Claude Code y tu terminal y vuelve a probar /tui fullscreen.
Copiar y pegar ha dejado de funcionar
La pantalla completa captura el ratón. Mantén pulsada la tecla de selección de tu terminal (Option en iTerm2, Fn en Terminal.app, Shift en la mayoría de las demás) o define CLAUDE_CODE_DISABLE_MOUSE=1.
Preguntas frecuentes
¿Por qué parpadea Claude Code?
El renderizador clásico vuelve a dibujar gran parte de la pantalla mientras llega la salida. Las terminales que dibujan despacio, o que aplican actualizaciones parciales, lo muestran como parpadeo o saltos.
¿El modo a pantalla completa cambia cómo trabaja Claude?
No. Cambia cómo dibuja la CLI. El modelo, los permisos y las herramientas son los mismos.
¿El renderizado a pantalla completa usa menos memoria?
La documentación de Anthropic dice que solo mantiene los mensajes visibles en el árbol de renderizado, así que la memoria se mantiene constante sea cual sea la longitud de la conversación.