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.
Vollbildrendering ist eine optionale Forschungsvorschau und erfordert Claude Code v2.1.89 oder später. Führen Sie
/tui fullscreen aus, um in Ihrem aktuellen Gespräch zu wechseln, oder setzen Sie CLAUDE_CODE_NO_FLICKER=1 auf Versionen vor v2.1.110. Das Verhalten kann sich basierend auf Feedback ändern.vim oder htop, und rendert nur Nachrichten, die derzeit sichtbar sind. Dies reduziert die Menge der Daten, die bei jeder Aktualisierung an Ihr Terminal gesendet werden.
Der Unterschied ist am deutlichsten in Terminal-Emulatoren, bei denen der Rendering-Durchsatz der Engpass ist, wie das VS Code integrierte Terminal, tmux und iTerm2. Wenn Ihre Terminal-Scroll-Position nach oben springt, während Claude arbeitet, oder der Bildschirm flackert, während die Tool-Ausgabe einströmt, behebt dieser Modus diese Probleme.
Der Begriff Vollbild beschreibt, wie Claude Code die Zeichenfläche des Terminals übernimmt, wie
vim es tut. Es hat nichts damit zu tun, Ihr Terminal-Fenster zu maximieren, und funktioniert bei jeder Fenstergröße.Vollbildrendering aktivieren
Führen Sie/tui fullscreen in einem beliebigen Claude Code Gespräch aus. Die CLI speichert die tui Einstellung und startet mit Ihrem Gespräch intakt in den Vollbildmodus neu, sodass Sie die Sitzung wechseln können, ohne den Kontext zu verlieren. Führen Sie /tui ohne Argument aus, um zu drucken, welcher Renderer aktiv ist.
Sie können auch die Umgebungsvariable CLAUDE_CODE_NO_FLICKER vor dem Starten von Claude Code setzen:
tui Einstellung und die Umgebungsvariable sind gleichwertig. Der /tui Befehl löscht CLAUDE_CODE_NO_FLICKER aus dem neu gestarteten Prozess, sodass die Einstellung, die er schreibt, wirksam wird.
Was sich ändert
Vollbildrendering ändert, wie die CLI auf Ihr Terminal zeichnet. Das Eingabefeld bleibt am unteren Bildschirmrand fixiert, anstatt sich zu bewegen, wenn die Ausgabe einströmt. Wenn die Eingabe stillsteht, während Claude arbeitet, ist Vollbildrendering aktiv. Nur sichtbare Nachrichten werden im Render-Baum beibehalten, sodass der Speicher unabhängig von der Gesprächslänge konstant bleibt. Da das Gespräch im alternativen Bildschirmpuffer statt in Ihrem Terminal-Scrollback lebt, funktionieren einige Dinge anders:| Vorher | Jetzt | Details |
|---|---|---|
Cmd+f oder tmux-Suche zum Finden von Text | Ctrl+o für Transkript-Modus, dann / zum Suchen oder [ zum Schreiben in Scrollback | Gespräch durchsuchen und überprüfen |
| Natives Klicken und Ziehen des Terminals zum Auswählen und Kopieren | In-App-Auswahl, wird beim Loslassen der Maus automatisch kopiert | Maus verwenden |
Cmd-Klick zum Öffnen einer URL | Klicken Sie auf die URL | Maus verwenden |
Maus verwenden
Vollbildrendering erfasst Mausereignisse und verarbeitet sie in Claude Code:- Klicken Sie in die Eingabeaufforderung, um Ihren Cursor überall im eingegebenen Text zu positionieren.
- Klicken Sie auf ein eingeklapptes Tool-Ergebnis, um es zu erweitern und die vollständige Ausgabe anzuzeigen. Klicken Sie erneut, um es zu reduzieren. Der Tool-Aufruf und sein Ergebnis werden zusammen erweitert. Nur Nachrichten, die mehr zu zeigen haben, sind anklickbar.
- Klicken Sie auf eine URL oder einen Dateipfad, um ihn zu öffnen. Dateipfade in der Tool-Ausgabe, wie die nach einem Edit oder Write gedruckten, öffnen sich in Ihrer Standardanwendung. Einfache
http://undhttps://URLs öffnen sich in Ihrem Browser. In den meisten Terminals ersetzt dies nativesCmd-Klicken oderCtrl-Klicken, das die Mauserfassung abfängt. Im VS Code integrierten Terminal und ähnlichen xterm.js-basierten Terminals verwenden Sie weiterhinCmd-Klick. Claude Code überlässt dort den Link-Handler des Terminals, um zu vermeiden, dass Links zweimal geöffnet werden. - Klicken und ziehen Sie, um Text überall im Gespräch auszuwählen. Doppelklick wählt ein Wort aus und entspricht iTerm2s Wortgrenzen, sodass ein Dateipfad als eine Einheit ausgewählt wird. Dreifachklick wählt die Zeile aus.
- Scrollen Sie mit dem Mausrad, um sich durch das Gespräch zu bewegen.
/config um. Wenn es ausgeschaltet ist, drücken Sie Ctrl+Shift+c, um manuell zu kopieren. Auf Terminals, die das Kitty-Tastaturprotokoll unterstützen, wie Kitty, WezTerm, Ghostty und iTerm2, funktioniert auch Cmd+c. Wenn Sie eine Auswahl aktiv haben, kopiert Ctrl+c statt zu stornieren.
Mit einer aktiven Auswahl halten Sie Shift und drücken die Pfeiltasten, um sie von der Tastatur aus zu erweitern. Shift+↑ und Shift+↓ scrollen den Viewport, wenn die Auswahl die obere oder untere Kante erreicht. Shift+Home und Shift+End erweitern bis zum Anfang oder Ende der aktuellen Zeile.
Gespräch scrollen
Vollbildrendering verarbeitet das Scrollen in der App. Verwenden Sie diese Verknüpfungen zum Navigieren:| Verknüpfung | Aktion |
|---|---|
PgUp / PgDn | Scrollen Sie um die Hälfte eines Bildschirms nach oben oder unten |
Ctrl+Home | Springen Sie zum Anfang des Gesprächs |
Ctrl+End | Springen Sie zur neuesten Nachricht und aktivieren Sie das automatische Folgen erneut |
| Mausrad | Scrollen Sie ein paar Zeilen auf einmal |
PgUp-, PgDn-, Home- oder End-Tasten, wie MacBook-Tastaturen, halten Sie Fn mit den Pfeiltasten: Fn+↑ sendet PgUp, Fn+↓ sendet PgDn, Fn+← sendet Home und Fn+→ sendet End. Das macht Ctrl+Fn+→ die Verknüpfung zum Springen nach unten. Wenn sich das unbequem anfühlt, scrollen Sie mit dem Mausrad nach unten, um das Folgen fortzusetzen, oder binden Sie scroll:bottom an etwas Erreichbares neu.
Diese Aktionen sind neu bindbar. Siehe Scroll-Aktionen für die vollständige Liste der Aktionsnamen, einschließlich Varianten für halbe Seiten und ganze Seiten, die keine Standardbindung haben.
Automatisches Folgen
Das Scrollen nach oben pausiert das automatische Folgen, sodass neue Ausgabe Sie nicht zurück nach unten zieht. Drücken SieCtrl+End oder scrollen Sie nach unten, um das Folgen fortzusetzen.
Um das automatische Folgen ganz auszuschalten, sodass die Ansicht dort bleibt, wo Sie sie verlassen, öffnen Sie /config und setzen Sie „Automatisches Scrollen” auf aus. Mit deaktiviertem automatischen Scrollen springt die Ansicht nie von selbst nach unten. Berechtigungsaufforderungen und andere Dialoge, die eine Antwort benötigen, scrollen unabhängig von dieser Einstellung in die Ansicht.
Mausrad-Scrollen
Das Mausrad-Scrollen erfordert, dass Ihr Terminal Mausereignisse an Claude Code weiterleitet. Die meisten Terminals tun dies, wenn eine Anwendung dies anfordert. iTerm2 macht es zu einer Pro-Profil-Einstellung: Wenn das Rad nichts tut, aberPgUp und PgDn funktionieren, öffnen Sie Einstellungen → Profile → Terminal und aktivieren Sie „Mausberichte aktivieren”. Die gleiche Einstellung ist auch erforderlich, damit Klick-zum-Erweitern und Textauswahl funktionieren.
Wenn sich das Scrollen mit dem Mausrad langsam anfühlt, sendet Ihr Terminal möglicherweise ein Scroll-Ereignis pro physischer Kerbe ohne Multiplikator. Einige Terminals, wie Ghostty und iTerm2 mit aktiviertem schnellerem Scrollen, verstärken bereits Rad-Ereignisse. Andere, einschließlich des VS Code integrierten Terminals, senden genau ein Ereignis pro Kerbe. Claude Code kann nicht erkennen, welches.
Setzen Sie CLAUDE_CODE_SCROLL_SPEED, um die Basis-Scroll-Distanz zu multiplizieren:
3 entspricht dem Standard in vim und ähnlichen Anwendungen. Die Einstellung akzeptiert Werte von 1 bis 20.
Um die Scroll-Geschwindigkeit interaktiv anzupassen, führen Sie /scroll-speed aus. Der Dialog zeigt ein Lineal an, das Sie scrollen können, während er offen ist, sodass Sie die Änderung sofort spüren können. Drücken Sie ← und → zum Anpassen, r zum Zurücksetzen auf den automatisch erkannten Standard und Enter zum Speichern. Der Befehl schreibt denselben Wert, den die Umgebungsvariable CLAUDE_CODE_SCROLL_SPEED setzt, persistent in ~/.claude/settings.json. Der Befehl ist im JetBrains IDE-Terminal nicht verfügbar.
Scrollen im JetBrains IDE-Terminal
Im JetBrains IDE-Terminal wendet Claude Code seine eigene Scroll-Verarbeitung an und ignoriertCLAUDE_CODE_SCROLL_SPEED. Das Terminal sendet Scroll-Ereignisse mit einer viel höheren Rate als andere Emulatoren, sodass ein anderswo abgestimmter Multiplikator hier zu weit geht.
In 2025.2 hat das Terminal auch Scroll-Rad-Fehler, die fehlerhafte Pfeiltasten und Ereignisse in der falschen Richtung erzeugen. Claude Code erkennt diese zur Laufzeit und mindert sie automatisch ab, sodass Trackpad- und Mausrad-Scrollen ohne Konfiguration funktionieren. Für das beste Scroll-Erlebnis führen Sie ein Upgrade auf 2025.3 oder später durch. Claude Code zeigt einen Hinweis beim ersten Scrollen an, wenn es den Fehler erkennt.
Gespräch durchsuchen und überprüfen
Ctrl+o schaltet zwischen der normalen Eingabeaufforderung und dem Transkript-Modus um. Für eine ruhigere Ansicht, die nur Ihre letzte Eingabeaufforderung, eine einzeilige Zusammenfassung von Tool-Aufrufen mit Edit-Diffstats und die endgültige Antwort zeigt, führen Sie /focus aus. Die Einstellung bleibt über Sitzungen hinweg erhalten. Führen Sie /focus erneut aus, um es auszuschalten.
Der Transkript-Modus erhält less-ähnliche Navigation und Suche:
| Taste | Aktion |
|---|---|
/ | Öffnen Sie die Suche. Geben Sie ein, um Übereinstimmungen zu finden, drücken Sie Enter, um zu akzeptieren, Esc, um abzubrechen und Ihre Scroll-Position wiederherzustellen |
n / N | Springen Sie zur nächsten oder vorherigen Übereinstimmung. Funktioniert, nachdem Sie die Suchleiste geschlossen haben |
j / k oder ↑ / ↓ | Scrollen Sie eine Zeile |
g / G oder Home / End | Springen Sie nach oben oder unten |
Ctrl+u / Ctrl+d | Scrollen Sie eine halbe Seite |
Ctrl+b / Ctrl+f oder Space / b | Scrollen Sie eine ganze Seite |
Ctrl+o, Esc oder q | Beenden Sie den Transkript-Modus und kehren Sie zur Eingabeaufforderung zurück |
Cmd+f Ihres Terminals und die tmux-Suche sehen das Gespräch nicht, da es im alternativen Bildschirmpuffer lebt, nicht im nativen Scrollback. Um den Inhalt an Ihr Terminal zurückzugeben, drücken Sie Ctrl+o, um zuerst den Transkript-Modus zu aktivieren, dann:
[: schreibt das vollständige Gespräch in den nativen Scrollback-Puffer Ihres Terminals, mit allen erweiterten Tool-Ausgaben. Das Gespräch ist jetzt gewöhnlicher Text in Ihrem Terminal, sodassCmd+f, tmux-Kopiermodus und alle anderen nativen Tools es durchsuchen oder auswählen können. Lange Sitzungen können einen Moment pausieren, während dies geschieht. Dies dauert, bis Sie den Transkript-Modus mitEscoderqbeenden, was Sie zum Vollbildrendering zurückbringt. Das nächsteCtrl+ostartet von vorne.v: schreibt das Gespräch in eine temporäre Datei und öffnet es in$VISUALoder$EDITOR.
Esc oder q, um zur Eingabeaufforderung zurückzukehren.
Gespräch löschen
Drücken SieCtrl+L zweimal innerhalb von zwei Sekunden, um /clear auszuführen und ein neues Gespräch zu starten. Der erste Druck zeichnet den Bildschirm neu und zeigt einen Hinweis; der zweite Druck löscht das Gespräch. Auf macOS löscht auch das doppelte Drücken von Cmd+K das Gespräch mit /clear.
Mit tmux verwenden
Vollbildrendering funktioniert in tmux mit drei Einschränkungen. Das Scrollen mit dem Mausrad erfordert tmux-Mausmodus. Wenn Ihre~/.tmux.conf ihn nicht bereits aktiviert, fügen Sie diese Zeile hinzu und laden Sie Ihre Konfiguration neu:
PgUp und PgDn funktioniert in beiden Fällen. Claude Code druckt einen einmaligen Hinweis beim Start, wenn es tmux mit ausgeschaltetem Mausmodus erkennt.
Vollbildrendering ist nicht kompatibel mit iTerm2s tmux-Integrationsmodus, das ist der Modus, den Sie mit tmux -CC aktivieren. Im Integrationsmodus rendert iTerm2 jeden tmux-Bereich als natives Split, anstatt tmux auf dem Terminal zeichnen zu lassen. Der alternative Bildschirmpuffer und die Mausverfolgung funktionieren dort nicht korrekt: das Mausrad tut nichts, und Doppelklick kann den Terminal-Status beschädigen. Aktivieren Sie Vollbildrendering nicht in tmux -CC Sitzungen. Reguläres tmux in iTerm2 ohne -CC funktioniert einwandfrei.
tmux unterstützt keine synchronisierte Ausgabe, daher können Sie während Neuzeichnungen mehr Flimmern sehen als beim direkten Ausführen von Claude Code in Ihrem Terminal. Wenn das Flimmern besonders über SSH auffällig ist, führen Sie Claude Code in seiner eigenen Terminal-Registerkarte außerhalb von tmux aus.
Native Textauswahl beibehalten
Die Mauserfassung ist der häufigste Reibungspunkt, besonders über SSH oder in tmux. Wenn Claude Code Mausereignisse erfasst, funktioniert die native Kopieren-beim-Auswählen Ihres Terminals nicht mehr. Die Auswahl, die Sie mit Klicken und Ziehen treffen, existiert in Claude Code, nicht in Ihrem Terminal-Auswahlpuffer, sodass tmux-Kopiermodus, Kitty-Hinweise und ähnliche Tools sie nicht sehen. Claude Code versucht, die Auswahl in Ihre Zwischenablage zu schreiben, aber der Pfad, den es verwendet, hängt von Ihrem Setup ab. In tmux schreibt es in den tmux-Paste-Puffer. Über SSH fällt es auf OSC 52 Escape-Sequenzen zurück, die einige Terminals standardmäßig blockieren. iTerm2 blockiert sie, bis Sie Einstellungen → Allgemein → Auswahl → Anwendungen im Terminal dürfen auf Zwischenablage zugreifen aktivieren. Führen Sie/terminal-setup in iTerm2 aus, um dies für Sie zu aktivieren. Claude Code druckt nach jeder Kopie einen Toast, der Ihnen mitteilt, welchen Pfad es verwendet hat.
Für eine einmalige native Auswahl halten Sie den Bypass-Modifikator Ihres Terminals gedrückt, während Sie klicken und ziehen: Option in iTerm2 oder Shift in den meisten Linux- und Windows-Terminals. Der Modifikator teilt Ihrem Terminal mit, die Auswahl selbst zu verarbeiten, anstatt Mausereignisse an Claude Code weiterzuleiten, sodass Cmd+C und die anderen Kopierverknüpfungen Ihres Terminals darauf funktionieren.
Wenn Sie sich die ganze Zeit auf native Auswahl verlassen, setzen Sie CLAUDE_CODE_DISABLE_MOUSE=1, um die Mauserfassung zu deaktivieren, während Sie das flimmerfreie Rendering und flachen Speicher beibehalten:
PgUp, PgDn, Ctrl+Home und Ctrl+End immer noch, und Ihr Terminal verarbeitet die Auswahl nativ. Sie verlieren Klick-zum-Positionieren-des-Cursors, Klick-zum-Erweitern-der-Tool-Ausgabe, URL-Klicken und Rad-Scrollen in Claude Code.
Forschungsvorschau
Vollbildrendering ist eine Forschungsvorschau-Funktion. Es wurde auf gängigen Terminal-Emulatoren getestet, aber Sie können auf weniger gängigen Terminals oder ungewöhnlichen Konfigurationen auf Rendering-Probleme stoßen. Wenn Sie auf ein Problem stoßen, führen Sie/feedback in Claude Code aus, um es zu melden, oder öffnen Sie ein Problem im claude-code GitHub-Repository. Geben Sie Ihren Terminal-Emulator-Namen und die Version an.
Um Vollbildrendering auszuschalten, führen Sie /tui default aus, oder heben Sie CLAUDE_CODE_NO_FLICKER auf, wenn Sie es auf diese Weise aktiviert haben. Um den klassischen Renderer unabhängig von der gespeicherten tui-Einstellung zu erzwingen, setzen Sie CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1. Der klassische Renderer behält die Konversation im nativen Scrollback Ihres Terminals bei, sodass Cmd+f und der tmux-Kopiermodus wie gewohnt funktionieren.