Das Terminal

Jeder Terminalbereich führt Ihre echte Login-Shell aus und nutzt eines von zwei nativen, GPU-beschleunigten Backends. Das Verhalten darum herum – Fokus, Suche, Mitteilungen, Links, Verlauf, Themen und sicheres Einfügen – wird von Zshell verwaltet und bleibt bei beiden Emulatoren einheitlich.

Terminal-BackendsLink kopieren

Wählen Sie unter Einstellungen → Terminal → Backend:

Beide unterstützen GPU-Beschleunigung, Bilder, Zshells gemeinsamen Themenkatalog, Suche, Mausmeldungen, Mitteilungen und Fortschrittsmeldungen. Ein Backend-Wechsel betrifft nur neue Terminals; bestehende Bereiche behalten ihren ursprünglichen Emulator.

Ihre Shell bleibt unverändertLink kopieren

Jede Sitzung startet die Login-Shell Ihres Kontos. Prompt, Aliasse, Funktionen und Dotfiles werden wie in jedem anderen Terminal geladen. Zshell ergänzt Variablen für Fähigkeiten und Identität:

Beide Backends melden über TERM_PROGRAM Ghostty, da CLIs mit Bild- und Mitteilungsunterstützung dies als Fähigkeitshinweis verwenden. Nutzen Sie ZSHELL_TERM, wenn Sie den Renderer unterscheiden müssen.

Beim Start über Dock oder Finder liest Zshell SSH_AUTH_SOCK aus Ihrer interaktiven Login-Shell und verwendet den in Ihren dotfiles gewählten Agent. Beim Terminalstart bleibt ein gültiger geerbter Agent erhalten.

SystemberechtigungenLink kopieren

Lokale Programme in einem Zshell-Terminal können Zugriff auf Kamera oder Mikrofon oder die Steuerung einer anderen App über Apple Events anfordern. macOS ordnet diese Anfragen Zshell zu; erlauben Sie den Zugriff nur vertrauenswürdigen Programmen. Die Automatisierung muss für jede Ziel-App einzeln erlaubt werden.

Verwalten Sie den Zugriff unter Systemeinstellungen → Datenschutz & Sicherheit → Kamera, Mikrofon oder Automation. Eine abgelehnte Anfrage verhindert die entsprechende Funktion. Zshell erteilt diese Berechtigungen nicht automatisch.

Fokus folgt der MausLink kopieren

Aktivieren Sie Einstellungen → Terminal → Verhalten → Fokus folgt der Maus. Der Fokus wechselt beim Betreten eines Terminalbereichs. Standardmäßig aus, für beide Backends und das Schnellterminal. Beim Ziehen, aus einem Editor oder bei geöffnetem Menü oder Dialog bleibt der Fokus bestehen.

terminal.focus-follows-mouse = true

SucheLink kopieren

Die Suche gilt für den fokussierten Terminal- oder Editorbereich und bleibt aktiv, solange ihr Eingabefeld den Tastaturfokus hat.

Eingabe am Prompt bearbeitenLink kopieren

Klicken Sie in die aktive Shell-Eingabe, um den Cursor zu versetzen und dort weiterzuschreiben. In einem zsh-Prompt wählen Sie durch Ziehen einen Eingabebereich aus: Tippen ersetzt die Auswahl, Backspace oder Delete entfernt sie. Doppel- und Dreifachklick wählen weiterhin Terminaltext aus. Programme mit aktivierten Mausmeldungen, etwa bildschirmfüllende TUIs, erhalten weiterhin ihre eigenen Mausereignisse.

Hat eine verschachtelte oder ersetzende Shell Zshells Unterstützung für Prompt-Bearbeitung nicht geladen, wählt Ziehen weiterhin Terminaltext zum Kopieren aus, bearbeitet aber nicht die Eingabe. Nach der Rückkehr zum ursprünglichen Prompt steht die Eingabebearbeitung wieder bereit.

Das normale Eingabefeld von Claude Code unterstützt auf beiden Backends Klickpositionierung und Bearbeitung per Ziehauswahl, auch bei umgebrochenen und mehrzeiligen Entwürfen. Tippen oder Einfügen ersetzt die markierte Eingabe; Backspace oder Delete entfernt sie. Vim-Normal- und Visual-Modus, Dialoge, Platzhalter für Anhänge oder eingeklappte Einfügungen sowie gescrollte Gesprächsausgaben behalten die übliche Terminalauswahl. Anwendungen, die Mausereignisse abfangen, verarbeiten diese weiterhin selbst.

Spracheingaben aus Zisla verwenden die Einfügeaktion des Terminals. In Claude Code ersetzen sie ebenfalls einen markierten Eingabebereich. Absichtliche Wiederholungen einer Phrase bleiben möglich.

Tastenkürzel des VordergrundprogrammsLink kopieren

Wenn Tastenkürzel eines Terminalprogramms mit Zshell kollidieren, aktivieren Sie im Kontextmenü seines Bereichs Zshell-Befehle blockieren. Tastenkombinationen mit Zusatztasten, darunter Ctrl+Return, gehen dann an das Vordergrundprogramm, solange der Bereich den Tastaturfokus hat. Kopieren, Einfügen und Alles auswählen bleiben verfügbar.

Die Einstellung gilt nur für diesen Bereich. Entfernen Sie das Häkchen im Kontextmenü, um Zshells Kürzel wiederherzustellen. Fängt ein Programm die Maus ab, halten Sie beim Rechtsklick Shift gedrückt, um Zshells Menü zu öffnen.

Prompt-WarteschlangeLink kopieren

Fokussieren Sie ein Terminal und drücken Sie Cmd+Shift+M oder wählen Sie Prompt-Warteschlange umschalten in der Befehlspalette. Die Leiste öffnet sich unter diesem Terminal. Geben Sie einen Eintrag ein und drücken Sie Return oder Zur Warteschlange hinzufügen. Jeder Eintrag ist einzeilig; eingefügte Zeilenumbrüche werden zu Leerzeichen.

Sobald die ursprüngliche zsh zu einem leeren Prompt zurückkehrt, sendet Zshell den nächsten Eintrag samt Return. Die Einträge laufen der Reihe nach. Das automatische Senden wartet, solange ein Agent oder anderes Vordergrundprogramm das Terminal belegt oder der Prompt einen Eingabeentwurf enthält. Es benötigt Zshells zsh-Integration. Bei anderen oder verschachtelten Shells ist manuelles Senden möglich.

Jeder Eintrag besitzt Jetzt senden und Entfernen. Jetzt senden übergibt Text und Return sofort an das aktuelle Terminalprogramm, ohne auf einen Shell-Prompt zu warten. Esc oder die Schließen-Schaltfläche blendet die Leiste aus und erhält die Einträge. Jedes Terminal hat seine eigene Warteschlange. Beim Schließen der Sitzung oder Beenden von Zshell wird sie verworfen.

Pfade und URLsLink kopieren

Zshell erkennt Web-URLs und vorhandene lokale Pfade in der Programmausgabe. Lokale Links dürfen absolut, relativ zu ~/, ./ oder ../ oder relativ zum aktuellen Arbeitsverzeichnis des Bereichs sein. Diagnose-Endungen wie :42 oder :42:7 verhindern das Auffinden der Datei nicht.

• Command-Klick auf einen lokalen Pfad zeigt ihn im Finder, auf eine URL öffnet er den Standardbrowser.
• Command-Rechtsklick bietet für Pfade Neuer Datei-Tab / Neuer Dateibereich, für URLs Neuer Browser-Tab / Neuer Browserbereich.
• Bildschirmfüllende Programme mit Mausmeldungen erhalten einen normalen Rechtsklick selbst. Halten Sie Shift gedrückt, um stattdessen Zshells Terminal- und Bereichsmenü zu öffnen.

So führen Compilerausgaben und Agentenprotokolle direkt zurück in dasselbe Projekt. Das Browserverhalten beschreibt Browserbereiche.

MitteilungenLink kopieren

Zshell leitet zwei Terminalereignisse an die Mitteilungszentrale weiter:

• eine Glocke aus einer nicht fokussierten Sitzung;
• eine OSC 777;notify-Anfrage eines Programms, etwa eines langen Builds oder Programmieragenten.

Mitteilungen können den Systemton abspielen. Ein Klick aktiviert Zshell und springt genau zu der auslösenden Sitzung. macOS fragt erst nach Erlaubnis, wenn ein Terminal erstmals eine Mitteilung senden möchte, nicht schon beim Start von Zshell.

BefehlsabschlussLink kopieren

Unter Einstellungen → Terminal → Befehlsmitteilungen aktivieren Sie Mitteilungen zum Befehlsende:

• Lange laufende Befehle: Wählen Sie 5, 10, 30 oder 60 Sekunden. Ein mindestens so lange laufender Befehl löst beim Abschluss eine Mitteilung aus. Standardmäßig ist dies Aus.
• Fehlgeschlagene Befehle: Benachrichtigt unabhängig von der Laufzeit bei einem Exit-Status ungleich null. Dies ist in neuen Konfigurationen standardmäßig an und lässt sich separat deaktivieren.

Die Einstellungen gelten auf beiden Backends für zsh-Terminals, die danach erstellt werden. Sie verwenden das Abschlussereignis der ursprünglichen Shell. Befehle innerhalb einer verschachtelten Shell oder eines interaktiven Programms melden über diese Integration keine einzelnen Abschlüsse.

Dieselben Einstellungen können in ~/.config/zshell/config.toml stehen:

terminal.notify-finish-seconds = 30
terminal.notify-on-error = true

Mit terminal.notify-finish-seconds = 0 deaktivieren Sie laufzeitabhängige Mitteilungen. Die Zustellung richtet sich nach Ihren macOS-Mitteilungseinstellungen.

FortschrittsmeldungenLink kopieren

Programme, die OSC 9;4-Fortschritt senden, erhalten eine schmale Leiste über dem Terminal, mit unterschiedlichen Zuständen für normal, pausiert und Fehler. Es muss nichts aktiviert werden: Meldet das Programm Fortschritt, zeigt der Bereich ihn an.

Zwischenablage, Drag-and-drop und sicheres EinfügenLink kopieren

• Lesen der Zwischenablage wird bestätigt. OSC 52 kann die macOS-Zwischenablage anfordern, auch von einem entfernten Rechner über SSH. Zshell fragt vor der Herausgabe nach.
• Riskante Einfügungen werden markiert. Mehrzeiliger oder befehlsähnlicher Text wartet auf eine Bestätigung, bevor er direkt übergeben wird.
• Dateien und Bildschirmfotos werden zu sicheren Shell-Pfaden. Finder-Dateien werden als zitierte absolute Pfade eingefügt. Ein reines Zwischenablagebild wird als private temporäre PNG gespeichert und sein Pfad eingefügt. Remote-Bereiche laden Dateien und Bilder zuerst auf den Host hoch.

Eingabe mit der Option-TasteLink kopieren

Standardmäßig bleibt Option bei der aktiven macOS-Eingabequelle, damit Layouts wie Polish Pro zusammengesetzte Zeichen eingeben können. Aktivieren Sie Option als Alt/Meta verwenden, wenn ein Terminalprogramm diese Kombinationen als Meta-Kürzel erhalten soll. Siehe terminal.macos-option-as-alt.

Der Befehl zshellLink kopieren

Jedes Zshell-Terminal enthält eine projektbezogene CLI:

zshell                         # Projekt im aktuellen Verzeichnis erstellen
zshell vim ~/src/app.swift     # Projekt erstellen und diese argv im ersten Terminal ausführen
zshell +themes                 # Themen interaktiv durchsuchen und voranzeigen
zshell +themes --list --dark   # Themennamen ohne Browser ausgeben
zshell +help                   # Alle Befehlsgruppen anzeigen

Der Themenbrowser zeigt jede Auswahl in der gesamten Anwendung als Vorschau. Return speichert sie, Escape stellt das vorherige Thema wieder her.

SchriftenLink kopieren

Zshell enthält JetBrains Mono und Nerd-Font-Symbole. Jede installierte dicktengleiche Familie kann die lateinische Schrift ersetzen; eine installierte CJK-Familie lässt sich vor den Symbol- und Systemersatzschriften einfügen. Siehe font-family, terminal.font-fallback-family, font-size, terminal.font-thicken und terminal.line-height.

Globales SchnellterminalLink kopieren

Während Zshell läuft, zeigt oder verbirgt Cmd+I oder Terminal → Schnellterminal ein unabhängiges Terminal. Größe, Deckkraft und Tastenkürzel ändern Sie unter Einstellungen → Terminal → Schnellterminal.

Sitzungsverhalten: Arbeitsbereich wiederverwenden (Standard) / Jedes Mal neuer Arbeitsbereich. Wiederverwendung erhält Bereiche und Aufgaben. Neue Arbeitsbereiche enden beim Ausblenden. Der Modus gilt ab dem nächsten Anzeigen; der bisherige Arbeitsbereich bleibt beim Zurückwechseln verfügbar. Der Befehlsverlauf folgt der Shell-Konfiguration. Ein neuer Arbeitsbereich beginnt immer mit einem leeren Terminal, ohne vorherige Ausgabe, Aufteilung oder Sitzungszustand wiederherzustellen.

Teilen Sie über Nach rechts teilen / Nach unten teilen, das Kontextmenü oder Cmd+D / Cmd+Shift+D. Die folgende Erhaltung gilt für wiederverwendete Arbeitsbereiche, einschließlich Teilungsverhältnissen und Fokus.

• Tastenkürzel, Esc, ein Klick außerhalb oder Fokusverlust blenden nur das Fenster aus. Dieselbe Shell, Eingabe, Verlauf und laufende Aufgaben bleiben erhalten.
• Heften Sie das Fenster an, damit es beim App-Wechsel sichtbar bleibt. Größe, Deckkraft und Anheftung bleiben auch ausgeblendet erhalten.
• exit beendet die Sitzung; beim nächsten Öffnen startet eine neue Shell.

Aktivieren Sie terminal.preserve-sessions, bevor Sie ein neues Schnellterminal öffnen, damit es nach dem normalen Beenden von Zshell weiterläuft. Beim erneuten Öffnen verbinden sich beide Backends mit derselben Shell. Zshell → Beenden und alle Sitzungen stoppen beendet auch ausgeblendete Sitzungen. Ein macOS-Neustart beendet die Sitzungen.

Der Schnellstart, der Befehle speichert und ausführt, ist eine eigene Funktion.

Vim-BefehlshinweiseLink kopieren

Verwalten Sie die Hinweise unter Einstellungen → Terminal → Verhalten → Vim-Befehlshinweise und öffnen Sie den Tab Info in der rechten Seitenleiste. Solange Vim, Vi oder Neovim aktiv ist, erscheint unter den Sitzungsinformationen der Abschnitt VIM-BEFEHLE. Die Funktion ist in neuen Konfigurationen standardmäßig an und wirkt bei beiden Backends sofort auf bestehende Terminals.

Die vollständige Liste gängiger Befehle bleibt verfügbar; nur die Reihenfolge ändert sich. Im Normal-Modus stehen :w, :q, yy und p/P zuerst, im Visual-Block-Modus I/A, Blockänderungen und Bewegungen zwischen Ecken. Insert, Replace, Visual, Visual Line, Select, Befehlszeilen- und Suchmodus besitzen eigene Reihenfolgen. Jeder Eintrag nennt seine anwendbaren Modi. Sie können nach Tasten, Beschreibung oder Modusnamen suchen; Beschreibungen und Suchoberfläche unterstützen alle 17 Anwendungssprachen. Leeren Sie die Suche für die vollständige Liste. Die Hinweise dienen nur als Referenz und senden keine Eingabe an den Editor.

Lokale Editoren werden am Vordergrundprogramm erkannt. Innerhalb von SSH, Mosh oder einem Terminalmultiplexer nutzt die Erkennung die sichtbare Vim-Modus-/Statuszeile und Bildschirmanordnung, ohne ein entferntes Plugin zu installieren. Lassen Sie Vims showmode oder eine erkennbare Statuszeile aktiv. Verborgene oder umbenannte Modusnamen können zu Normal-Hinweisen führen oder die entfernte Erkennung verhindern; eigene Tastenzuordnungen werden nicht ausgewertet. Nur das aktive Infopanel wird abgetastet. Die Hinweise verschwinden, wenn das Vordergrundprogramm wechselt oder der Editor nicht mehr erkennbar ist.

Alternativ aktivieren Sie die Funktion mit terminal.vim-command-hints = true in der Konfigurationsdatei.