Einstellungen und Tastenkürzel
Die Einstellungen öffnen Sie über das Zahnradsymbol in der Titelleiste. Unter macOS enthält auch das App-Menü den Eintrag „Settings…“ (⌘,); unter Windows und Linux drücken Sie Alt und wählen „Datei ▸ Einstellungen…“. Das Einstellungsfenster hat acht Kategorien: Allgemein, Darstellung, Terminal, Unterhaltungsansicht, Verhalten, Erweitert, Agenten und Tastenkürzel. Dieses Kapitel beschreibt jeden Eintrag und schließt mit den Standard-Tastenkürzeln. Die Einstellungen gelten gemeinsam für die Desktop-App und die mit ihr verbundenen Browser-Clients.

1. Allgemein
| Eintrag | Beschreibung |
|---|---|
| Sprache | Sprache der Oberfläche. „Auto (System)“ folgt der Systemsprache; elf Sprachen stehen zur Verfügung |
| Benachrichtigungston | Ton für Benachrichtigungen (standardmäßig aktiviert) |
| System notifications | Schaltet Systembenachrichtigungen ein oder aus (standardmäßig aktiviert). Hat das System Benachrichtigungen noch nicht erlaubt, fragt „Allow notifications“ nach der Berechtigung; sind sie blockiert, werden die Schritte für Ihr System angezeigt |
| Shell-Befehl | Nur in der macOS-Desktop-App: „‘vela’-Befehl installieren“ fügt Ihrer Shell den Befehl vela <project-path> hinzu, der ein Projekt in VelaTerm öffnet. „‘vela’-Befehl deinstallieren“ entfernt ihn wieder |
| Vela Skills | „Install“ (später „Reinstall“) installiert die VelaTerm-Skills für Claude Code und Codex, etwa /vspawn und $vspawn. Falls Codex sie nicht auflistet, starten Sie eine neue Codex-Sitzung. Siehe Sitzungsbefehle §2 |
2. Darstellung
| Eintrag | Beschreibung |
|---|---|
| Akzent | Akzentfarbe: „Thema folgen“ oder eine von vier Farben |
| Dichte | „Kompakt“, „Normal“ (Standard) oder „Locker“ |
| Bereiche | Stil der Bereiche: „Bündig“ (Standard) oder „Karte“ |
| Trennlinie | „Dezent“ (Standard) oder „Sichtbar“ |
| Seitenleiste | „Baum“ (Standard) oder „Kompakt“ |
| Interface font | Schriftart der Oberfläche |
| Interface size | Schriftgröße der Oberfläche; „Auto“ folgt der Dichte |
Das helle und das dunkle Design schalten Sie nicht hier, sondern in der Titelleiste um (System folgen, Dunkel, Hell). Laufende Claude-Sitzungen in der Terminalansicht übernehmen den Designwechsel ohne Neustart.
3. Terminal
| Eintrag | Beschreibung |
|---|---|
| Bild einfügen | „Dateipfad einfügen“ (Standard) speichert ein eingefügtes Bild als temporäre Datei und fügt deren Pfad ein. Mit „Nativ einfügen“ liest Claude Code oder Codex das Bild aus der Zwischenablage; diese Option steht nur in der lokalen Desktop-App zur Verfügung |
| Befehlsvorschläge | „Automatisch“, „Mit Tab“ oder „Aus“. Wirkt sofort, auch in bereits geöffneten Terminals; wird ausgeblendet, wo die Funktion nicht unterstützt wird. Siehe Befehlsvorschläge |
| Standard-Shell | Shell für neue Terminals. Wird unter Windows angezeigt, wo mehrere Shells verfügbar sind; macOS und Linux verwenden immer die Shell des Systems |
| Terminal font | Schriftart des Terminals |
| Terminal size | Schriftgröße des Terminals (Standard 13). ⌘+ / ⌘- / ⌘0 ändern sie während der Arbeit |
| Zeilenhöhe im Terminal | Zeilenabstand des Terminals (Standard 1,2×) |
4. Unterhaltungsansicht
Diese Einstellungen gelten für die Gesprächsansicht von Agentensitzungen; siehe Gesprächsansicht.
| Eintrag | Beschreibung |
|---|---|
| Schriftart der Unterhaltung, Schriftgröße der Unterhaltung, Zeilenhöhe der Unterhaltung | Typografie des Gesprächs, unabhängig von den Terminaleinstellungen (Standardgröße 13,5, Zeilenhöhe 1,2×) |
| Symbolleiste im Eingabebereich | Welche Steuerelemente neben dem Nachrichtenfeld erscheinen und in welcher Reihenfolge: Modell, Denkaufwand, Zusammenarbeitsmodus, Berechtigungsmodus, Schnellmodus, Geschwindigkeit, Tonfall, MCP-Server, Hintergrundaufgaben, Konto und Codex-Reset-Guthaben. Jedes Element hat einen Ein/Aus-Schalter; mit den Pfeilen ordnen Sie die eingeschalteten Steuerelemente neu an. Modell, Denkaufwand, Zusammenarbeitsmodus und Berechtigungsmodus sind standardmäßig eingeschaltet |
Steuerelemente, die der aktuelle Agent oder das aktuelle Modell nicht unterstützt, werden nicht angezeigt. Ein unterstütztes Steuerelement bleibt sichtbar, wenn seine Funktion vorübergehend nicht verfügbar ist, zum Beispiel MCP-Server und Hintergrundaufgaben, solange der Agentenprozess angehalten ist.
Ausgeschaltete Steuerelemente und solche, die neben dem Nachrichtenfeld keinen Platz finden, liegen im Menü Mehr, sodass Sie jedes unterstützte Steuerelement verwenden können, ohne es hier erst einzuschalten. Mehr wird nicht angezeigt, wenn alle unterstützten Steuerelemente eingeschaltet sind und Platz finden. Ein Steuerelement, das aus- und wieder eingeschaltet wird, rückt ans Ende der Zeile. Auf Mobilgeräten erscheinen ausgeschaltete Steuerelemente in einer zweiten Zeile.
5. Verhalten
| Eintrag | Beschreibung |
|---|---|
| Tabs | „Einzeln“ (Standard) öffnet eine Agentensitzung im aktuellen Tab und lässt den vorherigen Tab im Hintergrund weiterlaufen. „Mehrere“ öffnet jede Sitzung in einem eigenen Tab |
| Dynamische Ergänzung des Statusfilters | Ist ein Statusfilter in der Seitenleiste aktiv, werden Sitzungen hinzugefügt, die neu zutreffen (standardmäßig aktiviert) |
| Background limit | Im Modus Einzeln angezeigt: die Höchstzahl der Hintergrund-Tabs (8, 16, 32 oder 64; Standard 32). Wird das Limit überschritten, endet der älteste inaktive Hintergrund-Tab |
| Confirm before spawn | Zeigt vor dem Start einer Untersitzung eine Bestätigungskarte (standardmäßig aktiviert); siehe Untersitzungen und Git-Zusammenarbeit §4 |
| Usage auto-refresh | Hält die Kontonutzung im Infopanel aktuell (standardmäßig aktiviert) |
| Usage refresh | Aktualisierungsintervall: 30 s, 1 min, 2 min oder 5 min (Standard 5 min) |
| Nach Zurücksetzung fortsetzen | Setzt eine Aufgabe von Claude oder Codex automatisch fort, nachdem ein Fünf-Stunden- oder Wochenlimit zurückgesetzt wurde (standardmäßig aktiviert) |
| Eingefügte Bilder automatisch bereinigen | Entfernt die temporären Dateien eingefügter Bilder beim Beenden der App und beim Start alle Dateien, die älter als 24 Stunden sind (standardmäßig aktiviert). „Jetzt bereinigen“ entfernt sie sofort |
Kontext für Sitzungsverweise legt fest, wie vrefer --ask (und der Skill vask) das Gespräch einer anderen Sitzung an den antwortenden Agenten übergibt. „Vollständiges Protokoll“ (Standard) übergibt das gesamte Gespräch. „Zuerst zusammenfassen“ verdichtet es zunächst mit dem hier gewählten „Agent für Zusammenfassungen“ samt Modell und Denkaufwand. Siehe Sitzungsbefehle §5.
6. Erweitert
| Eintrag | Beschreibung |
|---|---|
| Terminal-Renderer | „DOM“ (Standard) oder „WebGL“. Behalten Sie den Standard bei, sofern Sie keinen bestimmten Grund für eine Änderung haben |
| Beim Tabwechsel neu zeichnen | Zeichnet ein Terminal vollständig neu, wenn Sie zu seinem Tab zurückkehren (standardmäßig deaktiviert). Aktivieren Sie die Option, wenn Terminaloberflächen nach einem Wechsel gelegentlich verzerrt aussehen |
| Vordergrund-Ausgabe priorisieren | Hält die Eingabe reaktionsschnell, während Agenten in anderen Tabs viel Ausgabe erzeugen (standardmäßig aktiviert) |
| Sitzungsprotokolle aufzeichnen | Speichert die Terminalausgabe von Agentensitzungen in einer Protokolldatei (standardmäßig deaktiviert). Ist die Option aktiviert, lassen sich archivierte Sitzungen wiedergeben, und die globale Suche erfasst auch Terminalausgaben. Normale Terminalsitzungen werden nie aufgezeichnet |
7. Agenten
Die „Standardeinstellungen für neue Sitzungen“ gelten für neu erstellte Sitzungen des gewählten Agenten. Einstellungen einer einzelnen Sitzung haben Vorrang; ausgenommen ist der Pfad zur ausführbaren Datei, der immer für den gesamten Agententyp gilt.

| Eintrag | Beschreibung |
|---|---|
| Agententyp | Der Agent, dessen Standardwerte Sie bearbeiten |
| Pfad zur ausführbaren Datei (optional) | Vollständiger Pfad zur ausführbaren Datei des Agenten. Bleibt das Feld leer, wird der Befehl im PATH gesucht. Wird nach einer erfolgreichen Installation per Klick automatisch ausgefüllt |
| Startargumente (optional) | Standardargumente für die Kommandozeile, zum Beispiel --model opus |
| Berechtigung | Standardberechtigung für neue Sitzungen. Claude, Codex und OpenCode bieten ihre benannten Modi; die meisten anderen Agenten bieten „Standard“ und „YOLO“ (alle Berechtigungsabfragen überspringen); Pi stellt keine Berechtigungsabfragen. Siehe KI-Agentensitzungen §6 |
| Standardansicht | Für Claude, Codex, OpenCode, Pi und OMP: „Gesprächsansicht“ (Standard) oder „Terminalansicht“ für neue Sitzungen. Bestehende Sitzungen behalten ihre Ansicht |
8. Tastenkürzel

Klicken Sie auf die Tastenkombination einer Aktion und drücken Sie dann die neue Kombination; Escape bricht ab. Eine Kombination besteht aus einem Buchstaben mit ⌘ (in der macOS-Desktop-App) oder Ctrl, optional zusammen mit Shift und Option/Alt. Ist die Kombination bereits belegt, nennt die Meldung die Aktion, die sie verwendet. „Standard wiederherstellen“ setzt alle Belegungen zurück.
| Aktion | macOS-Desktop-App | Windows, Linux |
|---|---|---|
| Projekt öffnen | ⌘O | Ctrl+Alt+O |
| Neues Terminal | ⌘T | Ctrl+Alt+T |
| Neue Agentensitzung | ⌘N | Ctrl+Alt+N |
| Neuer Browser-Tab (nur Desktop-App) | ⌘⇧B | Ctrl+Alt+B |
| Rechts teilen | ⌘D | Ctrl+Alt+D |
| Unten teilen | ⌘⇧D | Ctrl+Alt+E |
| Bereich / Tab schließen | ⌘W | Ctrl+Alt+W |
| Im Terminal suchen | ⌘F | Ctrl+Alt+F |
| Alle Sitzungen durchsuchen | ⌘⇧F | Ctrl+Alt+G |
| Dokument speichern | ⌘S | Ctrl+S |
Normale Browser. Wenn Sie VelaTerm in einem normalen Browser verwenden (Fernzugriff per URL), belegt der Browser selbst viele Kombinationen mit ⌘ und Ctrl. Deshalb gelten die obigen Belegungen für Windows und Linux auf jedem System, und die Einstellungsseite zeigt sie entsprechend an. Ausnahme ist ein Browser unter macOS: Dort bleiben Rechts teilen und Unten teilen auf ⌘D und ⌘⇧D. Remote-Verbindungsfenster der Desktop-App verwenden die Belegungen der Desktop-App.
Feste Tasten, die sich nicht ändern lassen: ⌘1–9 wechselt zwischen Tabs, und ⌘+ / ⌘- / ⌘0 ändert die Schriftgröße des Terminals bzw. setzt sie zurück (Ctrl unter Windows, Linux und in Browsern).
9. Auswahl für neue Agentensitzungen
„Neue Agentensitzung“ öffnet eine durchsuchbare Liste von Agententypen und gespeicherten Vorlagen („Agenten und Vorlagen suchen“). Zuletzt verwendete Einträge stehen oben und sind mit „Zuletzt verwendet“ gekennzeichnet.
Die Auswahl zeigt, wo die Sitzung erstellt wird. Ist eine gespeicherte Sitzung aktiv, wählen Sie „Gleiche Ebene“, um die neue Sitzung daneben zu erstellen, oder „Untergeordnete Sitzung“, um sie darunter zu erstellen. Solange das Suchfeld den Fokus hat, gilt:
- Tab wechselt zwischen „Gleiche Ebene“ und „Untergeordnete Sitzung“.
- ↑ und ↓ wählen ein Ergebnis aus; Enter erstellt die Sitzung.
- Shift+Tab verschiebt den Fokus auf das vorherige Steuerelement; Escape schließt die Auswahl.
Sie können auch auf ein Ergebnis klicken und „Erstellen“ wählen. Ist kein Projekt verfügbar, wählen Sie zuerst eines aus oder verwenden Sie „Projekt öffnen“.
Die Auswahl hat eine eigene Adresse, in der Ziel, Position, Suchtext und markierter Eintrag festgehalten sind. Wenn Sie den Link kopieren, die Seite neu laden oder zurück- und vorwärtsnavigieren, wird die Auswahl wiederhergestellt, ohne dass eine Sitzung entsteht. Schlägt das Erstellen fehl, bleibt die Auswahl geöffnet, sodass Sie es erneut versuchen können.
10. Weitere Tasten
| Ort | Taste | Aktion |
|---|---|---|
| Gesprächsansicht | Enter / Shift+Enter | Senden / neue Zeile |
| Gesprächsansicht, während der Agent arbeitet | ⌥Enter (Alt+Enter) | Nachricht dem laufenden Durchlauf hinzufügen |
| Gesprächsansicht, während der Agent arbeitet | ⌘Enter (Ctrl+Enter) | Durchlauf anhalten und diese Nachricht senden |
| Gesprächsansicht, während der Agent arbeitet | Esc | Durchlauf anhalten |
| Bestätigungskarte für Untersitzungen | ⌘Enter (Ctrl+Enter) | Sitzung starten |
| Tab-Leiste | Mittelklick | Tab schließen |
| Seitenleiste | ⌘/Ctrl-Klick, Shift-Klick | Mehrere Sitzungen oder einen Bereich auswählen |