Benutzerhandbuch

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.

Einstellungen · Darstellung

1. Allgemein

EintragBeschreibung
SpracheSprache der Oberfläche. „Auto (System)“ folgt der Systemsprache; elf Sprachen stehen zur Verfügung
BenachrichtigungstonTon für Benachrichtigungen (standardmäßig aktiviert)
System notificationsSchaltet 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-BefehlNur 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

EintragBeschreibung
AkzentAkzentfarbe: „Thema folgen“ oder eine von vier Farben
Dichte„Kompakt“, „Normal“ (Standard) oder „Locker“
BereicheStil der Bereiche: „Bündig“ (Standard) oder „Karte“
Trennlinie„Dezent“ (Standard) oder „Sichtbar“
Seitenleiste„Baum“ (Standard) oder „Kompakt“
Interface fontSchriftart der Oberfläche
Interface sizeSchriftgröß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

EintragBeschreibung
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-ShellShell für neue Terminals. Wird unter Windows angezeigt, wo mehrere Shells verfügbar sind; macOS und Linux verwenden immer die Shell des Systems
Terminal fontSchriftart des Terminals
Terminal sizeSchriftgröße des Terminals (Standard 13). ⌘+ / ⌘- / ⌘0 ändern sie während der Arbeit
Zeilenhöhe im TerminalZeilenabstand des Terminals (Standard 1,2×)

4. Unterhaltungsansicht

Diese Einstellungen gelten für die Gesprächsansicht von Agentensitzungen; siehe Gesprächsansicht.

EintragBeschreibung
Schriftart der Unterhaltung, Schriftgröße der Unterhaltung, Zeilenhöhe der UnterhaltungTypografie des Gesprächs, unabhängig von den Terminaleinstellungen (Standardgröße 13,5, Zeilenhöhe 1,2×)
Symbolleiste im EingabebereichWelche 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

EintragBeschreibung
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 StatusfiltersIst ein Statusfilter in der Seitenleiste aktiv, werden Sitzungen hinzugefügt, die neu zutreffen (standardmäßig aktiviert)
Background limitIm 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 spawnZeigt vor dem Start einer Untersitzung eine Bestätigungskarte (standardmäßig aktiviert); siehe Untersitzungen und Git-Zusammenarbeit §4
Usage auto-refreshHält die Kontonutzung im Infopanel aktuell (standardmäßig aktiviert)
Usage refreshAktualisierungsintervall: 30 s, 1 min, 2 min oder 5 min (Standard 5 min)
Nach Zurücksetzung fortsetzenSetzt 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 bereinigenEntfernt 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

EintragBeschreibung
Terminal-Renderer„DOM“ (Standard) oder „WebGL“. Behalten Sie den Standard bei, sofern Sie keinen bestimmten Grund für eine Änderung haben
Beim Tabwechsel neu zeichnenZeichnet 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 priorisierenHält die Eingabe reaktionsschnell, während Agenten in anderen Tabs viel Ausgabe erzeugen (standardmäßig aktiviert)
Sitzungsprotokolle aufzeichnenSpeichert 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.

Einstellungen · Agenten

EintragBeschreibung
AgententypDer 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
BerechtigungStandardberechtigung 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
StandardansichtFür Claude, Codex, OpenCode, Pi und OMP: „Gesprächsansicht“ (Standard) oder „Terminalansicht“ für neue Sitzungen. Bestehende Sitzungen behalten ihre Ansicht

8. Tastenkürzel

Einstellungen · 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.

AktionmacOS-Desktop-AppWindows, Linux
Projekt öffnen⌘OCtrl+Alt+O
Neues Terminal⌘TCtrl+Alt+T
Neue Agentensitzung⌘NCtrl+Alt+N
Neuer Browser-Tab (nur Desktop-App)⌘⇧BCtrl+Alt+B
Rechts teilen⌘DCtrl+Alt+D
Unten teilen⌘⇧DCtrl+Alt+E
Bereich / Tab schließen⌘WCtrl+Alt+W
Im Terminal suchen⌘FCtrl+Alt+F
Alle Sitzungen durchsuchen⌘⇧FCtrl+Alt+G
Dokument speichern⌘SCtrl+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

OrtTasteAktion
GesprächsansichtEnter / Shift+EnterSenden / 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 arbeitetEscDurchlauf anhalten
Bestätigungskarte für Untersitzungen⌘Enter (Ctrl+Enter)Sitzung starten
Tab-LeisteMittelklickTab schließen
Seitenleiste⌘/Ctrl-Klick, Shift-KlickMehrere Sitzungen oder einen Bereich auswählen