Konfigurieren Sie Ihr Terminal für Claude Code

Claude Code funktioniert in jedem Terminal ohne Konfiguration. Diese Seite ist für den Fall, dass sich etwas nicht so verhält, wie Sie es erwarten. Finden Sie Ihr Symptom unten. Wenn alles bereits richtig funktioniert, benötigen Sie diese Seite nicht.

Shift+Enter sendet ab, anstatt einen Zeilenumbruch einzufügen
Option-Taste-Verknüpfungen funktionieren nicht auf macOS
Kein Ton oder Benachrichtigung, wenn Claude fertig ist
Sie führen Claude Code in tmux aus
Rücktaste löscht ein ganzes Wort unter Windows
Anzeige flackert oder Scrollback springt
Sie möchten Vim-Tasten in der Eingabeaufforderung

Diese Seite behandelt das Konfigurieren Ihres Terminals, um die richtigen Signale an Claude Code zu senden. Um zu ändern, auf welche Tasten Claude Code selbst reagiert, siehe stattdessen Tastenbelegungen.

Mehrzeilige Prompts eingeben

Durch Drücken von Enter wird Ihre Nachricht gesendet. Um einen Zeilenumbruch einzufügen, ohne zu senden, drücken Sie Ctrl+J, oder geben Sie \ ein und drücken Sie dann Enter. Beides funktioniert in jedem Terminal ohne Einrichtung. In den meisten Terminals können Sie auch Shift+Enter drücken, die Unterstützung variiert jedoch je nach Terminal-Emulator:

Terminal	Shift+Enter für Zeilenumbruch
Ghostty, Kitty, iTerm2, WezTerm, Warp, Windows Terminal	Funktioniert ohne Einrichtung
Andere Terminals, die das Kitty-Tastaturprotokoll unterstützen, wie foot und Alacritty 0.16 oder neuer	Funktioniert ohne Einrichtung. Erfordert Claude Code v2.1.269 oder neuer
VS Code, Cursor, Devin Desktop, Alacritty vor 0.16, Zed	Führen Sie einmalig `/terminal-setup` aus
gnome-terminal, JetBrains-IDEs wie PyCharm und Android Studio	Nicht verfügbar; verwenden Sie Ctrl+J oder `\` und dann Enter

Für VS Code, Cursor, Devin Desktop, Alacritty vor 0.16 und Zed schreibt /terminal-setup eine Shift+Enter-Tastenkombination in die Konfigurationsdatei des Terminals. Beim ersten Ausführen sehen Sie eine Bestätigung wie Installed VSCode terminal Shift+Enter key binding. Vorhandene Tastenkombinationen bleiben erhalten; wenn Sie eine Meldung wie VSCode terminal Shift+Enter key binding already configured sehen, wurde nichts geändert. Führen Sie /terminal-setup direkt im Host-Terminal aus und nicht innerhalb von tmux oder screen, da es in die Konfiguration des Host-Terminals schreiben muss. In VS Code, Cursor und Devin Desktop aktualisiert /terminal-setup außerdem zwei Editor-Einstellungen: Es setzt terminal.integrated.gpuAcceleration auf "off", um verstümmelten Text im integrierten Terminal zu verhindern, und es setzt terminal.integrated.mouseWheelScrollSensitivity für flüssigeres Scrollen im Vollbildmodus. Um die Änderung der GPU-Beschleunigung rückgängig zu machen, setzen Sie sie wieder auf "auto" und laden Sie das Editorfenster neu. In Zed aktualisiert /terminal-setup Ihre keymap.json direkt:

Wenn die Keymap bereits Tastenkombinationen enthält und keine davon ein Terminal-shift-enter ist, sichert Claude Code sie zunächst in eine Kopie im selben Verzeichnis, etwa keymap.json.1a2b3c4d.bak, und führt dann die Shift+Enter-Tastenkombination mit Ihrer Keymap zusammen, wobei Ihre anderen Tastenkombinationen und Kommentare erhalten bleiben
Wenn Claude Code die Keymap nicht lesen oder parsen, nicht sichern oder das zusammengeführte Ergebnis nicht überprüfen kann, lässt es die Datei unverändert und gibt den Block mit der Tastenkombination aus, den Sie selbst hinzufügen können

Wenn Sie Claude Code innerhalb von tmux ausführen, erfordert Shift+Enter zusätzlich die unten beschriebene tmux-Konfiguration, selbst wenn das äußere Terminal es unterstützt. Um den Zeilenumbruch auf eine andere Taste zu legen oder das Verhalten umzukehren, sodass Enter einen Zeilenumbruch einfügt und Shift+Enter sendet, ordnen Sie die Aktionen chat:newline und chat:submit in Ihrer Datei für Tastenkombinationen zu.

Option-Tastenkombinationen unter macOS aktivieren

Einige Tastenkombinationen in Claude Code verwenden die Option-Taste, etwa Option+Enter für einen Zeilenumbruch oder Option+P zum Wechseln des Modells. Unter macOS senden die meisten Terminals Option standardmäßig nicht als Modifikatortaste, daher bewirken diese Tastenkombinationen nichts, bis Sie dies aktivieren. Die entsprechende Terminal-Einstellung heißt in der Regel „Use Option as Meta Key“; Meta ist die historische Unix-Bezeichnung für die Taste, die heute mit Option oder Alt beschriftet ist.

Apple Terminal
iTerm2
VS Code

Öffnen Sie Settings → Profiles → Keyboard und aktivieren Sie „Use Option as Meta Key“.Wenn Sie beim ersten Start von Claude Code die Abfrage zur Terminal-Einrichtung bestätigt haben, ist dies bereits erledigt. Diese Abfrage führt /terminal-setup für Sie aus, wodurch Option als Meta aktiviert und der akustische Signalton in Ihrem Apple-Terminal-Profil ausgeschaltet wird.Im Screenreader-Modus lässt /terminal-setup die Signalton-Einstellung unverändert, sodass der Terminal-Signalton hörbar bleibt. Falls ein früherer Durchlauf den Signalton ausgeschaltet hat, schalten Sie ihn unter Settings → Profiles → Advanced → „Audible bell“ wieder ein.

Öffnen Sie Settings → Profiles → Keys → General und setzen Sie Left Option key und Right Option key auf „Esc+“.Wenn Sie /terminal-setup in iTerm2 ausführen, wird „Applications in terminal may access clipboard“ unter Settings → General → Selection aktiviert, damit der Befehl /copy in Ihre System-Zwischenablage schreiben kann. Der Befehl erkennt iTerm2 auch dann, wenn er innerhalb von tmux ausgeführt wird. Starten Sie iTerm2 neu, damit die Änderung wirksam wird.

Fügen Sie "terminal.integrated.macOptionIsMeta": true zu Ihren VS Code-Einstellungen hinzu.

Suchen Sie bei Ghostty, Kitty und anderen Terminals in der Konfigurationsdatei des Terminals nach einer Einstellung wie Option-as-Alt oder Option-as-Meta.

Terminalglockenton oder Benachrichtigung erhalten

Wenn Claude eine Aufgabe abschließt oder bei einer Berechtigungsaufforderung pausiert und Sie vom Terminal entfernt zu sein scheinen, wird ein Benachrichtigungsereignis ausgelöst. Siehe wann jeder Benachrichtigungstyp ausgelöst wird für den genauen Zeitpunkt. Wenn Sie dies als Terminalglockenton oder Desktop-Benachrichtigung anzeigen, können Sie zu anderen Aufgaben wechseln, während eine lange Aufgabe läuft. Standardmäßig sendet Claude Code in einigen Terminals eine Desktop-Benachrichtigung und in anderen ein Glockenzeichen oder gar nichts:

Ghostty, Kitty und iTerm2, sofern Claude Code sie erkennt: eine Desktop-Benachrichtigung, die iTerm2 erst anzeigt, nachdem Sie die Alert-Einstellungen aktiviert haben.
Apple Terminal: kein Ton; ein stilles Glockenzeichen, wenn Claude Code feststellt, dass „Audible bell“ im Profil des vordersten Terminal-Fensters ausgeschaltet ist, andernfalls nichts. Dieses Glockenzeichen wird als Aufblitzen des Fensters angezeigt oder, während Terminal im Hintergrund läuft, als Hüpfen des Dock-Symbols, sofern die Option „Visual bell“ oder die Dock-Hüpfen-Option dieses Profils aktiviert ist.
Andere Terminals: nichts.

Damit Claude Code das Glockenzeichen unabhängig von Terminal oder Profil sendet, setzen Sie preferredNotifChannel auf "terminal_bell". Aktivieren Sie in Apple Terminal außerdem Audible bell unter Einstellungen > Profile > Erweitert, um ihn zu hören. Der folgende Eintrag in den Einstellungen legt den Kanal fest:

~/.claude/settings.json

{
  "preferredNotifChannel": "terminal_bell"
}

Wenn Sie über SSH von einem Terminal aus arbeiten, das außerhalb von tmux läuft, setzen Sie preferredNotifChannel auf dem Computer, auf dem Claude Code ausgeführt wird, auf den Wert Ihres lokalen Terminals: "iterm2", "kitty" oder "ghostty". Die Desktop-Benachrichtigung erreicht dann Ihren lokalen Computer. Ghostty und Kitty leiten sie ohne weitere Einrichtung an Ihr Betriebssystem-Benachrichtigungscenter weiter. iTerm2 erfordert, dass Sie die Weiterleitung aktivieren:

Öffnen Sie die iTerm2-Benachrichtigungseinstellungen

Gehen Sie zu Einstellungen → Profile → Terminal.

Aktivieren Sie Benachrichtigungen

Aktivieren Sie „Notification Center Alerts“, klicken Sie dann auf „Filter Alerts“ und aktivieren Sie „Send escape sequence-generated alerts“.

Wenn Benachrichtigungen immer noch nicht angezeigt werden, bestätigen Sie, dass Ihre Terminalanwendung in Ihren Betriebssystem-Einstellungen Benachrichtigungsberechtigung hat, und wenn Sie in tmux ausgeführt werden, aktivieren Sie Passthrough.

Sound mit einem Notification-Hook abspielen

In jedem Terminal können Sie einen Notification-Hook konfigurieren, um einen Sound abzuspielen oder einen benutzerdefinierten Befehl auszuführen, wenn Claude Ihre Aufmerksamkeit benötigt. Hooks werden neben der integrierten Benachrichtigung ausgeführt, anstatt sie zu ersetzen, sodass Terminals, die keine Desktop-Benachrichtigung erhalten, wie Warp oder das in VS Code integrierte Terminal, einen Hook verwenden oder preferredNotifChannel stattdessen auf "terminal_bell" setzen können. Das folgende Beispiel spielt einen Systemsound auf macOS ab. Der verlinkte Leitfaden enthält Desktop-Benachrichtigungsbefehle für macOS, Linux und Windows.

~/.claude/settings.json

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

Sitzungsstatus in Ihrem Terminal anzeigen

Wenn Ihr Terminal das OSC 7501 Program Status Protocol implementiert, kann es anzeigen, ob jede interaktive Claude Code-Sitzung gerade arbeitet, auf Sie wartet oder fertig ist. Das ist hilfreich, wenn Sie lange Aufgaben oder mehrere Sitzungen gleichzeitig ausführen. In Claude Code müssen Sie nichts aktivieren. Ob Ihr Terminal das Protokoll implementiert und wo es den Status anzeigt, erfahren Sie in dessen Dokumentation. Wenn es das Protokoll implementiert und Sie für eine Sitzung keinen Status sehen, prüfen Sie jede dieser Ursachen:

Claude Code-Version: Die Statusmeldung erfordert Claude Code v2.1.295 oder höher. Führen Sie claude --version in Ihrer Shell aus, um dies zu prüfen.
tmux: Innerhalb von tmux prüft Claude Code die Unterstützung bei tmux statt bei Ihrem Terminal, und allow-passthrough hat darauf keine Auswirkung. Starten Sie die Sitzung außerhalb von tmux.
Hintergrundsitzung: Eine Hintergrundsitzung meldet ihren Status nicht an Ihr Terminal, selbst wenn Sie mit ihr verbunden sind. Stattdessen zeigt die Agent-Ansicht ihren Status an.
CLAUDE_CODE_DISABLE_TERMINAL_TITLE: Wenn Sie diese Variable auf 1 setzen, prüft Claude Code weder die Unterstützung noch meldet es den Status. Entfernen Sie die Variable.

In einem Terminal, das Unterstützung für das Protokoll meldet, beginnt der Tab-Titel nicht mit einem Statussymbol. Das Terminal zeigt den Zustand der Sitzung selbst an, daher lässt Claude Code das Symbol weg, das es in anderen Terminals vor den Titel setzt.

tmux konfigurieren

Wenn Claude Code innerhalb von tmux ausgeführt wird, sendet Shift+Enter standardmäßig ab, anstatt einen Zeilenumbruch einzufügen, und Desktop-Benachrichtigungen erreichen das äußere Terminal nicht. Fügen Sie diese Zeilen zu ~/.tmux.conf hinzu und führen Sie dann tmux source-file ~/.tmux.conf aus, um sie auf den laufenden Server anzuwenden:

~/.tmux.conf

set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

Um Benachrichtigungen aus einem sichtbaren Bereich an das äußere Terminal zu senden, behalten Sie die allow-passthrough-Zeile bei und setzen Sie preferredNotifChannel auf "iterm2", "kitty" oder "ghostty". Mit diesem Beispiel sendet ein Bereich in einem Fenster, das Sie gerade nicht ansehen, keine Benachrichtigungen. Die extended-keys-Zeilen ermöglichen es tmux, Shift+Enter von einfachem Enter zu unterscheiden, damit die Zeilenumbruch-Verknüpfung funktioniert. Ein Image eines Mods benötigt die Zeilen allow-passthrough und focus-events sowie die weiteren Voraussetzungen für das Zeichnen innerhalb von tmux. Nachdem Sie die Zeilen hinzugefügt haben, trennen Sie außerdem die Verbindung zu tmux, verbinden Sie sich erneut und starten Sie Claude Code neu.

Backspace löscht unter Windows ein ganzes Wort

Unter Windows interpretiert Claude Code ein Backspace, das als ^H ankommt, als Ctrl+Backspace, was das vorherige Wort löscht, außer wenn TERM_PROGRAM auf mintty oder TERM auf cygwin gesetzt ist. Unter macOS und Linux interpretiert Claude Code es als einfaches Backspace. Wenn jeder Druck auf Backspace ein ganzes Wort löscht, sendet Ihr Terminal ^H für einfaches Backspace. Setzen Sie CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. Backspace und Ctrl+H löschen dann jeweils ein Zeichen. Wenn Ctrl+Backspace unter macOS oder Linux nur ein Zeichen löscht, weil Ihr Terminal dafür ^H sendet, setzen Sie die Variable stattdessen auf 1.

Das Farbschema anpassen

Verwenden Sie den Befehl /theme oder die Theme-Auswahl in /config, um ein Claude Code-Theme zu wählen, das zu Ihrem Terminal passt. Wenn Sie die Option „auto“ auswählen, wird der helle oder dunkle Hintergrund Ihres Terminals erkannt, sodass das Theme Änderungen am Erscheinungsbild des Betriebssystems folgt, sobald Ihr Terminal dies tut. Claude Code steuert nicht das eigene Farbschema des Terminals, das von der Terminal-Anwendung festgelegt wird. Um anzupassen, was am unteren Rand der Oberfläche angezeigt wird, konfigurieren Sie eine benutzerdefinierte Statuszeile, die das aktuelle Modell, das Arbeitsverzeichnis, den Git-Branch oder anderen Kontext anzeigt.

Ein benutzerdefiniertes Theme erstellen

Zusätzlich zu den integrierten Voreinstellungen listet /theme alle von Ihnen definierten benutzerdefinierten Themes sowie alle Themes auf, die von installierten Plugins bereitgestellt werden. Wählen Sie New custom theme… am Ende der Liste, um interaktiv ein Theme zu erstellen: Sie benennen das Theme und wählen dann einzelne Farb-Token aus, die Sie überschreiben möchten. Drücken Sie Ctrl+E, während ein benutzerdefiniertes Theme hervorgehoben ist, um es zu bearbeiten. Jedes benutzerdefinierte Theme ist eine JSON-Datei in ~/.claude/themes/. Der Dateiname ohne die Endung .json ist der Slug des Themes, und bei Auswahl des Themes wird custom:<slug> als Ihre Theme-Einstellung gespeichert. Die Datei hat drei optionale Felder:

Feld	Typ	Beschreibung
`name`	string	Anzeigename, der in `/theme` angezeigt wird. Standardmäßig der Slug des Dateinamens
`base`	string	Integrierte Voreinstellung, von der das Theme ausgeht: `dark`, `light`, `dark-daltonized`, `light-daltonized`, `dark-ansi` oder `light-ansi`. Standardmäßig `dark`
`overrides`	object	Zuordnung von Farb-Token-Namen zu Farbwerten. Hier nicht aufgeführte Token fallen auf die Basis-Voreinstellung zurück

Farbwerte akzeptieren #rrggbb, #rgb, rgb(r,g,b), ansi256(n) oder ansi:<name>, wobei <name> einer der 16 Standard-ANSI-Farbnamen wie red oder cyanBright ist. Unbekannte Token und ungültige Farbwerte werden ignoriert, sodass ein Tippfehler die Darstellung nicht beeinträchtigen kann. Das folgende Beispiel definiert ein Theme, das die dunkle Voreinstellung beibehält, aber die Akzentfarbe des Prompts, den Fehlertext und den Erfolgstext umfärbt:

~/.claude/themes/dracula.json

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code überwacht ~/.claude/themes/ und lädt neu, wenn eine Datei hinzugefügt oder geändert wird, sodass Bearbeitungen in Ihrem Editor ohne Neustart in einer laufenden Sitzung wirksam werden. Wenn der Ordner ~/.claude/themes/ selbst beim Start von Claude Code noch nicht existierte, starten Sie nach dem Erstellen Ihrer ersten Theme-Datei einmal neu. Danach werden Änderungen ohne Neustart wirksam. Die folgende Referenz behandelt die Token, die Sie in overrides festlegen können. Der interaktive Editor in /theme zeigt dieselben Token mit einer Live-Vorschau sowie einige Akzente für einzelne Zwecke, etwa Farben des Onboarding-Bildschirms, die hier ausgelassen sind.

Referenz der Farb-Token

Das folgende Beispiel kombiniert Token aus mehreren der untenstehenden Gruppen: den Marken-Akzent, den Rahmen des Plan-Modus, die Diff-Hintergründe und den Nachrichtenhintergrund.

~/.claude/themes/midnight.json

{
  "name": "Midnight",
  "base": "dark",
  "overrides": {
    "claude": "#a78bfa",
    "planMode": "#38bdf8",
    "diffAdded": "#14532d",
    "diffRemoved": "#7f1d1d",
    "userMessageBackground": "#1e1b4b"
  }
}

Text- und Akzentfarben

Steuern Sie den primären Marken-Akzent und die Vordergrund-Textfarbtöne, die in der gesamten Oberfläche verwendet werden.

Token	Steuert
`claude`	Primärer Marken-Akzent, verwendet für den Spinner und die Assistenten-Beschriftung
`text`	Standard-Vordergrundtext
`inverseText`	Text, der auf einem farbigen Hintergrund dargestellt wird, etwa bei Status-Badges
`inactive`	Sekundärer Text wie Hinweise, Zeitstempel und deaktivierte Elemente
`subtle`	Blasse Rahmen und zurückgenommener sekundärer Text
`suggestion`	Autovervollständigungsvorschläge und Auswahlhervorhebung in Auswahllisten
`permission`	Dialograhmen, einschließlich Berechtigungsabfragen und Auswahllisten
`remember`	Memory- und `CLAUDE.md`-Indikatoren

Statusfarben

Signalisieren Erfolgs-, Fehler- und Warnzustände in Nachrichten und Indikatoren.

Token	Steuert
`success`	Erfolgsmeldungen und bestandene Prüfungen
`error`	Fehlermeldungen und Fehlschläge
`warning`	Warnungen, Hinweismeldungen und der Indikator für den Auto-Modus
`merged`	Status zusammengeführter Pull Requests

Eingabefeld und Modus-Indikatoren

Legen Sie die Rahmenfarbe des Eingabefelds und den Akzent fest, der angezeigt wird, während ein Berechtigungsmodus oder Indikator aktiv ist.

Token	Steuert
`promptBorder`	Rahmen des Eingabefelds
`planMode`	Akzent des Plan-Modus, Plan-Nachrichten und Dialoge im Plan-Modus
`autoAccept`	Akzent des Accept-Edits-Modus
`bashBorder`	Rahmen des Eingabefelds bei der Eingabe eines `!`-Shell-Befehls
`ide`	Indikator für die IDE-Verbindung
`fastMode`	Indikator für den Fast-Modus
`effortUltra`	Das `ultracode`-Tag am Rahmen des Eingabefelds, während ultracode aktiviert ist. Wenn Sie diese Farbe überschreiben, wird dies ab Claude Code v2.1.239 wirksam

Diff-Darstellung

Färben Sie hinzugefügten und entfernten Code in Dateibearbeitungen und Reviews.

Token	Steuert
`diffAdded`	Hintergrund hinzugefügter Zeilen
`diffRemoved`	Hintergrund entfernter Zeilen
`diffAddedDimmed`	Hintergrund hinzugefügter Zeilen im abgedunkelten Diff, der angezeigt wird, nachdem Sie eine Bearbeitung abgelehnt haben
`diffRemovedDimmed`	Hintergrund entfernter Zeilen im abgedunkelten Diff, der angezeigt wird, nachdem Sie eine Bearbeitung abgelehnt haben
`diffAddedWord`	Hervorhebung auf Wortebene innerhalb einer hinzugefügten Zeile
`diffRemovedWord`	Hervorhebung auf Wortebene innerhalb einer entfernten Zeile

Vollbildmodus

Claude Code verwendet userMessageBackgroundHover, selectionBg und composerSidebarBackground nur im Vollbild-Darstellungsmodus. userMessageBackground, bashMessageBackgroundColor und memoryBackgroundColor werden sowohl im Standard- als auch im Vollbild-Renderer dargestellt.

Token	Steuert
`userMessageBackground`	Hintergrund hinter Ihren Nachrichten im Transkript
`userMessageBackgroundHover`	Hintergrund hinter einer Nachricht, während sie mit der Maus überfahren oder erweitert wird
`bashMessageBackgroundColor`	Hintergrund hinter `!`-Shell-Befehlseinträgen im Transkript
`memoryBackgroundColor`	Hintergrund hinter `#`-Memory-Einträgen im Transkript
`selectionBg`	Hintergrund von mit der Maus ausgewähltem Text
`composerSidebarBackground`	Hintergrund des Bereichs neben der Konversation, etwa des Diff-Bereichs oder des Bereichs eines Mods

Nutzungsanzeige und Sprecher-Beschriftungen

Passen Sie den Balken in der /usage-Ansicht und die Beschriftungen an, die Ihre Nachrichten von denen von Claude unterscheiden.

Token	Steuert
`rate_limit_fill`	Gefüllter Teil der Nutzungsanzeige
`rate_limit_empty`	Ungefüllter Teil der Nutzungsanzeige
`briefLabelYou`	Farbe der Beschriftung `You` bei Ihren Nachrichten
`briefLabelClaude`	Farbe der Beschriftung `Claude` bei Nachrichten des Assistenten

Shimmer-Varianten und Subagenten-Farben

Mehrere Token haben eine zugehörige Shimmer-Variante, die die hellere Farbe für den animierten Farbverlauf des Spinners liefert. Überschreiben Sie die Shimmer-Variante zusammen mit dem zugehörigen Basis-Token, wenn die Animation unstimmig wirkt.

claude und claudeShimmer
warning und warningShimmer
permission und permissionShimmer
promptBorder und promptBorderShimmer
inactive und inactiveShimmer
fastMode und fastModeShimmer

Jeder Subagent und jede parallele Aufgabe wird in einer von acht benannten Farben angezeigt, damit Sie sie im Transkript unterscheiden können. Die Token-Namen folgen dem Muster <color>_FOR_SUBAGENTS_ONLY, wobei <color> red, blue, green, yellow, purple, orange, pink oder cyan ist. Überschreiben Sie diese, um zu ändern, wie jede benannte Farbe aussieht. Beispielsweise wird ein Subagent mit color: blue in seiner Definition mit dem Wert von blue_FOR_SUBAGENTS_ONLY dargestellt.Wenn ultrathink den Aufwand eines Turns erhöhen kann, stellt Claude Code das Wort im Prompt-Eingabefeld mit einem siebenfarbigen Regenbogen-Farbverlauf dar. Die Token-Namen folgen dem Muster rainbow_<color> und rainbow_<color>_shimmer, wobei <color> red, orange, yellow, green, blue, indigo oder violet ist.

Zu Vollbildrendering wechseln

Im Bildschirmlesemodus gilt dieser Abschnitt nicht. Claude Code wird immer als einfacher scrollender Text dargestellt, außer in angehängten Hintergrundsitzungen, und wenn Sie /tui fullscreen in einer anderen Sitzung ausführen, gibt Claude Code stattdessen eine Erklärung aus, anstatt zu wechseln. Wenn die Anzeige flackert oder die Scrollposition springt, während Claude arbeitet, wechseln Sie zum Vollbildrenderingmodus. In diesem Modus scrollen Sie mit der Maus oder PageUp in Claude Code, anstatt mit dem nativen Scrollback Ihres Terminals. Weitere Informationen zum Suchen und Kopieren finden Sie auf der Vollbildseite. Wenn Flackern das einzige Problem ist und Ihr Terminal synchronisierte Ausgabe unterstützt, aber nicht automatisch erkannt wird, z. B. Emacs eat, setzen Sie CLAUDE_CODE_FORCE_SYNC_OUTPUT=1, um das Flackern zu stoppen, ohne den Renderer zu wechseln. Führen Sie /tui fullscreen aus, um zu wechseln und die Einstellung zu speichern. Ihre Konversation wird intakt neu gestartet und zukünftige Sitzungen starten im Vollbildmodus, es sei denn, ein Vollbildstart schlägt fehl. Sie können auch die Umgebungsvariable CLAUDE_CODE_NO_FLICKER setzen, bevor Sie Claude Code starten:

CLAUDE_CODE_NO_FLICKER=1 claude

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

Antwortbreite in breiten Terminals begrenzen

In einem breiten Terminal erstreckt sich jede Textzeile in Claudes Antworten über die volle Breite des Fensters. Um den Text stattdessen bei einer festgelegten Anzahl von Spalten umzubrechen, setzen Sie maxProseWidth in Ihren Einstellungen.

Große Inhalte einfügen

Wenn Sie mehr als 800 Zeichen oder mehr als drei Zeilen in den Prompt einfügen, reduziert Claude Code die Eingabe auf einen Platzhalter wie [Pasted text #1 +120 lines], damit das Eingabefeld nutzbar bleibt, und sendet beim Absenden dennoch den vollständigen Inhalt. Bei sehr großen Eingaben wie ganzen Dateien oder langen Logs schreiben Sie den Inhalt in eine Datei und bitten Claude, diese zu lesen, anstatt ihn einzufügen. Das Transkript der Konversation bleibt so lesbar, und Claude kann in späteren Turns über den Pfad auf die Datei verweisen. Das integrierte Terminal von VS Code kann bei sehr großen Einfügungen außerdem Zeichen verlieren, bevor diese Claude Code erreichen, verwenden Sie dort daher eine Datei. Enthält der eingefügte Text unsichtbare Unicode-Zeichen, entfernt Claude Code diese, wenn Sie Enter drücken, und setzt den bereinigten Prompt wieder in das Eingabefeld, damit Sie ihn mit einem weiteren Enter senden können.

Wie Claude eingefügten Text behandelt

Beim Absenden sieht Claude den Inhalt hinter jedem Platzhalter [Pasted text #N] als Text gekennzeichnet, den Sie von anderswo eingefügt und nicht selbst getippt haben. Claude wird mitgeteilt, dass eingefügter Text Anweisungen enthalten kann, die nicht von Ihnen stammen, und dass Claude Anweisungen darin nur befolgen soll, wenn die von Ihnen getippte Nachricht dazu auffordert. In Sitzungen, die keine Feature-Flags abrufen, wird eingefügter Text nicht gekennzeichnet.

Reduzierte Einfügung löschen und wiederherstellen

Wenn Sie mit einem Wort- oder Zeilen-Tastenkürzel wie Ctrl+W oder Ctrl+K oder mit einem vim-Löschbefehl über eine f/t-Bewegung wie df] löschen und der gelöschte Bereich in einen Platzhalter [Pasted text #N] hineinreicht, entfernt Claude Code den Platzhalter vollständig. Um ihn wiederherzustellen, fügen Sie das Gelöschte nach einem Wort- oder Zeilen-Tastenkürzel mit Ctrl+Y oder nach einem vim-Löschbefehl mit p im NORMAL-Modus wieder ein.

Einen Prompt mit eingefügtem Text erneut aufrufen

Claude Code speichert den Inhalt hinter jedem Platzhalter [Pasted text #N] unter ~/.claude/paste-cache/. Wenn Sie also einen Prompt aus dem Befehlsverlauf erneut aufrufen und absenden, wird der vollständige eingefügte Inhalt erneut gesendet, auch in einer späteren Sitzung. Cache-Dateien, die älter als cleanupPeriodDays sind, werden gemäß den Regeln für die automatische Bereinigung gelöscht, sodass ein erneut aufgerufener Prompt auf eingefügten Text verweisen kann, der nicht mehr existiert. Wenn Sie einen solchen Prompt absenden, sendet Claude Code nicht die wörtliche Zeichenfolge [Pasted text #N] und zeigt eine Benachrichtigung an, die die fehlende Einfügung benennt:

Bei einem einfachen Prompt mit verbleibendem Text entfernt Claude Code den Platzhalter und sendet den verbleibenden Text.
Bei einem Befehl im Shell-Modus oder einem /-Befehl, bei dem das Entfernen ändern würde, was ausgeführt wird, sowie bei jedem Prompt, der durch das Entfernen leer wäre, bricht Claude Code das Absenden ab und behält den ursprünglichen Text einschließlich des Platzhalters im Eingabefeld. Löschen Sie den Platzhalter oder bearbeiten Sie den Befehl und senden Sie ihn dann erneut ab.

Prompts mit Vim-Tastenkombinationen bearbeiten

Claude Code enthält einen Bearbeitungsmodus im Vim-Stil für die Prompt-Eingabe. Aktivieren Sie ihn über /config → Editor mode oder indem Sie editorMode in ~/.claude/settings.json auf "vim" setzen. Setzen Sie Editor mode wieder auf normal, um ihn auszuschalten. Der Vim-Modus unterstützt eine Teilmenge der Bewegungen und Operatoren im NORMAL- und VISUAL-Modus, etwa die Navigation mit hjkl, die Auswahl mit v/V sowie d/c/y mit Textobjekten. Die vollständige Tastentabelle finden Sie in der Referenz zum Vim-Editormodus. Vim-Bewegungen lassen sich nicht über die Datei für Tastenkombinationen neu belegen. Um eine Tastenfolge aus zwei Tasten im INSERT-Modus wie jj auf Escape abzubilden, setzen Sie vimInsertModeRemaps in Ihren Benutzereinstellungen. Anders als im Standard-Vim sendet Enter im INSERT-Modus weiterhin Ihren Prompt ab. Verwenden Sie stattdessen o oder O im NORMAL-Modus oder Ctrl+J, um einen Zeilenumbruch einzufügen.

Interaktiver Modus: vollständige Tastaturverknüpfungs-Referenz und die Vim-Schlüsseltabelle
Tastenbelegungen: ordnen Sie jede Claude Code-Verknüpfung neu zu, einschließlich Enter und Shift+Enter
Vollbildrendering: Details zum Scrollen, Suchen und Kopieren im Vollbildmodus
Hooks-Leitfaden: weitere Benachrichtigungshook-Beispiele für Linux und Windows
Fehlerbehebung: Behebungen für Probleme außerhalb der Terminalkonfiguration

Einstellungen

Berechtigungen und Sandboxing

Umgebungen

Modell und Antworten

Benutzeroberfläche

Konfigurieren Sie Ihr Terminal für Claude Code

Mehrzeilige Prompts eingeben

Option-Tastenkombinationen unter macOS aktivieren

Terminalglockenton oder Benachrichtigung erhalten

Sound mit einem Notification-Hook abspielen

Sitzungsstatus in Ihrem Terminal anzeigen

tmux konfigurieren

Backspace löscht unter Windows ein ganzes Wort

Das Farbschema anpassen

Ein benutzerdefiniertes Theme erstellen

Text- und Akzentfarben

Statusfarben

Eingabefeld und Modus-Indikatoren

Diff-Darstellung

Vollbildmodus

Nutzungsanzeige und Sprecher-Beschriftungen

Shimmer-Varianten und Subagenten-Farben

Zu Vollbildrendering wechseln

Antwortbreite in breiten Terminals begrenzen

Große Inhalte einfügen

Wie Claude eingefügten Text behandelt

Reduzierte Einfügung löschen und wiederherstellen

Einen Prompt mit eingefügtem Text erneut aufrufen

Prompts mit Vim-Tastenkombinationen bearbeiten

Mehrzeilige Prompts eingeben

Option-Tastenkombinationen unter macOS aktivieren

Terminalglockenton oder Benachrichtigung erhalten

Sound mit einem Notification-Hook abspielen

Sitzungsstatus in Ihrem Terminal anzeigen

tmux konfigurieren

Backspace löscht unter Windows ein ganzes Wort

Das Farbschema anpassen

Ein benutzerdefiniertes Theme erstellen

Text- und Akzentfarben

Statusfarben

Eingabefeld und Modus-Indikatoren

Diff-Darstellung

Vollbildmodus

Nutzungsanzeige und Sprecher-Beschriftungen

Shimmer-Varianten und Subagenten-Farben

Zu Vollbildrendering wechseln

Antwortbreite in breiten Terminals begrenzen

Große Inhalte einfügen

Wie Claude eingefügten Text behandelt

Reduzierte Einfügung löschen und wiederherstellen

Einen Prompt mit eingefügtem Text erneut aufrufen

Prompts mit Vim-Tastenkombinationen bearbeiten

Verwandte Ressourcen