Claude Code parpadea en la terminal: cómo quitarlo sin perder la sesión

TL;DR Escribe /tui. Si responde Current renderer: default, estás en el renderer clásico, el que parpadea: ejecuta /tui fullscreen y Claude Code se relanza en el renderer sin flicker con la conversación intacta. Para buscar en la conversación, Ctrl+o y luego /.

Si la pantalla de Claude Code parpadea mientras salen los resultados de las herramientas, o la terminal salta al principio del scroll mientras Claude trabaja, estás en el renderer clásico. Claude Code tiene dos formas de dibujar la interfaz. La clásica escribe en la pantalla normal de la terminal, la que guarda el scrollback, y en cada actualización le manda mucho texto. La fullscreen dibuja en el alternate screen buffer, como vim o htop, y solo renderiza los mensajes que se ven: menos datos por actualización, sin parpadeo, y la memoria plana aunque la conversación sea larga.

Se nota sobre todo donde el cuello de botella es lo rápido que la terminal pinta: la terminal integrada de VS Code, tmux e iTerm2. "Fullscreen" no tiene nada que ver con maximizar la ventana: funciona a cualquier tamaño.

En cuál estás

No todo el mundo arranca en el mismo. Si empezaste a usar Claude Code el 6 de mayo de 2026 o después, lo normal es que ya estés en fullscreen; si tu instalación es anterior, sigues en el clásico salvo que lo cambiaras. Lo comprueba /tui sin argumentos. Así responde en Claude Code v2.1.310, en una sesión de prueba con la configuración vacía:

❯ /tui
  ⎿  Current renderer: default. Usage: /tui <default|fullscreen>

default es el clásico. Hay casos en los que te deja en el clásico aunque tu instalación sea nueva:

Si el motivo es un arranque fallido, la línea Current renderer lo dice entre paréntesis; ese caso lo cubre el tip del "Unrecoverable interface error".

Cómo cambiarte

1. Ejecuta /tui fullscreen dentro de la sesión

❯ /tui fullscreen

Claude Code guarda el ajuste y se relanza. Al volver lo confirma así:

  ✔ Using flicker-free rendering · if you want to go back, use /tui default
    · Click to move your cursor in the text input
    · Click to expand collapsed tool results
    · By default, text auto-copies when you select it (/config to change)
    · Hold Shift (Option in iTerm2, Fn in Terminal.app) while selecting to use your terminal's native copy instead

La conversación sigue en pantalla, y con ella tu modo de permisos, el nivel de effort y el modelo que elegiste con /model. El cambio queda en tu ~/.claude/settings.json, así que las próximas sesiones ya arrancan en fullscreen:

{
  "tui": "fullscreen"
}

2. Si responde "Cannot switch renderers in this session"

Claude Code se niega a relanzar cuando la sesión tiene algo que no puede pasar al proceso nuevo: un --system-prompt que reemplaza el de serie, una allowlist con --tools, --setting-sources, o reglas deny o ask que un hook añadió solo para esa sesión. Con --setting-sources responde esto y no toca nada:

  ⎿  Cannot switch renderers in this session — it has restrictions a restart can't carry over (launch flags: a custom
     system prompt, a tool allowlist, or restricted settings). Nothing was changed. Running /tui default in a session
     started without them switches every later session too.

En ese caso, ejecuta /tui fullscreen en una sesión normal, o arranca esta con la variable, que manda sobre el ajuste guardado:

CLAUDE_CODE_NO_FLICKER=1 claude

Con "tui": "default" guardado y la variable a 1, /tui responde Current renderer: fullscreen.

3. Si usas tmux, activa el ratón

Sin el modo ratón de tmux, la rueda la recibe tmux y no Claude Code. Claude Code lo detecta y lo avisa:

tmux detected · scroll with PgUp/PgDn · or add 'set -g mouse on' to ~/.tmux.conf for wheel scroll

Añade la línea a ~/.tmux.conf y recarga la configuración:

set -g mouse on

Las versiones de tmux hasta la serie 3.6 no implementan la salida sincronizada, así que dentro de tmux puede quedar algo de parpadeo en los redibujados. Si lo ves, actualiza tmux o ejecuta Claude Code en su propia pestaña. Y nunca actives fullscreen en tmux -CC: la rueda no hace nada y el doble clic puede corromper el estado de la terminal.

Lo que cambia

La conversación ya no vive en el scrollback de tu terminal, sino en el alternate screen. El prompt se queda fijo abajo mientras sale la respuesta: si no se mueve, fullscreen está activo. Tres costumbres cambian:

Si necesitas el texto en el scrollback de verdad, entra con Ctrl+o y pulsa [: escribe la conversación entera en la terminal, con todo expandido, hasta que salgas con Esc o q. Si lo que te molesta es que capture el ratón, CLAUDE_CODE_DISABLE_MOUSE=1 deja la selección nativa y mantiene el renderer sin flicker.

En Windows Terminal pueden quedar trozos de texto antiguo en pantalla hasta que cambias el tamaño de la ventana; CLAUDE_CODE_ALT_SCREEN_FULL_REPAINT=1 repinta todas las celdas en cada frame. Y si la pantalla se ve rota, Ctrl+L la redibuja sin perder nada.

Volver al clásico

Fullscreen sigue en research preview. /tui default te devuelve al clásico y, antes de relanzar, puede preguntarte por qué:

  Fullscreen feedback
  To help us make fullscreen mode better, what made you switch back?
  >
  Enter to send · Esc to skip

Esc lo salta y el ajuste vuelve a "tui": "default". Para forzar el clásico en una sola sesión sin tocar el ajuste, CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 claude.

Con fullscreen activo, /diff además abre el panel de diff lateral junto a la conversación. Y si lo que notas no es parpadeo sino una sesión que pierde fluidez o se come la RAM, la lista de fixes para cuando Claude Code se ralentiza empieza por otro sitio.

Documentación oficial: Fullscreen rendering