Diese Seite ist eine Übersetzung der englischen Dokumentation. Befehle, Bezeichner und Beispiele bleiben unverändert. Runtime 7.24.4 · SDK 2.6.7. Englische Fassung

Darstellung im Terminal

Status: Aktuell Geltungsbereich: Auswahl des TUI-Terminalprofils, Überschreibungen und Grenzen der visuellen Fähigkeiten Zuletzt geprüft: 2026-10-03 Verantwortlich: Betreuende der TUI von AX Code

AX Code wählt beim Start ein Terminalprofil aus der Umgebung. Das Profil steuert die Einrichtung des Terminals, nicht die Auflösung des Monitors oder die Schärfe der Schrift.

Ein ausdrückliches TERM_PROGRAM hat Vorrang vor geerbten Markern des äußeren Terminals. Eingeschränkte Terminalarten wie dumb, linux und vt100 bleiben ebenfalls kompatibel. Die Identität Ubuntu oder WSL allein schaltet das fortgeschrittene Profil nicht frei.

Das fortgeschrittene Profil nutzt den alternativen Bildschirm, einen nativen Darstellungsthread und die Erkennung der Terminalfähigkeiten. Das kompatible Profil nutzt den Hauptbildschirm ohne den nativen Darstellungsthread. Beide aktivieren die Mausinteraktion (siehe Mauserfassung) sowie die Aushandlung des Tastaturprotokolls und zielen auf 60 FPS. Die tatsächliche Bildrate hängt von der Last und vom Terminal ab.

Windows Terminal behält visuelle Effekte mit 24-bit in beiden Profilen, wenn seine direkte Sitzung erkannt wird. Aus der Farbunterstützung folgt weder Pixelgrafik noch Unterstützung für Nerd Font. Der Modus Advanced ändert die Schrift, die Schriftgröße und die Skalierung der Anzeige nicht.

Mauserfassung

AX Code erfasst die Mauseingabe des Terminals standardmäßig, damit Steuerungen in der TUI anklickbar bleiben: die Kurzbefehls-Chips in der Fußzeile (Fast-Modell, Autonom, Sandbox), Optionen von Dialog und Autovervollständigung, Klick zum Fokussieren, Auswahl durch Ziehen und Scrollen mit dem Rad in der TUI. Solange die Erfassung an ist, übergibt das Terminal die Maus an das laufende Programm. Das eigene Rechtsklickmenü des Terminals und die native Textauswahl erscheinen dann nicht. Viele Terminals stellen sie weiterhin über eine Modifikatortaste bereit — meist Umschalt plus Rechtsklick, manchmal Option oder Alt —, abhängig vom Terminal und davon, ob tmux, screen oder Zellij dazwischenliegt.

Setzen Sie mouse auf false in tui.json, um die Maus an das Terminal zurückzugeben:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 schaltet die Erfassung unabhängig von tui.json ab. Die Variable gibt es, weil Dateien tui.json auf Projektebene nicht vertrauenswürdige Eingaben sind: ein Repository darf das eigene Mausverhalten des Terminals nicht gegen Ihren Wunsch unterdrückt halten. Die Variable schaltet die Erfassung nur ab und kann sie nicht erzwingen.

Das Abwählen ist ein Tausch mit beiden Seiten:

• Zurück: das native Rechtsklickmenü des Terminals, die native Textauswahl und Kopieren sowie Einfügen. Der eigene Scrollback des Terminals verarbeitet das Rad im kompatiblen Profil.
• Entfällt: Kurzbefehls-Chips in der Fußzeile, Klick zum Fokussieren, anklickbare Optionen von Dialog und Autovervollständigung, Auswahl durch Ziehen und — im fortgeschrittenen Profil mit alternativem Bildschirm, das keinen Scrollback des Terminals hat — das Scrollen mit dem Rad in der TUI. Die Steuerung über die Tastatur bleibt für diese Aktionen verfügbar.

Solange die Erfassung an ist, öffnet ein Rechtsklick das eigene Kontextmenü der TUI anstelle des Terminals: ein kleines Menü Kopieren / Einfügen an der Klickposition. Kopieren ist aktiv, wenn eine Auswahl auf dem Bildschirm liegt, Einfügen, wenn ein Texteingabefeld den Fokus hat — einschließlich Prompt und Eingaben in Dialogen. Das Menü schließt bei Escape, bei jedem Tastendruck, beim Scrollen oder bei einem Klick daneben. Ist die Erfassung aus, verarbeitet das Terminal den Klick.

Profil überschreiben

Setzen Sie AX_CODE_TUI_ADVANCED_TERMINAL=1, um den Modus Advanced anzufordern, oder 0, um den kompatiblen Modus anzufordern. Eine ausdrückliche Überschreibung hat Vorrang vor der automatischen Erkennung, auch in entfernten und gemultiplexten Sitzungen. Entfernen Sie die Variable, um die automatische Auswahl wiederherzustellen. true/false, yes/no und on/off werden ebenfalls akzeptiert.

PowerShell, für die aktuelle Shell und ihre Kindprozesse:

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

Bash oder Zsh, für einen einzelnen Start:

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

Exportieren Ihre Startdateien der Shell die Variable, entfernen Sie diesen Export und führen Sie unset AX_CODE_TUI_ADVANCED_TERMINAL aus, um die automatische Auswahl wiederherzustellen.

Pixel-Animationen

Öffnungs- und Schlussanimationen nutzen Pixel nur, wenn der Renderer Kitty-Grafik, gültige Pixelmaße, ein lokales TTY, den alternativen Bildschirm und keinen Multiplexer bestätigt. Fehlende Fähigkeiten oder ein Fehler der Grafik nutzen den Text-Rückfall. Der automatische Modus Advanced umgeht diese Prüfungen nicht.

Alle Einzelbilder der Pixel-Animation — Digital Code, Foliage und die Szenen mit Landmarken — sind auf 1920x1080 begrenzt. Diese Animationsbilder aktualisieren sich im Takt von 20 FPS, getrennt vom Ziel von 60 FPS des Renderers. Siehe Öffnungs- und Schlussanimationen der TUI für Vorschauen.

Sitzungen von Windows Terminal mit bestätigter Sixel-Unterstützung und ohne Kitty-Grafik zeigen ein statisches Sixel-Startbild, begrenzt auf 640x360 und 256 KiB, anstelle des Text-Rückfalls. AX_CODE_SIXEL_SPLASH=0 schaltet es ab; =1 erlaubt jedem Sixel-Terminal, es anzuzeigen (Testpfad). Beim Abbau wird der Bereich des Startbilds mit dem Overlay-Hintergrund neu gezeichnet, weil Sixel keine Löschung über image-id kennt.

Schrift in Windows Terminal

AX Code kann die Schrift des Terminals nicht ändern. Symbole für Dateitypen (Zeichen im privaten Bereich von Nerd Font) erscheinen in Windows Terminal nur mit einer installierten gepatchten Schrift. Die empfohlene Schrift ist Cascadia Code NF: installieren Sie sie und legen Sie sie danach als Profilschrift fest unter Einstellungen > Profile > Darstellung > Schriftart. Ein einmaliger Hinweis in der Anwendung verweist Benutzer von Windows Terminal auf diese Einrichtung. Er erscheint nicht, wenn die Symbole bereits dargestellt werden oder AX_CODE_NERD_FONT=0 ihn abwählt.