Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
El renderizado a pantalla completa es una vista previa de investigación opcional y requiere Claude Code v2.1.89 o posterior. Ejecute
/tui fullscreen para cambiar en su conversación actual, o establezca CLAUDE_CODE_NO_FLICKER=1 en versiones anteriores a v2.1.110. 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
Ejecute/tui fullscreen dentro de cualquier conversación de Claude Code. La CLI guarda la configuración tui y se reinicia en pantalla completa con su conversación intacta, por lo que puede cambiar a mitad de sesión sin perder contexto. Ejecute /tui sin argumentos para imprimir qué renderizador está activo.
También puede establecer la variable de entorno CLAUDE_CODE_NO_FLICKER antes de iniciar Claude Code:
tui y la variable de entorno son equivalentes. El comando /tui borra CLAUDE_CODE_NO_FLICKER del proceso reiniciado para que la configuración que escribe tenga efecto.
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 para modo de transcripción, luego / para buscar o [ para escribir en el desplazamiento | 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://yhttps://se abren en su navegador. En la mayoría de terminales, esto reemplaza elCmd-clic oCtrl-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 usandoCmd-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.
/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.
Con una selección activa, mantenga presionada Shift y presione las teclas de flecha para extenderla desde el teclado. Shift+↑ y Shift+↓ desplazan la ventana gráfica cuando la selección alcanza el borde superior o inferior. Shift+Home y Shift+End extienden hasta el inicio o final de la línea actual.
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.
Estas acciones se pueden reenlazar. Consulte Acciones de desplazamiento para obtener la lista completa de nombres de acciones, incluidas variantes de media página y página completa que no tienen enlace predeterminado.
Seguimiento automático
El desplazamiento hacia arriba pausa el seguimiento automático para que la nueva salida no lo devuelva al final. PresioneCtrl+End o desplácese hacia abajo para reanudar el seguimiento.
Para desactivar completamente el seguimiento automático para que la vista permanezca donde la deje, abra /config y establezca Auto-scroll en desactivado. Con el desplazamiento automático desactivado, la vista nunca salta al final por sí sola. Los avisos de permiso y otros diálogos que necesitan una respuesta aún se desplazan a la vista independientemente de esta configuración.
Desplazamiento de la rueda del ratón
El desplazamiento de la rueda del ratón requiere que su terminal reenvíe eventos de ratón a Claude Code. La mayoría de terminales hacen esto siempre que una aplicación lo solicite. iTerm2 lo convierte en una configuración por perfil: si la rueda no hace nada peroPgUp y PgDn funcionan, abra Configuración → Perfiles → Terminal y active Habilitar informe de ratón. La misma configuración también es necesaria para que funcionen el clic para expandir y la selección de texto.
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:
3 coincide con el predeterminado en vim y aplicaciones similares. La configuración acepta valores de 1 a 20.
Para ajustar la velocidad de desplazamiento de forma interactiva, ejecute /scroll-speed. El diálogo muestra una regla que puede desplazar mientras está abierto para que pueda sentir el cambio inmediatamente. Presione ← y → para ajustar, r para restablecer al valor predeterminado detectado automáticamente, e Intro para guardar. El comando escribe el mismo valor que establece la variable de entorno CLAUDE_CODE_SCROLL_SPEED, persistido en ~/.claude/settings.json. El comando no está disponible en la terminal del IDE de JetBrains.
Desplazamiento en la terminal del IDE de JetBrains
En la terminal del IDE de JetBrains, Claude Code aplica su propio manejo de desplazamiento e ignoraCLAUDE_CODE_SCROLL_SPEED. La terminal envía eventos de desplazamiento a una velocidad mucho más alta que otros emuladores, por lo que un multiplicador ajustado en otro lugar se excede aquí.
En 2025.2, la terminal también tiene errores de desplazamiento de rueda que producen teclas de flecha espurias y eventos de dirección incorrecta. Claude Code detecta estos en tiempo de ejecución y los mitiga automáticamente, por lo que el desplazamiento del trackpad y la rueda del ratón funcionan sin configuración. Para la mejor experiencia de desplazamiento, actualice a 2025.3 o posterior. Claude Code muestra una sugerencia la primera vez que se desplaza si detecta el error.
Buscar y revisar la conversación
Ctrl+o alterna entre el indicador normal y el modo de transcripción. Para una vista más tranquila que muestre solo su último indicador, un resumen de una línea de llamadas de herramientas con estadísticas de diferencias de edición y la respuesta final, ejecute /focus. La configuración persiste entre sesiones. Ejecute /focus nuevamente para desactivarla.
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 |
Ctrl+o, Esc, o q | Salir del modo de transcripción y volver al indicador |
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 queCmd+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 conEscoq, que lo devuelve al renderizado a pantalla completa. El siguienteCtrl+ocomienza de nuevo.v: escribe la conversación en un archivo temporal y la abre en$VISUALo$EDITOR.
Esc o q para volver al indicador.
Limpiar la conversación
PresioneCtrl+L dos veces dentro de dos segundos para ejecutar /clear e iniciar una nueva conversación. El primer pulso redibuja la pantalla y muestra una sugerencia; el segundo pulso borra la conversación. En macOS, presionar dos veces Cmd+K también ejecuta /clear.
Usar con tmux
El renderizado a pantalla completa funciona dentro de tmux, con tres 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:
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.
tmux no admite salida sincronizada, por lo que puede ver más parpadeo durante los redibujados que cuando ejecuta Claude Code directamente en su terminal. Si el parpadeo es notable, especialmente a través de SSH, ejecute Claude Code en su propia pestaña de terminal fuera de tmux.
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 secuencias de escape OSC 52, que algunos terminales bloquean de forma predeterminada. iTerm2 las bloquea hasta que active Configuración → General → Selección → Las aplicaciones en el terminal pueden acceder al portapapeles. Ejecutar/terminal-setup en iTerm2 habilita esto para usted. Claude Code imprime un aviso después de cada copia diciéndole qué ruta utilizó.
Para una selección nativa puntual, mantenga presionado el modificador de omisión de su terminal mientras hace clic y arrastra: Option en iTerm2, o Shift en la mayoría de terminales de Linux y Windows. El modificador le indica a su terminal que maneje la selección por sí mismo en lugar de reenviar eventos de ratón a Claude Code, por lo que Cmd+C y otros atajos de copia de su terminal funcionan en ella.
Si confía en la selección nativa todo el tiempo, 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:
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, ejecute /tui default, o desestablezca CLAUDE_CODE_NO_FLICKER si la habilitó de esa manera. Para forzar el renderizador clásico independientemente de la configuración tui guardada, establezca CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. El renderizador clásico mantiene la conversación en el desplazamiento nativo de su terminal para que Cmd+f y el modo de copia de tmux funcionen como de costumbre.