Zum Inhalt springen
OpenCode
HomeDocs

TUI

Verwendung der OpenCode-Terminal-Benutzeroberflache.

OpenCode stellt eine interaktive Terminal-Schnittstelle oder TUI fur die Arbeit an Ihren Projekten mit einem LLM bereit.

Wenn Sie OpenCode starten, wird die TUI fur das aktuelle Verzeichnis gestartet.

Terminal-Fenster
opencode

Sie konnen es auch fur ein bestimmtes Arbeitsverzeichnis starten.

Terminal-Fenster
opencode /path/to/project

Sobald Sie in der TUI sind, konnen Sie ihr eine Nachricht senden.

Give me a quick summary of the codebase.

Dateireferenzen

Sie konnen in Ihren Nachrichten mit @ auf Dateien verweisen. Dies fuhrt eine unscharfe Dateisuche im aktuellen Arbeitsverzeichnis durch.

How is auth handled in @packages/functions/src/api/index.ts?

Der Inhalt der Datei wird automatisch zur Unterhaltung hinzugefugt.

Bash-Befehle

Beginnen Sie eine Nachricht mit !, um einen Shell-Befehl auszufuhren.

!ls -la

Die Ausgabe des Befehls wird als Tool-Ergebnis zur Unterhaltung hinzugefugt.

Befehle

Bei Verwendung der OpenCode-TUI konnen Sie / gefolgt von einem Befehlsnamen eingeben, um Aktionen schnell auszufuhren. Zum Beispiel:

/help

Die meisten Befehle haben auch eine Tastenbelegung mit ctrl+x als Leader-Taste, wobei ctrl+x die Standard-Leader-Taste ist. Mehr erfahren.

Hier sind alle verfugbaren Slash-Befehle:

connect

Einen Anbieter zu OpenCode hinzufugen. Ermoglicht es Ihnen, aus verfugbaren Anbietern auszuwahlen und deren API-Schlussel hinzuzufugen.

/connect

compact

Die aktuelle Sitzung komprimieren. Alias: /summarize

/compact

Tastenbelegung: ctrl+x c

details

Details zur Tool-Ausgabe umschalten.

/details

Tastenbelegung: ctrl+x d

editor

Externen Editor zum Verfassen von Nachrichten offnen. Verwendet den in Ihrer EDITOR-Umgebungsvariablen festgelegten Editor. Mehr erfahren.

/editor

Tastenbelegung: ctrl+x e

exit

OpenCode beenden. Aliase: /quit, /q

/exit

Tastenbelegung: ctrl+x q

export

Aktuelle Unterhaltung nach Markdown exportieren und im Standardeditor offnen. Verwendet den in Ihrer EDITOR-Umgebungsvariablen festgelegten Editor. Mehr erfahren.

/export

Tastenbelegung: ctrl+x x

help

Den Hilfe-Dialog anzeigen.

/help

Tastenbelegung: ctrl+x h

init

Datei AGENTS.md erstellen oder aktualisieren. Mehr erfahren.

/init

Tastenbelegung: ctrl+x i

models

Verfugbare Modelle auflisten.

/models

Tastenbelegung: ctrl+x m

new

Eine neue Sitzung starten. Alias: /clear

/new

Tastenbelegung: ctrl+x n

redo

Eine zuvor ruckgangig gemachte Nachricht wiederherstellen. Nur nach Verwendung von /undo verfugbar.

Intern wird Git verwendet, um die Anderungen an Dateien zu verwalten. Daher muss Ihr Projekt ein Git-Repository sein.

/redo

Tastenbelegung: ctrl+x r

sessions

Sitzungen auflisten und zwischen ihnen wechseln. Aliase: /resume, /continue

/sessions

Tastenbelegung: ctrl+x l

share

Aktuelle Sitzung freigeben. Mehr erfahren.

/share

Tastenbelegung: ctrl+x s

themes

Verfugbare Themes auflisten.

/theme

Tastenbelegung: ctrl+x t

undo

Letzte Nachricht in der Unterhaltung ruckgangig machen. Entfernt die neueste Benutzernachricht, alle nachfolgenden Antworten und alle Dateianderungen.

Intern wird Git verwendet, um die Anderungen an Dateien zu verwalten. Daher muss Ihr Projekt ein Git-Repository sein.

/undo

Tastenbelegung: ctrl+x u

unshare

Freigabe der aktuellen Sitzung aufheben. Mehr erfahren.

/unshare

Editor-Einrichtung

Sowohl die Befehle /editor als auch /export verwenden den in Ihrer EDITOR-Umgebungsvariablen angegebenen Editor.

Terminal-Fenster
# Beispiel fur nano oder vim
export EDITOR=nano
export EDITOR=vim


# Fur GUI-Editoren, VS Code, Cursor, VSCodium, Windsurf, Zed, usw.
# --wait einschließen
export EDITOR="code --wait"

Um es dauerhaft zu machen, fugen Sie es zu Ihrem Shell-Profil hinzu; ~/.bashrc, ~/.zshrc, usw.

Beliebte Editor-Optionen sind:

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Neovim-Editor
  • vim - Vim-Editor
  • nano - Nano-Editor
  • notepad - Windows-Editor
  • subl - Sublime Text

Einige Editoren benotigen Befehlszeilenargumente, um im Blockiermodus zu laufen. Das --wait-Flag sorgt dafur, dass der Editor-Prozess blockiert, bis er geschlossen wird.

Konfigurieren

Sie konnen das TUI-Verhalten uber Ihre OpenCode-Konfigurationsdatei anpassen.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "tui": {
    "scroll_speed": 3,
    "scroll_acceleration": {
      "enabled": true
    }
  }
}

Optionen

  • scroll_acceleration - macOS-artige Scroll-Beschleunigung fur reibungsloses, naturliches Scrollen aktivieren. Wenn aktiviert, nimmt die Scroll-Geschwindigkeit mit schnellen Scroll-Bewegungen zu und bleibt bei langsameren Bewegungen prazise. Diese Einstellung hat Vorrang vor scroll_speed und uberschreibt sie, wenn sie aktiviert ist.
  • scroll_speed - Steuert, wie schnell die TUI beim Verwenden von Scroll-Befehlen scrollt (Minimum: 1). Standardmafig 1 unter Unix und 3 unter Windows. Hinweis: Dies wird ignoriert, wenn scroll_acceleration.enabled auf true gesetzt ist.

Anpassung

Sie konnen verschiedene Aspekte der TUI-Ansicht mit der Befehlspalette (ctrl+x h oder /help) anpassen. Diese Einstellungen bleiben uber Neustarts hinweg erhalten.

Benutzernamen-Anzeige

Umschalten, ob Ihr Benutzername in Chat-Nachrichten angezeigt wird. Zugriff darauf erfolgt uber:

  • Befehlspalette: Suchen Sie nach “username” oder “hide username”
  • Die Einstellung wird automatisch gespeichert und wird zwischen TUI-Sitzungen hinweg gemerkt