Essayer un exemple
Les exemples de cette page sont des extraits, et non des mods complets. Chacun correspond au code d’un élément et de tout ce qui y est imbriqué. Pour voir un exemple dans votre propre terminal, créez le petit mod décrit dans ces étapes et collez-y l’exemple. Le mod ajoute une commande/gallery qui ouvre un panneau et y dessine l’exemple. Un panneau est une barre latérale à côté de la transcription dans un terminal large en plein écran, ou sinon une zone encadrée au-dessus du prompt.
1
Créer le mod
Créez un répertoire nommé Indiquez votre point d’entrée dans Enregistrez le code sous
gallery contenant les répertoires .claude-plugin et hooks. Créer un mod explique les fichiers.Enregistrez le manifeste sous gallery/.claude-plugin/plugin.json :gallery/.claude-plugin/plugin.json
gallery/hooks/hooks.json :gallery/hooks/hooks.json
gallery/hooks/register.js. Il ajoute une commande /gallery qui ouvre un panneau, et dessine Plain text dans ce panneau :gallery/hooks/register.js
2
Exécuter le mod
Dans votre shell, démarrez Claude Code depuis le répertoire qui contient Dans le prompt de Claude Code, exécutez
gallery :/gallery. Un panneau s’ouvre et affiche Plain text.3
Remplacer par un exemple
Copiez un exemple de cette page. Dans
register.js, collez-le à la place de Text({ children: ['Plain text'] }), de sorte qu’il suive return, puis enregistrez le fichier. Claude Code recharge le module à chaque enregistrement : exécutez donc à nouveau /gallery pour voir le nouvel exemple.Choisir un élément
Les exemples sont regroupés selon ce que vous souhaitez afficher à l’écran :- Afficher du texte :
Text,MarkdownetLink - Afficher du code et des modifications :
Code - Disposer des éléments :
Box - Recueillir une saisie :
Button,InputetSelect - Dessiner des images :
Raster,Svg,ImageetClient
Afficher du texte
Trois éléments affichent des mots à l’écran :Text pour votre propre mise en forme, Markdown pour un contenu déjà formaté, et Link pour une URL.
Text
Text dessine une chaîne avec les styles que vous lui donnez. Cet exemple affiche du texte brut et huit styles, un par ligne :


dimColor dessine le texte en gris. backgroundColor ne remplit que la largeur du texte.
Markdown
Markdown met en forme le texte de la même manière que les réponses de Claude. Transmettez le contenu dans text, et non dans children :


#. Le code en ligne s’affiche en couleur sans ses backticks. Une citation s’affiche en italique avec une barre à sa gauche.
Link
Link dessine un libellé suivi de son URL :


Afficher du code et des modifications
Code dessine du texte source avec les couleurs syntaxiques propres à Claude Code, ou un diff. Dans l’extension VS Code, Code affiche son source en texte brut, sans les couleurs, les numéros de ligne ni l’ombrage de diff visibles sur ces captures d’écran.
Code
Indiquez le language, ou transmettez un path à partir duquel Claude Code le déduira. Avec startLine, les lignes sont numérotées à partir de ce nombre :


Code sous forme de diff
Avec format: 'diff', source contient un ou plusieurs blocs de diff unifié :


@@. Lorsqu’une ligne supprimée et une ligne ajoutée se ressemblent, les mots modifiés reçoivent une teinte plus prononcée.
Disposer des éléments
Box
Box dispose son contenu en ligne ou en colonne, et peut dessiner une bordure. Cet exemple place une ligne de mots au-dessus d’une boîte avec bordure :


Recevoir des saisies
Button, Input et Select sont des contrôles : l’utilisateur passe de l’un à l’autre avec Tab et utilise celui qui a le focus. Focus clavier et raccourcis clavier indique quelles touches leur parviennent.
Ouvrez un panneau avec focus: true pour demander le focus clavier pour celui-ci. Les lettres saisies parviennent à un Input dès qu’il a le focus. Pour choisir quel champ a le focus à l’ouverture du panneau, consultez Définir un raccourci clavier et le premier focus.
Button
Un bouton exécute onPress. Cet exemple montre la forme par défaut, un bouton plain avec un raccourci clavier, et un bouton atténué :




Input
Un Input est un champ de texte qui contient une ligne par défaut et exécute onSubmit lorsque l’utilisateur appuie sur Enter :


submitLabel s’affiche après ⏎ :




rows sur 2 ou plus pour un champ qui contient plusieurs lignes, comme une note ou un message de commit :
rows nécessite Claude Code v2.1.301 ou une version ultérieure. Sur les versions antérieures, le champ contient une seule ligne.
Le champ occupe le nombre de lignes que vous définissez, même lorsqu’il est vide, dans la limite de la hauteur du panneau ou de la bande dans laquelle il est affiché. Tant que le champ a le focus, un texte plus long défile à l’intérieur.
- Dans le terminal, Enter soumet toujours. L’utilisateur y commence une nouvelle ligne en tapant une barre oblique inverse puis en appuyant sur Enter, ou en appuyant sur Shift+Enter lorsque l’émulateur de terminal le prend en charge. Ce sont les mêmes touches que dans le prompt.
- Dans le terminal, les flèches Haut et Bas permettent de passer d’une ligne à l’autre du champ. Depuis sa première et sa dernière ligne, elles passent au contrôle précédent ou suivant.
onSubmitetonInputreçoivent l’intégralité du texte, avec ses lignes jointes par\n.
Select
Un Select permet à l’utilisateur de choisir une option parmi plusieurs, et exécute onSelect avec la value de l’option :






Dessiner des images
Raster
Un Raster est une grille de cellules de caractères colorées, pour une carte de chaleur, une sparkline ou un plateau de jeu. Le terminal la dessine. Cet exemple utilise la fonction cellsOf du module de départ, qui regroupe les cellules dans la chaîne attendue par un Raster. Dessiner une grille de cellules colorées l’explique :


Raster arrondit chaque couleur à une palette plus restreinte : 0x2e7d32 s’affiche donc en #337733.
Svg
Un Svg dessine un document SVG dans l’application Desktop et l’extension VS Code :
Svg s’ouvre vide. Pour y dessiner autre chose, vérifiez e.surface et renvoyez une arborescence différente.
Image et Client
Image et Client n’ont pas d’exemple ici. Image dessine un PNG ou des pixels bruts dans le terminal. Client est une zone dessinée par un second fichier de votre part, pour l’animation et la saisie au pointeur. La référence des éléments répertorie leurs props.
Une Image s’affiche sous forme d’image dans ces terminaux :
- kitty 0.28 ou ultérieur
- Ghostty
- iTerm2 3.5 ou ultérieur. L’affichage dans iTerm2 nécessite Claude Code v2.1.305 ou ultérieur.
alt de l’Image, atténué, à la place de l’image. Rédigez un texte alt qui se suffit à lui-même, car il s’affiche aussi dans les cas suivants, entre autres :
- GNU screen : une session exécutée dans screen, dans n’importe quel terminal.
- tmux : une session exécutée dans tmux qui ne remplit pas une condition requise pour dessiner dans tmux.
- Sessions en arrière-plan : toute session en arrière-plan, quel que soit le terminal depuis lequel elle est rattachée.
- iTerm2 hors rendu plein écran : dans iTerm2, l’image ne s’affiche qu’avec le rendu plein écran, et pas lorsque
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTest défini sur1. Pour voir l’image, exécutez/tui fullscreendans le prompt de Claude Code et laissez cette variable non définie. - Une source par chemin de fichier dans iTerm2 ou tmux : dans iTerm2 et dans tmux, une
Imagedont lasourcedésigne unfileaffiche le textealtau lieu de l’image. Si votre mod a des utilisateurs d’iTerm2 ou de tmux, transmettez l’image en base64 danssource.pngousource.rgbaplutôt que sous forme de chemin danssource.file.
CLAUDE_CODE_FORCE_TERMINAL_IMAGES sur 1. Ils ne doivent pas la définir dans GNU screen, dans une version de tmux antérieure à 3.3, dans une popup tmux, ni lorsque l’option allow-passthrough de tmux est désactivée. Dans ces cas, ils ne voient aucune image, et une case remplace le texte alt.
Dessiner une Image dans tmux
Si une Image affiche son texte alt dans tmux, vérifiez ces conditions ainsi que les autres cas d’affichage du texte alt, comme une session en arrière-plan :
- Claude Code v2.1.310 ou ultérieur
- tmux 3.3 ou ultérieur
- Claude Code s’exécute dans un panneau tmux, et non dans une popup tmux
- tmux s’exécute dans kitty 0.28 ou ultérieur, Ghostty, ou iTerm2 3.5 ou ultérieur
- Les options tmux
focus-eventsetallow-passthroughsont suron. Dans kitty ou Ghostty,allow-passthroughpeut aussi valoirall. - Dans iTerm2, tmux s’exécute sans
-CC, le rendu plein écran est activé etCLAUDE_CODE_ALT_SCREEN_FULL_REPAINTn’est pas définie. - Dans iTerm2, la fenêtre tmux n’est pas plus grande que la fenêtre iTerm2. Pour le vérifier, exécutez
tmux display-message -p '#{window_bigger}'dans cette fenêtre tmux. Si la commande affiche1, ajustez la taille de la fenêtre tmux, puis redémarrez Claude Code. - L’auteur du mod transmet l’image sous forme d’octets
pngourgba, et non sous forme de cheminfile. Si vous utilisez un mod que vous n’avez pas écrit et que les autres conditions sont remplies, demandez à son auteur de vérifier ce point.
~/.tmux.conf.
Voir où un mod peut dessiner
Tous les exemples dessinent dans un panneau. Un mod peut aussi dessiner à d’autres endroits, et appeler Claude Code pour afficher quelque chose à sa place :- Panneau et bandeau : Choisir où dessiner
- Les lignes propres à Claude Code, comme le spinner : Modifier ce que Claude Code dessine déjà
- Toast, barre de statut et ligne de log : Afficher quelque chose sans démarrer un tour
- Boîte de dialogue de question : Suspendre un appel d’outil jusqu’à la décision de l’utilisateur
Étapes suivantes
- Dessiner dans l’interface : créer un panneau avec des onglets, étape par étape
- Tester un dessin : appuyer sur vos boutons depuis un test
- Référence des éléments : les principales props de chaque élément et les applications qui le dessinent