Vollbildrendering ist eine optionale Forschungsvorschau und erfordert Claude Code v2.1.88 oder später. Aktivieren Sie es mit CLAUDE_CODE_NO_FLICKER=1. Das Verhalten kann sich basierend auf Feedback ändern.
Vollbildrendering ist ein alternativer Rendering-Pfad für die Claude Code CLI, der Flimmern eliminiert, die Speichernutzung in langen Gesprächen konstant hält und Mausunterstützung hinzufügt. Es zeichnet die Benutzeroberfläche auf dem alternativen Bildschirmpuffer des Terminals, wie 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
Setzen Sie die Umgebungsvariable CLAUDE_CODE_NO_FLICKER beim Starten von Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
Um es für jede Sitzung zu aktivieren, exportieren Sie die Variable in Ihrem Shell-Profil wie ~/.zshrc oder ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
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 dann / zum Suchen, oder Ctrl+o dann [ zum Schreiben des Gesprächs in natives Scrollback, damit Cmd+f wieder funktioniert | 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 |
Wenn die Mauserfassung Ihren Arbeitsablauf beeinträchtigt, können Sie sie deaktivieren, während Sie das flimmerfreie Rendering beibehalten.
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:// und https:// URLs öffnen sich in Ihrem Browser. In den meisten Terminals ersetzt dies natives Cmd-Klicken oder Ctrl-Klicken, das die Mauserfassung abfängt. Im VS Code integrierten Terminal und ähnlichen xterm.js-basierten Terminals verwenden Sie weiterhin Cmd-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.
Ausgewählter Text wird beim Loslassen der Maus automatisch in Ihre Zwischenablage kopiert. Um dies auszuschalten, schalten Sie „Beim Auswählen kopieren” in /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.
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 |
Auf Tastaturen ohne dedizierte 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.
Das Scrollen nach oben pausiert das automatische Folgen, sodass neue Ausgabe Sie nicht zurück nach unten zieht. Drücken Sie Ctrl+End oder scrollen Sie nach unten, um das Folgen fortzusetzen.
Diese Aktionen können neu gebunden werden. Siehe Tastenkombinationen, um sie anzupassen. Die Aktionsnamen sind scroll:pageUp, scroll:pageDown, scroll:top und scroll:bottom. Zusätzliche Aktionen ohne Standardbindung sind scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp und scroll:fullPageDown.
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:
export CLAUDE_CODE_SCROLL_SPEED=3
Ein Wert von 3 entspricht dem Standard in vim und ähnlichen Anwendungen. Die Einstellung akzeptiert Werte von 1 bis 20.
Gespräch durchsuchen und überprüfen
Drücken Sie Ctrl+o, um den Transkript-Modus zu aktivieren. Mit aktiviertem Vollbildrendering erhält der Transkript-Modus 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 |
Esc, q oder Ctrl+o | Beenden Sie den Transkript-Modus |
Das 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, sodass Cmd+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 mit Esc oder q beenden, was Sie zum Vollbildrendering zurückbringt. Das nächste Ctrl+o startet von vorne.
v: schreibt das Gespräch in eine temporäre Datei und öffnet es in $VISUAL oder $EDITOR.
Drücken Sie Esc, q oder Ctrl+o, um zur Eingabeaufforderung zurückzukehren.
Mit tmux verwenden
Vollbildrendering funktioniert in tmux mit zwei 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:
Ohne Mausmodus gehen Rad-Ereignisse an tmux statt an Claude Code. Tastatur-Scrollen mit 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.
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. Claude Code druckt nach jeder Kopie einen Toast, der Ihnen mitteilt, welchen Pfad es verwendet hat.
Wenn Sie sich auf die native Auswahl Ihres Terminals verlassen, setzen Sie CLAUDE_CODE_DISABLE_MOUSE=1, um die Mauserfassung zu deaktivieren, während Sie das flimmerfreie Rendering und flachen Speicher beibehalten:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
Mit deaktivierter Mauserfassung funktioniert Tastatur-Scrollen mit 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, heben Sie die Umgebungsvariable auf oder setzen Sie CLAUDE_CODE_NO_FLICKER=0.