Ein Beispiel ausprobieren
Die Beispiele auf dieser Seite sind Codeausschnitte, keine vollständigen Mods. Jedes Beispiel enthält den Code für ein Element und alles, was darin verschachtelt ist. Um ein Beispiel in Ihrem eigenen Terminal zu sehen, erstellen Sie mit den folgenden Schritten den kleinen Mod und fügen das Beispiel darin ein. Der Mod fügt einen Befehl/gallery hinzu, der einen Bereich öffnet und das Beispiel dort zeichnet. Ein Bereich ist in einem breiten Vollbild-Terminal eine Seitenleiste neben dem Transkript, andernfalls ein umrahmter Bereich oberhalb des Prompts.
1
Den Mod erstellen
Erstellen Sie ein Verzeichnis namens Geben Sie Ihren Einstiegspunkt in Speichern Sie den Code als
gallery mit den Verzeichnissen .claude-plugin und hooks darin. Einen Mod erstellen erläutert die Dateien.Speichern Sie das Manifest als gallery/.claude-plugin/plugin.json:gallery/.claude-plugin/plugin.json
gallery/hooks/hooks.json an:gallery/hooks/hooks.json
gallery/hooks/register.js. Er fügt einen Befehl /gallery hinzu, der einen Bereich öffnet, und zeichnet Plain text in diesem Bereich:gallery/hooks/register.js
2
Den Mod ausführen
Starten Sie Claude Code in Ihrer Shell aus dem Verzeichnis, das Führen Sie am Prompt von Claude Code
gallery enthält:/gallery aus. Ein Bereich mit Plain text darin öffnet sich.3
Ein Beispiel einsetzen
Kopieren Sie ein Beispiel von dieser Seite. Fügen Sie es in
register.js anstelle von Text({ children: ['Plain text'] }) ein, sodass es auf return folgt, und speichern Sie die Datei. Claude Code lädt das Modul bei jedem Speichern neu. Führen Sie daher /gallery erneut aus, um das neue Beispiel zu sehen.Ein Element auswählen
Die Beispiele sind danach gruppiert, was Sie auf dem Bildschirm darstellen möchten:- Text anzeigen:
Text,MarkdownundLink - Code und Änderungen anzeigen:
Code - Elemente anordnen:
Box - Eingaben entgegennehmen:
Button,InputundSelect - Bilder zeichnen:
Raster,Svg,ImageundClient
Text anzeigen
Drei Elemente bringen Wörter auf den Bildschirm:Text für Ihre eigene Formatierung, Markdown für Inhalte, die bereits formatiert sind, und Link für eine URL.
Text
Text zeichnet eine Zeichenkette mit den Stilen, die Sie angeben. Dieses Beispiel zeigt einfachen Text und acht Stile, jeweils einen pro Zeile:


dimColor zeichnet den Text in Grau. backgroundColor füllt nur so weit, wie der Text breit ist.
Markdown
Markdown formatiert Text so, wie die Antworten von Claude formatiert werden. Übergeben Sie den Inhalt in text, nicht in children:


#-Zeichen gezeichnet. Inline-Code wird farbig ohne seine Backticks gezeichnet. Ein Zitat wird kursiv mit einem Balken auf der linken Seite gezeichnet.
Link
Link zeichnet eine Beschriftung, gefolgt von ihrer URL:


Code und Änderungen anzeigen
Code stellt Quelltext mit den eigenen Syntaxfarben von Claude Code dar oder zeigt einen Diff an. In der VS Code-Erweiterung zeigt Code seine source als reinen Text an, ohne die Farben, Zeilennummern oder Diff-Schattierungen aus diesen Screenshots.
Code
Geben Sie die language an oder übergeben Sie einen path, aus dem Claude Code sie ableitet. Mit startLine werden die Zeilen ab dieser Zahl nummeriert:


Code als Diff
Mit format: 'diff' besteht source aus einem oder mehreren Unified-Diff-Hunks:


@@-Zeile Zeilennummern an. Wo sich eine entfernte und eine hinzugefügte Zeile ähneln, werden die geänderten Wörter stärker hervorgehoben.
Elemente anordnen
Box
Box ordnet seinen Inhalt in einer Zeile oder einer Spalte an und kann einen Rahmen zeichnen. Dieses Beispiel platziert eine Reihe von Wörtern über einer umrandeten Box:


Eingaben entgegennehmen
Button, Input und Select sind Steuerelemente: Der Benutzer wechselt mit Tab zwischen ihnen und verwendet dasjenige, das den Fokus hat. Tastaturfokus und Hotkeys beschreibt, welche Tasten sie erreichen.
Öffnen Sie einen Bereich mit focus: true, um den Tastaturfokus für ihn anzufordern. Getippte Buchstaben erreichen ein Input, sobald es den Fokus hat. Wie Sie festlegen, welches Feld beim Öffnen des Bereichs den Fokus hat, erfahren Sie unter Einen Hotkey und den ersten Fokus festlegen.
Button
Ein Button führt onPress aus. Dieses Beispiel zeigt die Standardform, einen plain-Button mit einem Hotkey und einen abgedunkelten Button:




Input
Ein Input ist ein Textfeld, das standardmäßig eine Zeile aufnimmt und onSubmit ausführt, wenn der Benutzer Enter drückt:


submitLabel wird nach ⏎ angezeigt:




rows auf 2 oder mehr für ein Feld, das mehrere Zeilen aufnimmt, etwa eine Notiz oder eine Commit-Nachricht:
rows erfordert Claude Code v2.1.301 oder höher. In früheren Versionen nimmt das Feld eine Zeile auf.
Das Feld belegt die von Ihnen festgelegte Anzahl an Zeilen, auch wenn es leer ist, bis zur Höhe des Bereichs oder Bands, in dem es dargestellt wird. Solange das Feld den Fokus hat, scrollt längerer Text darin.
- Im Terminal sendet Enter weiterhin ab. Dort beginnt der Benutzer eine neue Zeile, indem er einen Backslash tippt und dann Enter drückt, oder indem er Shift+Enter drückt, sofern der Terminal-Emulator dies unterstützt. Das sind dieselben Tasten wie im Prompt.
- Im Terminal wechseln die Pfeiltasten nach oben und unten zwischen den Zeilen des Feldes. Von der ersten bzw. letzten Zeile aus wechseln sie zum vorherigen bzw. nächsten Steuerelement.
onSubmitundonInputerhalten den gesamten Text, dessen Zeilen durch\nverbunden sind.
Select
Ein Select lässt den Benutzer eine von mehreren Optionen auswählen und führt onSelect mit dem value der Option aus:






Bilder zeichnen
Raster
Ein Raster ist ein Gitter aus farbigen Zeichenzellen, etwa für eine Heatmap, eine Sparkline oder ein Spielbrett. Das Terminal zeichnet es. Dieses Beispiel verwendet die Funktion cellsOf im Startermodul, die die Zellen in den String packt, den ein Raster erwartet. Ein Gitter aus farbigen Zellen zeichnen erklärt sie:


Raster rundet jede Farbe auf eine kleinere Palette, sodass 0x2e7d32 als #337733 gezeichnet wird.
Svg
Ein Svg zeichnet ein SVG-Dokument in der Desktop-App und der VS Code-Erweiterung:
Svg zurückgibt, leer geöffnet. Um dort etwas anderes zu zeichnen, prüfen Sie e.surface und geben Sie einen anderen Baum zurück.
Image und Client
Image und Client haben hier kein Beispiel. Image zeichnet ein PNG oder Rohpixel im Terminal. Client ist ein Bereich, den eine zweite Datei von Ihnen zeichnet, für Animationen und Zeigereingaben. Die Elementreferenz listet ihre Props auf.
Ein Image wird in diesen Terminals als Bild gezeichnet:
- kitty 0.28 oder höher
- Ghostty
- iTerm2 3.5 oder höher. Das Zeichnen in iTerm2 erfordert Claude Code v2.1.305 oder höher.
alt-Text des Image abgeblendet. Schreiben Sie alt-Text, der für sich allein verständlich ist, denn er wird unter anderem auch in diesen Fällen angezeigt:
- GNU screen: eine Sitzung, die innerhalb von screen läuft, in jedem Terminal.
- tmux: eine Sitzung, die innerhalb von tmux läuft und eine Voraussetzung für das Zeichnen innerhalb von tmux nicht erfüllt.
- Hintergrundsitzungen: jede Hintergrundsitzung, unabhängig davon, von welchem Terminal aus sie verbunden ist.
- iTerm2 außerhalb des Fullscreen-Renderings: In iTerm2 wird das Bild nur beim Fullscreen-Rendering gezeichnet, und nicht, solange
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTauf1gesetzt ist. Um das Bild zu sehen, führen Sie/tui fullscreenim Claude Code-Prompt aus und lassen Sie diese Variable ungesetzt. - Ein Dateipfad als Quelle in iTerm2 oder tmux: In iTerm2 und innerhalb von tmux zeigt ein
Image, dessensourceeinefileangibt, denalt-Text statt des Bildes an. Wenn Ihr Mod Benutzer mit iTerm2 oder tmux hat, übergeben Sie das Bild als Base64 insource.pngodersource.rgbastatt als Pfad insource.file.
CLAUDE_CODE_FORCE_TERMINAL_IMAGES auf 1 setzen. Sie sollten die Variable nicht innerhalb von GNU screen, innerhalb von tmux älter als 3.3, in einem tmux-Popup oder bei deaktiviertem allow-passthrough von tmux setzen. Dort sehen sie kein Bild und anstelle des alt-Textes ein Kästchen.
Ein Image innerhalb von tmux zeichnen
Wenn ein Image innerhalb von tmux seinen alt-Text anzeigt, prüfen Sie diese Voraussetzungen zusammen mit den anderen Fällen für den alt-Text, etwa einer Hintergrundsitzung:
- Claude Code v2.1.310 oder höher
- tmux 3.3 oder höher
- Claude Code läuft in einem tmux-Pane, nicht in einem tmux-Popup
- tmux läuft innerhalb von kitty 0.28 oder höher, Ghostty oder iTerm2 3.5 oder höher
- Die tmux-Optionen
focus-eventsundallow-passthroughsind aufongesetzt. Innerhalb von kitty oder Ghostty kannallow-passthroughauchallsein. - Innerhalb von iTerm2 läuft tmux ohne
-CC, das Fullscreen-Rendering ist aktiviert undCLAUDE_CODE_ALT_SCREEN_FULL_REPAINTist nicht gesetzt. - Innerhalb von iTerm2 ist das tmux-Fenster nicht größer als das iTerm2-Fenster. Führen Sie zur Prüfung
tmux display-message -p '#{window_bigger}'in diesem tmux-Fenster aus. Wenn1ausgegeben wird, passen Sie das tmux-Fenster an und starten Sie Claude Code anschließend neu. - Der Autor des Mods übergibt das Bild als
png- oderrgba-Bytes, nicht alsfile-Pfad. Wenn Sie einen Mod verwenden, den Sie nicht selbst geschrieben haben, und die anderen Voraussetzungen erfüllt sind, bitten Sie dessen Autor, diesen Punkt zu prüfen.
~/.tmux.conf hinzu.
Sehen, wo ein Mod zeichnen kann
Die Beispiele zeichnen alle in einem Bereich. Ein Mod kann auch an anderen Stellen zeichnen und Claude Code aufrufen, damit es etwas für ihn anzeigt:- Bereich und Band: Auswählen, wo gezeichnet wird
- Die eigenen Zeilen von Claude Code, etwa der Spinner: Ändern, was Claude Code bereits zeichnet
- Toast, Statuszeile und Log-Zeile: Etwas anzeigen, ohne einen Turn zu starten
- Fragedialog: Einen Tool-Aufruf zurückhalten, bis der Benutzer entscheidet
Nächste Schritte
- In der Oberfläche zeichnen: Erstellen Sie Schritt für Schritt einen Bereich mit Tabs
- Eine Zeichnung testen: Drücken Sie Ihre Schaltflächen aus einem Test heraus
- Referenz der Elemente: die wichtigsten Props jedes Elements und die Apps, die es zeichnen