El renderizado a pantalla completa es una vista previa de investigación opcional y requiere Claude Code v2.1.88 o posterior. Habilítelo con CLAUDE_CODE_NO_FLICKER=1. El comportamiento puede cambiar según los comentarios. vim o htop, y solo renderiza los mensajes que están actualmente visibles. Esto reduce la cantidad de datos enviados a su terminal en cada actualización.
La diferencia es más notable en emuladores de terminal donde el rendimiento de renderizado es el cuello de botella, como la terminal integrada de VS Code, tmux e iTerm2. Si su posición de desplazamiento de terminal salta a la parte superior mientras Claude está trabajando, o la pantalla parpadea mientras la salida de herramientas se transmite, este modo aborda esos problemas.
El término pantalla completa describe cómo Claude Code se apodera de la superficie de dibujo de la terminal, de la manera que lo hace vim. No tiene nada que ver con maximizar su ventana de terminal, y funciona en cualquier tamaño de ventana.
Habilitar renderizado a pantalla completa
Establezca la variable de entorno CLAUDE_CODE_NO_FLICKER al iniciar Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
~/.zshrc o ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
Qué cambia
El renderizado a pantalla completa cambia cómo la CLI dibuja en su terminal. El cuadro de entrada permanece fijo en la parte inferior de la pantalla en lugar de moverse mientras la salida se transmite. Si la entrada permanece en su lugar mientras Claude está trabajando, el renderizado a pantalla completa está activo. Solo los mensajes visibles se mantienen en el árbol de renderizado, por lo que la memoria permanece constante independientemente de la longitud de la conversación.
Debido a que la conversación vive en el búfer de pantalla alternativa en lugar del desplazamiento de su terminal, algunas cosas funcionan de manera diferente:
| Antes | Ahora | Detalles |
|---|
Cmd+f o búsqueda de tmux para encontrar texto | Ctrl+o luego / para buscar, o Ctrl+o luego [ para escribir la conversación en el desplazamiento nativo para que Cmd+f funcione nuevamente | Buscar y revisar la conversación |
| Clic y arrastre nativo de la terminal para seleccionar y copiar | Selección en la aplicación, se copia automáticamente al soltar el ratón | Usar el ratón |
Cmd-clic para abrir una URL | Haga clic en la URL | Usar el ratón |
Usar el ratón
El renderizado a pantalla completa captura eventos de ratón y los maneja dentro de Claude Code:
- Haga clic en la entrada del indicador para posicionar su cursor en cualquier lugar del texto que está escribiendo.
- Haga clic en un resultado de herramienta contraído para expandirlo y ver la salida completa. Haga clic nuevamente para contraerlo. La llamada de herramienta y su resultado se expanden juntos. Solo los mensajes que tienen más para mostrar son clicables.
- Haga clic en una URL o ruta de archivo para abrirla. Las rutas de archivo en la salida de herramientas, como las impresas después de una edición o escritura, se abren en su aplicación predeterminada. Las URLs simples
http:// y https:// se abren en su navegador. En la mayoría de terminales, esto reemplaza el Cmd-clic o Ctrl-clic nativo, que la captura de ratón intercepta. En la terminal integrada de VS Code y terminales similares basadas en xterm.js, continúe usando Cmd-clic. Claude Code se remite al manejador de enlaces propio de la terminal para evitar abrir enlaces dos veces.
- Haga clic y arrastre para seleccionar texto en cualquier lugar de la conversación. El doble clic selecciona una palabra, coincidiendo con los límites de palabras de iTerm2 para que una ruta de archivo se seleccione como una unidad. El triple clic selecciona la línea.
- Desplácese con la rueda del ratón para moverse a través de la conversación.
El texto seleccionado se copia a su portapapeles automáticamente al soltar el ratón. Para desactivar esto, alterne Copiar al seleccionar en /config. Con esto desactivado, presione Ctrl+Shift+c para copiar manualmente. En terminales que admiten el protocolo de teclado kitty, como kitty, WezTerm, Ghostty e iTerm2, Cmd+c también funciona. Si tiene una selección activa, Ctrl+c copia en lugar de cancelar.
Desplazarse por la conversación
El renderizado a pantalla completa maneja el desplazamiento dentro de la aplicación. Use estos atajos de teclado para navegar:
| Atajo de teclado | Acción |
|---|
PgUp / PgDn | Desplazarse hacia arriba o hacia abajo media pantalla |
Ctrl+Home | Saltar al inicio de la conversación |
Ctrl+End | Saltar al último mensaje y reactivar el seguimiento automático |
| Rueda del ratón | Desplazarse algunas líneas a la vez |
PgUp, PgDn, Home o End, como teclados de MacBook, mantenga presionada Fn con las teclas de flecha: Fn+↑ envía PgUp, Fn+↓ envía PgDn, Fn+← envía Home, y Fn+→ envía End. Eso hace que Ctrl+Fn+→ sea el atajo de teclado para saltar al final. Si eso se siente incómodo, desplácese hacia abajo con la rueda del ratón para reanudar el seguimiento, o reenlace scroll:bottom a algo accesible.
El desplazamiento hacia arriba pausa el seguimiento automático para que la nueva salida no lo devuelva al final. Presione Ctrl+End o desplácese hacia abajo para reanudar el seguimiento.
Estas acciones se pueden reenlazar. Consulte Atajos de teclado para personalizarlos. Los nombres de acción son scroll:pageUp, scroll:pageDown, scroll:top y scroll:bottom. Las acciones adicionales sin enlace predeterminado incluyen scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp y scroll:fullPageDown.
Ajustar la velocidad de desplazamiento de la rueda
Si el desplazamiento de la rueda del ratón se siente lento, su terminal puede estar enviando un evento de desplazamiento por muesca física sin multiplicador. Algunas terminales, como Ghostty e iTerm2 con desplazamiento más rápido habilitado, ya amplifican eventos de rueda. Otros, incluida la terminal integrada de VS Code, envían exactamente un evento por muesca. Claude Code no puede detectar cuál.
Establezca CLAUDE_CODE_SCROLL_SPEED para multiplicar la distancia de desplazamiento base:
export CLAUDE_CODE_SCROLL_SPEED=3
3 coincide con el predeterminado en vim y aplicaciones similares. La configuración acepta valores de 1 a 20.
Buscar y revisar la conversación
Presione Ctrl+o para entrar en modo de transcripción. Con el renderizado a pantalla completa activo, el modo de transcripción gana navegación y búsqueda de estilo less:
| Tecla | Acción |
|---|
/ | Abrir búsqueda. Escriba para encontrar coincidencias, Enter para aceptar, Esc para cancelar y restaurar su posición de desplazamiento |
n / N | Saltar a la siguiente o anterior coincidencia. Funciona después de cerrar la barra de búsqueda |
j / k o ↑ / ↓ | Desplazarse una línea |
g / G o Home / End | Saltar al inicio o final |
Ctrl+u / Ctrl+d | Desplazarse media página |
Ctrl+b / Ctrl+f o Space / b | Desplazarse una página completa |
Esc, q, o Ctrl+o | Salir del modo de transcripción |
Cmd+f de su terminal y la búsqueda de tmux no ven la conversación porque vive en el búfer de pantalla alternativa, no en el desplazamiento nativo. Para devolver el contenido a su terminal, presione Ctrl+o para entrar en modo de transcripción primero, luego:
[: escribe la conversación completa en el búfer de desplazamiento nativo de su terminal, con toda la salida de herramientas expandida. La conversación es ahora texto ordinario en su terminal, por lo que Cmd+f, modo de copia de tmux y cualquier otra herramienta nativa pueden buscar o seleccionarla. Las sesiones largas pueden pausarse por un momento mientras esto sucede. Esto dura hasta que salga del modo de transcripción con Esc o q, que lo devuelve al renderizado a pantalla completa. El siguiente Ctrl+o comienza de nuevo.v: escribe la conversación en un archivo temporal y la abre en $VISUAL o $EDITOR.
Presione Esc, q, o Ctrl+o para volver al indicador.
Usar con tmux
El renderizado a pantalla completa funciona dentro de tmux, con dos advertencias.
El desplazamiento de la rueda del ratón requiere el modo de ratón de tmux. Si su ~/.tmux.conf no lo habilita ya, agregue esta línea y recargue su configuración:
Sin modo de ratón, los eventos de rueda van a tmux en lugar de Claude Code. El desplazamiento de teclado con PgUp y PgDn funciona de cualquier manera. Claude Code imprime una sugerencia única al inicio si detecta tmux con modo de ratón desactivado.
El renderizado a pantalla completa es incompatible con el modo de integración de tmux de iTerm2, que es el modo en el que entra con tmux -CC. En modo de integración, iTerm2 renderiza cada panel de tmux como una división nativa en lugar de permitir que tmux dibuje en la terminal. El búfer de pantalla alternativa y el seguimiento de ratón no funcionan correctamente allí: la rueda del ratón no hace nada, y el doble clic puede corromper el estado de la terminal. No habilite el renderizado a pantalla completa en sesiones tmux -CC. El tmux regular dentro de iTerm2, sin -CC, funciona bien.
Mantener la selección de texto nativa
La captura de ratón es el punto de fricción más común, especialmente sobre SSH o dentro de tmux. Cuando Claude Code captura eventos de ratón, la copia nativa al seleccionar de su terminal deja de funcionar. La selección que realiza con clic y arrastre existe dentro de Claude Code, no en el búfer de selección de su terminal, por lo que el modo de copia de tmux, sugerencias de Kitty y herramientas similares no la ven.
Claude Code intenta escribir la selección en su portapapeles, pero la ruta que utiliza depende de su configuración. Dentro de tmux escribe en el búfer de pegado de tmux. Sobre SSH se vuelve a OSC 52 secuencias de escape, que algunos terminales bloquean de forma predeterminada. Claude Code imprime un aviso después de cada copia diciéndole qué ruta utilizó.
Si confía en la selección nativa de su terminal, establezca CLAUDE_CODE_DISABLE_MOUSE=1 para optar por no participar en la captura de ratón mientras mantiene el renderizado sin parpadeos y la memoria plana:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
PgUp, PgDn, Ctrl+Home y Ctrl+End aún funciona, y su terminal maneja la selección de forma nativa. Pierde clic para posicionar el cursor, clic para expandir la salida de herramientas, clic en URL y desplazamiento de rueda dentro de Claude Code.
Vista previa de investigación
El renderizado a pantalla completa es una característica de vista previa de investigación. Ha sido probado en emuladores de terminal comunes, pero puede encontrar problemas de renderizado en terminales menos comunes o configuraciones inusuales.
Si encuentra un problema, ejecute /feedback dentro de Claude Code para reportarlo, o abra un problema en el repositorio de GitHub de claude-code. Incluya el nombre y la versión de su emulador de terminal.
Para desactivar el renderizado a pantalla completa, desestablezca la variable de entorno o establezca CLAUDE_CODE_NO_FLICKER=0.
