Prueba un ejemplo
Los ejemplos de esta página son fragmentos, no mods completos. Cada uno es el código de un elemento y de todo lo que está anidado dentro de él. Para ver un ejemplo en tu propia terminal, crea el pequeño mod de estos pasos y pega el ejemplo en él. El mod agrega un comando/gallery que abre un panel y dibuja el ejemplo allí. Un panel es una barra lateral junto a la transcripción en una terminal ancha de pantalla completa, o una región enmarcada encima del prompt en caso contrario.
1
Crea el mod
Crea un directorio llamado Indica tu punto de entrada en Guarda el código como
gallery con los directorios .claude-plugin y hooks dentro. Crear un mod explica los archivos.Guarda el manifiesto como gallery/.claude-plugin/plugin.json:gallery/.claude-plugin/plugin.json
gallery/hooks/hooks.json:gallery/hooks/hooks.json
gallery/hooks/register.js. Agrega un comando /gallery que abre un panel y dibuja Plain text en ese panel:gallery/hooks/register.js
2
Ejecuta el mod
En tu shell, inicia Claude Code desde el directorio que contiene En el prompt de Claude Code, ejecuta
gallery:/gallery. Se abre un panel con Plain text.3
Sustituye por un ejemplo
Copia un ejemplo de esta página. En
register.js, pégalo sobre Text({ children: ['Plain text'] }), de modo que quede después de return, y guarda el archivo. Claude Code recarga el módulo cada vez que guardas, así que ejecuta /gallery de nuevo para ver el nuevo ejemplo.Elige un elemento
Los ejemplos están agrupados según lo que quieras mostrar en pantalla:- Mostrar texto:
Text,MarkdownyLink - Mostrar código y cambios:
Code - Organizar elementos:
Box - Recibir entrada:
Button,InputySelect - Dibujar imágenes:
Raster,Svg,ImageyClient
Mostrar texto
Tres elementos ponen palabras en la pantalla:Text para tu propio estilo, Markdown para contenido que ya tiene formato y Link para una URL.
Text
Text dibuja una cadena con los estilos que le indiques. Este ejemplo muestra texto sin formato y ocho estilos, uno en cada línea:


dimColor dibuja el texto en gris. backgroundColor rellena solo el ancho del texto.
Markdown
Markdown da formato al texto de la misma manera en que se formatean las respuestas de Claude. Pasa el contenido en text, no en children:


#. El código en línea se dibuja en color sin sus comillas invertidas. Una cita se dibuja en cursiva con una barra a su izquierda.
Link
Link dibuja una etiqueta seguida de su URL:


Mostrar código y cambios
Code dibuja texto fuente con los propios colores de sintaxis de Claude Code, o un diff. En la extensión de VS Code, Code muestra su source como texto plano, sin los colores, los números de línea ni el sombreado de diff de estas capturas de pantalla.
Code
Indica el language, o pasa un path para que Claude Code lo infiera a partir de él. Con startLine, las líneas se numeran a partir de ese número:


Code como diff
Con format: 'diff', source es uno o más fragmentos (hunks) de diff unificado:


@@. Cuando una línea eliminada y una línea añadida se parecen, las palabras que cambiaron reciben un sombreado más intenso.
Organizar elementos
Box
Box distribuye lo que contiene en una fila o una columna, y puede dibujar un borde. Este ejemplo coloca una fila de palabras sobre un cuadro con borde:


Recibir entrada
Button, Input y Select son controles: el usuario se mueve entre ellos con Tab y usa el que tiene el foco. Foco del teclado y teclas de acceso rápido explica qué teclas llegan a ellos.
Abre un panel con focus: true para solicitar el foco del teclado para ese panel. Las letras que escribes llegan a un Input una vez que tiene el foco. Para elegir qué campo tiene el foco cuando se abre el panel, consulta Establecer una tecla de acceso rápido y el primer foco.
Button
Un botón ejecuta onPress. Este ejemplo muestra la forma predeterminada, un botón plain con una tecla de acceso rápido y uno atenuado:




Input
Un Input es un campo de texto que contiene una sola línea de forma predeterminada y ejecuta onSubmit cuando el usuario presiona Enter:


submitLabel se muestra después de ⏎:




rows en 2 o más para un campo que contenga varias líneas, como una nota o un mensaje de commit:
rows requiere Claude Code v2.1.301 o posterior. En versiones anteriores, el campo contiene una sola línea.
El campo ocupa la cantidad de filas que establezcas, incluso cuando está vacío, hasta la altura del panel o la franja en la que se dibuja. Mientras el campo tiene el foco, el texto más largo se desplaza dentro de él.
- En la terminal, Enter sigue enviando. Allí, el usuario inicia una nueva línea escribiendo una barra invertida y luego presionando Enter, o presionando Shift+Enter donde el emulador de terminal lo admite. Son las mismas teclas que en el prompt.
- En la terminal, Arriba y Abajo se mueven entre las filas del campo. Desde su primera y su última fila, pasan al control anterior o siguiente.
onSubmityonInputreciben el texto completo con sus líneas unidas por\n.
Select
Un Select permite al usuario elegir una de varias opciones y ejecuta onSelect con el value de la opción:






Dibujar imágenes
Raster
Un Raster es una cuadrícula de celdas de caracteres de colores, para un mapa de calor, un sparkline o un tablero de juego. La terminal lo dibuja. Este ejemplo usa la función cellsOf del módulo inicial, que empaqueta las celdas en la cadena que recibe un Raster. Dibujar una cuadrícula de celdas de colores lo explica:


Raster redondea cada color a una paleta más pequeña, por lo que 0x2e7d32 se dibuja como #337733.
Svg
Un Svg dibuja un documento SVG en la aplicación Desktop y en la extensión de VS Code:
Svg se abre vacío. Para dibujar otra cosa allí, comprueba e.surface y devuelve un árbol diferente.
Image y Client
Image y Client no tienen ejemplo aquí. Image dibuja un PNG o píxeles sin procesar en la terminal. Client es una región que dibuja un segundo archivo tuyo, para animación y entrada de puntero. La referencia de elementos enumera sus props.
Un Image se dibuja como imagen en estas terminales:
- kitty 0.28 o posterior
- Ghostty
- iTerm2 3.5 o posterior. Dibujar en iTerm2 requiere Claude Code v2.1.305 o posterior.
alt de un Image, atenuado, en lugar de la imagen. Escribe un texto alt que se entienda por sí solo, porque también se muestra en estos casos, entre otros:
- GNU screen: una sesión que se ejecuta dentro de screen, en cualquier terminal.
- tmux: una sesión que se ejecuta dentro de tmux y no cumple un requisito para dibujar dentro de tmux.
- Sesiones en segundo plano: toda sesión en segundo plano, sea cual sea la terminal desde la que se conecte.
- iTerm2 fuera del renderizado a pantalla completa: en iTerm2 la imagen solo se dibuja con el renderizado a pantalla completa, y no mientras
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTesté establecida en1. Para ver la imagen, ejecuta/tui fullscreenen el prompt de Claude Code y deja esa variable sin establecer. - Una ruta de archivo como origen en iTerm2 o tmux: en iTerm2 y dentro de tmux, un
Imagecuyosourceindica unfilemuestra el textoalten lugar de la imagen. Si tu mod tiene usuarios de iTerm2 o tmux, pasa la imagen como base64 ensource.pngosource.rgbaen lugar de como ruta ensource.file.
CLAUDE_CODE_FORCE_TERMINAL_IMAGES en 1. No deberían establecerla dentro de GNU screen, dentro de tmux anterior a 3.3, en un popup de tmux ni con la opción allow-passthrough de tmux desactivada. En esos casos no ven ninguna imagen, sino un recuadro en lugar del texto alt.
Dibujar un Image dentro de tmux
Si un Image muestra su texto alt dentro de tmux, comprueba estos requisitos junto con los otros casos de texto alt, como una sesión en segundo plano:
- Claude Code v2.1.310 o posterior
- tmux 3.3 o posterior
- Claude Code se ejecuta en un panel de tmux, no en un popup de tmux
- tmux se ejecuta dentro de kitty 0.28 o posterior, Ghostty o iTerm2 3.5 o posterior
- Las opciones de tmux
focus-eventsyallow-passthroughestán enon. Dentro de kitty o Ghostty,allow-passthroughtambién puede serall. - Dentro de iTerm2, tmux se ejecuta sin
-CC, el renderizado a pantalla completa está activado yCLAUDE_CODE_ALT_SCREEN_FULL_REPAINTno está establecida. - Dentro de iTerm2, la ventana de tmux no es más grande que la ventana de iTerm2. Para comprobarlo, ejecuta
tmux display-message -p '#{window_bigger}'en esa ventana de tmux. Si imprime1, ajusta la ventana de tmux y luego reinicia Claude Code. - El autor del mod pasa la imagen como bytes
pngorgba, no como una rutafile. Si usas un mod que no escribiste y se cumplen los demás requisitos, pide a su autor que compruebe este.
~/.tmux.conf.
Ve dónde puede dibujar un mod
Todos los ejemplos dibujan en un panel. Un mod también puede dibujar en otros lugares y llamar a Claude Code para que muestre algo por él:- Panel y banda: Elige dónde dibujar
- Las propias filas de Claude Code, como el spinner: Cambia lo que Claude Code ya dibuja
- Toast, línea de estado y línea de registro: Muestra algo sin iniciar un turno
- Diálogo de pregunta: Retén una llamada a herramienta hasta que el usuario decida
Próximos pasos
- Dibuja en la interfaz: crea un panel con pestañas, paso a paso
- Prueba un dibujo: presiona tus botones desde una prueba
- Referencia de elementos: las props principales de cada elemento y las apps que lo dibujan