Konfigurieren Sie Ihr Terminal für Claude Code

Beheben Sie Shift+Enter für Zeilenumbrüche, erhalten Sie einen Terminal-Gong, wenn Claude fertig ist, konfigurieren Sie tmux, passen Sie das Farbschema an, und aktivieren Sie den Vim-Modus in der Claude Code CLI.

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 Eingabeaufforderungen eingeben

Durch Drücken der Eingabetaste wird Ihre Nachricht abgesendet. Um einen Zeilenumbruch hinzuzufügen, ohne abzusenden, drücken Sie Strg+J, oder geben Sie \ ein und drücken dann die Eingabetaste. Beide Methoden funktionieren in jedem Terminal ohne Setup.

In den meisten Terminals können Sie auch Umschalt+Eingabe drücken, aber die Unterstützung variiert je nach Terminal-Emulator:

Für VS Code, Cursor, Devin Desktop, Alacritty vor 0.16 und Zed schreibt /terminal-setup eine Umschalt+Eingabe-Tastenbindung in die Konfigurationsdatei des Terminals. Bei der ersten Ausführung wird eine Bestätigung wie Installed VSCode terminal Shift+Enter key binding angezeigt. Vorhandene Bindungen bleiben erhalten; wenn Sie eine Meldung wie VSCode terminal Shift+Enter key binding already configured sehen, wurde keine Änderung vorgenommen. Führen Sie /terminal-setup direkt im Host-Terminal aus, 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 auch zwei Editor-Einstellungen: Es setzt terminal.integrated.gpuAcceleration auf "off", um verzerrten Text im integrierten Terminal zu verhindern, und es setzt terminal.integrated.mouseWheelScrollSensitivity für sanfteres Scrollen im Vollbildmodus. Um die GPU-Beschleunigungsänderung rückgängig zu machen, setzen Sie sie auf "auto" zurück und laden Sie das Editor-Fenster neu.

In Zed aktualisiert /terminal-setup Ihre keymap.json an Ort und Stelle:

• Wenn die Keymap bereits Bindungen hat und keine davon eine Terminal-shift-enter ist, sichert Claude Code diese zunächst in einer Kopie im selben Verzeichnis, z. B. keymap.json.1a2b3c4d.bak, und führt dann die Umschalt+Eingabe-Bindung in Ihre Keymap ein, wobei Ihre anderen Tastenbindungen und Kommentare erhalten bleiben
• Wenn Claude Code die Keymap nicht lesen oder analysieren kann, sie nicht sichern kann oder das zusammengeführte Ergebnis nicht überprüfen kann, lässt es die Datei unverändert und gibt den Tastenbindungsblock zum manuellen Hinzufügen aus

Wenn Sie innerhalb von tmux ausgeführt werden, erfordert Umschalt+Eingabe auch die tmux-Konfiguration unten, selbst wenn das äußere Terminal dies unterstützt.

Um Zeilenumbruch an eine andere Taste zu binden oder das Verhalten zu tauschen, sodass Eingabetaste einen Zeilenumbruch einfügt und Umschalt+Eingabe absendet, ordnen Sie die Aktionen chat:newline und chat:submit in Ihrer Tastenbindungsdatei zu.

Option-Taste-Tastenkombinationen auf macOS aktivieren

Einige Claude Code-Tastenkombinationen verwenden die Option-Taste, z. B. Option+Eingabe für einen Zeilenumbruch oder Option+P zum Wechsel von Modellen. Auf macOS senden die meisten Terminals die Option-Taste standardmäßig nicht als Modifizierer, daher funktionieren diese Tastenkombinationen nicht, bis Sie dies aktivieren. Die Terminal-Einstellung dafür wird normalerweise als „Use Option as Meta Key" bezeichnet; Meta ist der historische Unix-Name für die Taste, die jetzt als Option oder Alt bezeichnet wird.

Für Ghostty, Kitty und andere Terminals suchen Sie in der Konfigurationsdatei des Terminals nach einer Option-als-Alt- oder Option-als-Meta-Einstellung.

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 eine Desktop-Benachrichtigung nur in Ghostty, Kitty und iTerm2. In anderen Terminals setzen Sie preferredNotifChannel auf "terminal_bell", um stattdessen den Terminalglockenton zu aktivieren, oder konfigurieren Sie einen Notification-Hook für einen benutzerdefinierten Sound oder Befehl. Der folgende Einträge in den Einstellungen aktiviert den Terminalglockenton:

{
  "preferredNotifChannel": "terminal_bell"
}

Die Desktop-Benachrichtigung erreicht Ihren lokalen Computer über SSH, sodass eine Remote-Sitzung Sie immer noch benachrichtigen kann. Ghostty und Kitty leiten sie ohne weitere Einrichtung an Ihr Betriebssystem-Benachrichtigungscenter weiter. iTerm2 erfordert, dass Sie die Weiterleitung aktivieren:

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.

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

tmux konfigurieren

Wenn Claude Code innerhalb von tmux ausgeführt wird, funktionieren standardmäßig zwei Dinge nicht: Shift+Enter sendet ab, anstatt einen Zeilenumbruch einzufügen, und Desktop-Benachrichtigungen sowie die Fortschrittsleiste erreichen niemals das äußere Terminal. 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:

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

Die allow-passthrough-Zeile ermöglicht es, dass Benachrichtigungen und Fortschrittsaktualisierungen das äußere Terminal erreichen, anstatt von tmux aufgenommen zu werden. Die extended-keys-Zeilen ermöglichen es tmux, Shift+Enter von einfachem Enter zu unterscheiden, damit die Zeilenumbruch-Verknüpfung funktioniert.

Behebung: Rücktaste löscht auf Windows ein ganzes Wort

Unter Windows liest Claude Code eine Rücktaste, die als ^H ankommt, als Strg+Rücktaste, was das vorherige Wort löscht, außer wenn TERM_PROGRAM mintty oder TERM cygwin ist. Auf macOS und Linux liest Claude Code sie als einfache Rücktaste.

Wenn jedes Drücken der Rücktaste ein ganzes Wort löscht, sendet Ihr Terminal ^H für die einfache Rücktaste. Setzen Sie CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. Rücktaste und Strg+H löschen dann jeweils ein Zeichen. Wenn Strg+Rücktaste auf macOS oder Linux nur ein Zeichen löscht, weil Ihr Terminal ^H dafür sendet, setzen Sie die Variable stattdessen auf 1.

Farbschema anpassen

Verwenden Sie den Befehl /theme oder die Designauswahl in /config, um ein Claude Code-Design auszuwählen, das zu Ihrem Terminal passt. Wenn Sie die Option „auto" auswählen, wird der helle oder dunkle Hintergrund Ihres Terminals erkannt, sodass das Design den Änderungen des Betriebssystems folgt, wenn Ihr Terminal dies tut. Claude Code steuert nicht das Farbschema des Terminals selbst, das von der Terminalanwendung festgelegt wird.

Um anzupassen, was am unteren Rand der Benutzeroberfläche angezeigt wird, konfigurieren Sie eine benutzerdefinierte Statuszeile, die das aktuelle Modell, das Arbeitsverzeichnis, den Git-Branch oder andere Kontextinformationen anzeigt.

Benutzerdefiniertes Design erstellen

Zusätzlich zu den integrierten Voreinstellungen listet /theme alle benutzerdefinierten Designs auf, die Sie definiert haben, sowie alle Designs, die von installierten Plugins beigetragen wurden. Wählen Sie Neues benutzerdefiniertes Design… am Ende der Liste, um eines interaktiv zu erstellen: Sie benennen das Design und wählen dann einzelne Farbtoken aus, um sie zu überschreiben. Drücken Sie Ctrl+E, während ein benutzerdefiniertes Design hervorgehoben ist, um es zu bearbeiten.

Jedes benutzerdefinierte Design ist eine JSON-Datei in ~/.claude/themes/. Der Dateiname ohne die .json-Erweiterung ist der Slug des Designs, und das Auswählen des Designs speichert custom:<slug> als Ihre Design-Einstellung. Die Datei hat drei optionale Felder:

Farbwerte akzeptieren #rrggbb, #rgb, rgb(r,g,b), ansi256(n) oder ansi:<name>, wobei <name> einer der 16 standardmäßigen ANSI-Farbnamen wie red oder cyanBright ist. Unbekannte Token und ungültige Farbwerte werden ignoriert, sodass ein Tippfehler das Rendering nicht beschädigen kann.

Das folgende Beispiel definiert ein Design, das die dunkle Voreinstellung beibehält, aber die Eingabeaufforderungs-Akzentfarbe, Fehlertext und Erfolgstexte neu färbt:

{
  "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 Änderungen in Ihrem Editor auf eine laufende Sitzung angewendet werden, ohne einen Neustart erforderlich zu machen. Wenn der Ordner ~/.claude/themes/ nicht existierte, als Claude Code gestartet wurde, starten Sie einmal neu, nachdem Sie Ihre erste Design-Datei erstellt haben. Danach werden Änderungen ohne Neustart angewendet.

Die folgende Referenz behandelt die Token, die Sie in overrides festlegen können. Der interaktive Editor in /theme zeigt die gleichen Token mit einer Live-Vorschau sowie einige spezialisierte Akzente wie Onboarding-Bildschirmfarben, die hier weggelassen sind.

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

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"
}
}

Großen Inhalt einfügen

Wenn Sie mehr als 800 Zeichen oder mehr als drei Zeilen in die Eingabeaufforderung einfügen, reduziert Claude Code die Eingabe auf einen Platzhalter wie [Eingefügter Text #1 +120 Zeilen], damit das Eingabefeld nutzbar bleibt, und sendet dennoch den vollständigen Inhalt, wenn Sie die Eingabe absenden. Für sehr große Eingaben wie ganze Dateien oder lange Protokolle schreiben Sie den Inhalt in eine Datei und bitten Sie Claude, diese zu lesen, anstatt sie einzufügen. Das Gesprächstranskript bleibt lesbar und Claude kann die Datei in späteren Durchläufen nach Pfad referenzieren. Das in VS Code integrierte Terminal kann auch Zeichen aus sehr großen Einfügungen verlieren, bevor sie Claude Code erreichen. Verwenden Sie daher dort eine Datei.

Wenn die eingefügte Datei unsichtbare Unicode-Zeichen enthält, entfernt Claude Code diese, wenn Sie die Eingabetaste drücken, und setzt die bereinigte Eingabeaufforderung in das Eingabefeld zurück, damit Sie sie mit einer weiteren Eingabetaste absenden können.

Wie Claude eingefügten Text behandelt

Wenn Sie absenden, sieht Claude den Inhalt hinter jedem [Eingefügter Text #N]-Platzhalter als Text markiert, den Sie von irgendwo anders eingefügt haben, anstatt ihn zu tippen. Claude wird mitgeteilt, dass eine Einfügung Anweisungen enthalten kann, die Sie nicht geschrieben haben, und dass er Anweisungen darin nur dort befolgen soll, wo die von Ihnen eingegebene Nachricht dies verlangt. In Sitzungen, die Feature-Flags nicht abrufen, werden Einfügungen nicht markiert.

Eine reduzierte Einfügung löschen und wiederherstellen

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

Eine Eingabeaufforderung mit eingefügtem Text abrufen

Claude Code speichert den Inhalt hinter jedem [Eingefügter Text #N]-Platzhalter unter ~/.claude/paste-cache/, sodass Sie beim Abrufen einer Eingabeaufforderung aus dem Befehlsverlauf und erneuter Absendung der vollständige eingefügte Inhalt erneut gesendet wird, auch in einer späteren Sitzung.

Cache-Dateien, die älter als cleanupPeriodDays sind, werden gemäß den Aufräumregeln gelöscht, sodass eine abgerufene Eingabeaufforderung auf eingefügten Text verweisen kann, der nicht mehr vorhanden ist. Wenn Sie eine solche Eingabeaufforderung absenden, sendet Claude Code niemals die wörtliche Zeichenkette [Eingefügter Text #N] und zeigt eine Benachrichtigung an, die den fehlenden Einfügungstext benennt:

• In einer einfachen Eingabeaufforderung mit verbleibendem Text entfernt Claude Code den Platzhalter und sendet den verbleibenden Text.
• In einem Shell-Modus-Befehl oder einem /-Befehl, bei dem die Entfernung das Ausgeführte ändern würde, und in jeder Eingabeaufforderung, bei der die Entfernung zu einer leeren Eingabe führt, bricht Claude Code die Absendung ab und behält den ursprünglichen Text in der Eingabe, wobei der Platzhalter noch darin enthalten ist. Löschen Sie den Platzhalter oder bearbeiten Sie den Befehl, und senden Sie dann erneut ab.

Prompts mit Vim-Tastenbindungen bearbeiten

Claude Code enthält einen Vim-ähnlichen Bearbeitungsmodus für die Eingabeaufforderung. Aktivieren Sie ihn über /config → Editor mode, oder indem Sie editorMode in ~/.claude/settings.json auf "vim" setzen. Setzen Sie Editor mode zurück auf normal, um ihn auszuschalten.

Der Vim-Modus unterstützt eine Teilmenge von NORMAL- und VISUAL-Modus-Bewegungen und Operatoren, wie z. B. hjkl-Navigation, v/V-Auswahl und d/c/y mit Textobjekten. Siehe die Vim-Editor-Modus-Referenz für die vollständige Tabelle der Tasten.

Vim-Bewegungen können nicht über die Tastenbindungsdatei neu zugeordnet werden. Um eine zweitastige INSERT-Modus-Sequenz wie jj auf Escape abzubilden, setzen Sie vimInsertModeRemaps in Ihren Benutzereinstellungen.

Das Drücken der Eingabetaste sendet Ihre Eingabeaufforderung im INSERT-Modus weiterhin ab, anders als bei Standard-Vim. Verwenden Sie o oder O im NORMAL-Modus oder Strg+J, um stattdessen eine neue Zeile einzufügen.

Verwandte Ressourcen

• 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