CLI

OpenCode-CLI-Optionen und -Befehle.

Die OpenCode-CLI startet standardmafig die TUI, wenn sie ohne Argumente ausgefuhrt wird.

opencode

Aber sie akzeptiert auch Befehle wie auf dieser Seite dokumentiert. Dies ermoglicht es Ihnen, programmgesteuert mit OpenCode zu interagieren.

opencode run "Explain how closures work in JavaScript"

tui

Die OpenCode-Terminal-Benutzeroberflache starten.

opencode [project]

Flags

Flag	Kurz	Description
`--continue`	`-c`	Letzte Sitzung fortsetzen
`--session`	`-s`	Sitzungs-ID zum Fortsetzen
`--prompt`		Zu verwendender Prompt
`--model`	`-m`	Zu verwendendes Modell in der Form anbieter/modell
`--agent`		Zu verwendender Agent
`--port`		Port fur den Listener
`--hostname`		Hostname fur den Listener

Befehle

Die OpenCode-CLI hat auch die folgenden Befehle.

agent

Agenten fur OpenCode verwalten.

opencode agent [command]

attach

Ein Terminal an einen bereits laufenden OpenCode-Backend-Server andocken, der uber serve- oder web-Befehle gestartet wurde.

opencode attach [url]

Dies ermoglicht die Verwendung der TUI mit einem entfernten OpenCode-Backend. Zum Beispiel:

# Den Backend-Server fur Web/Mobil-Zugriff starten
opencode web --port 4096 --hostname 0.0.0.0

# In einem anderen Terminal die TUI an den laufenden Backend andocken
opencode attach http://10.20.30.40:4096

Flags

Flag	Kurz	Description
`--dir`		Arbeitsverzeichnis zum Starten der TUI darin
`--session`	`-s`	Sitzungs-ID zum Fortsetzen

create

Einen neuen Agenten mit benutzerdefinierter Konfiguration erstellen.

opencode agent create

Dieser Befehl fuhrt Sie durch die Erstellung eines neuen Agenten mit einem benutzerdefinierten System-Prompt und einer Tool-Konfiguration.

list

Alle verfugbaren Agenten auflisten.

opencode agent list

auth

Befehl zum Verwalten von Anmeldeinformationen und Anmeldung fur Anbieter.

opencode auth [command]

OpenCode wird von der Anbieterliste bei Models.dev gespeist, sodass Sie opencode auth login verwenden konnen, um API-Schlussel fur alle Anbieter zu konfigurieren, die Sie verwenden mochten. Dies wird in ~/.local/share/opencode/auth.json gespeichert.

opencode auth login

Wenn OpenCode startet, werden die Anbieter aus der Anmeldedatei geladen. Und wenn there are any keys defined in your environments or a .env file in your project.

list

Listet alle authentifizierten Anbieter auf, wie in der Anmeldedatei gespeichert.

opencode auth list

Oder die kurze Version.

opencode auth ls

logout

Meldet Sie von einem Anbieter ab, indem Sie ihn aus der Anmeldedatei entfernen.

opencode auth logout

github

Den GitHub-Agenten fur Repository-Automatisierung verwalten.

opencode github [command]

install

Den GitHub-Agenten in Ihrem Repository installieren.

opencode github install

Dies richtet den notwendigen GitHub Actions-Workflow ein und fuhrt Sie durch den Konfigurationsprozess. Mehr erfahren.

run

Den GitHub-Agenten ausfuhren. Dies wird typischerweise in GitHub Actions verwendet.

opencode github run

Flags

Flag	Description
`--event`	GitHub-Mock-Ereignis zum Ausfuhren des Agents fur
`--token`	GitHub-personlicher Zugriffsschlussel

mcp

Model Context Protocol-Server verwalten.

opencode mcp [command]

add

Einen MCP-Server zu Ihrer Konfiguration hinzufugen.

opencode mcp add

Dieser Befehl fuhrt Sie durch das Hinzufugen eines lokalen oder entfernten MCP-Servers.

list

Alle konfigurierten MCP-Server und deren Verbindungsstatus auflisten.

opencode mcp list

Oder verwenden Sie die kurze Version.

opencode mcp ls

auth

Sich bei einem OAuth-fahigen MCP-Server authentifizieren.

opencode mcp auth [name]

Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, aus verfugbaren OAuth-fahigen Servern auszuwahlen.

Sie konnen auch OAuth-fahige Server und deren Authentifizierungsstatus auflisten.

opencode mcp auth list

Oder verwenden Sie die kurze Version.

opencode mcp auth ls

logout

OAuth-Anmeldeinformationen fur einen MCP-Server entfernen.

opencode mcp logout [name]

debug

OAuth-Verbindungsprobleme fur einen MCP-Server debuggen.

opencode mcp debug <name>

models

Alle verfugbaren Modelle von konfigurierten Anbietern auflisten.

opencode models [provider]

Dieser Befehl zeigt alle Modelle an, die uber Ihre konfigurierten Anbieter verfugbar sind, im Format anbieter/modell.

Dies ist nutzlich, um den genauen Modellnamen fur die Verwendung in Ihrer Konfiguration herauszufinden.

Sie konnen optional eine Anbieter-ID eingeben, um Modelle nach diesem Anbieter zu filtern.

opencode models anthropic

Flags

Flag	Description
`--refresh`	Den Modell-Cache von models.dev aktualisieren
`--verbose`	Ausfuhrlichere Modellausgabe verwenden (enthalt Metadaten wie Kosten)

Verwenden Sie das --refresh-Flag, um die zwischengespeicherte Modellsuche zu aktualisieren. Dies ist nutzlich, wenn neue Modelle zu einem Anbieter hinzugefugt wurden und Sie sie in OpenCode sehen mochten.

opencode models --refresh

run

OpenCode im nicht-interaktiven Modus ausfuhren, indem Sie direkt einen Prompt eingeben.

opencode run [message..]

Dies ist nutzlich fur Skripte, Automatisierung oder wenn Sie eine schnelle Antwort mochten, ohne die vollstandige TUI zu starten. Zum Beispiel:

opencode run Explain the use of context in Go

Sie konnen sich auch an eine laufende opencode serve-Instanz andocken, um MCP-Server-Kaltstartzeiten bei jedem Lauf zu vermeiden:

# Einen Headless-Server in einem Terminal starten
opencode serve

# In einem anderen Terminal Befehle ausfuhren, die sich daran andocken
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Flags

Flag	Kurz	Description
`--command`		Der auszufuhrende Befehl, Nachricht fur Argumente verwenden
`--continue`	`-c`	Letzte Sitzung fortsetzen
`--session`	`-s`	Sitzungs-ID zum Fortsetzen
`--share`		Die Sitzung freigeben
`--model`	`-m`	Zu verwendendes Modell in der Form anbieter/modell
`--agent`		Zu verwendender Agent
`--file`	`-f`	An Nachricht anzufugende Datei(en)
`--format`		Format: default (formatiert) oder json (rohe JSON-Ereignisse)
`--title`		Titel fur die Sitzung (verwendet gekurzten Prompt, wenn kein Wert)
`--attach`		An einen laufenden opencode-Server andocken (z.B. http://localhost:4096)
`--port`		Port fur den lokalen Server (standardmafig zufalliger Port)

serve

Einen Headless-OpenCode-Server fur API-Zugriff starten. Schauen Sie sich die Server-Dokumentation fur die vollstandige HTTP-Schnittstelle an.

opencode serve

Dies startet einen HTTP-Server, der API-Zugriff auf opencode-Funktionen ohne die TUI-Schnittstelle bietet.

Flags

Flag	Description
`--port`	Port fur den Listener
`--hostname`	Hostname fur den Listener
`--mdns`	mDNS-Suche aktivieren
`--cors`	Zusatzliche Browser-Ursprunge fur CORS zulassen

session

OpenCode-Sitzungen verwalten.

opencode session [command]

list

Alle OpenCode-Sitzungen auflisten.

opencode session list

Flags

Flag	Kurz	Description
`--max-count`	`-n`	Auf die N neuesten Sitzungen beschranken
`--format`		Ausgabeformat: table oder json (table)

stats

Token-Verbrauch und Kostenstatistiken fur Ihre OpenCode-Sitzungen anzeigen.

opencode stats

Flags

Flag	Description
`--days`	Statistiken fur die letzten N Tage anzeigen (gesamte Zeit)
`--tools`	Anzahl der anzuzeigenden Tools (alle)
`--models`	Modell-Verbrauchs-Aufschlusselung anzeigen (standardmafig ausgeblendet). Zahl eingeben, um die Top N anzuzeigen
`--project`	Nach Projekt filtern (alle Projekte, leere Zeichenkette: aktuelles Projekt)

export

Sitzungsdaten als JSON exportieren.

opencode export [sessionID]

Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, aus verfugbaren Sitzungen auszuwahlen.

import

Sitzungsdaten aus einer JSON-Datei oder OpenCode-Freigabe-URL importieren.

opencode import <file>

Sie konnen aus einer lokalen Datei oder einer OpenCode-Freigabe-URL importieren.

opencode import session.json
opencode import https://opncd.ai/s/abc123

web

Einen Headless-OpenCode-Server mit einer Weboberflache starten.

opencode web

Dies startet einen HTTP-Server und offnet einen Webbrowser, um uber eine Weboberflache auf OpenCode zuzugreifen.

Flags

Flag	Description
`--port`	Port fur den Listener
`--hostname`	Hostname fur den Listener
`--mdns`	mDNS-Suche aktivieren
`--cors`	Zusatzliche Browser-Ursprunge fur CORS zulassen

acp

Einen ACP-Server (Agent Client Protocol) starten.

opencode acp

Dieser Befehl startet einen ACP-Server, der uber stdin/stdout mit nd-JSON kommuniziert.

Flags

Flag	Description
`--cwd`	Arbeitsverzeichnis
`--port`	Port fur den Listener
`--hostname`	Hostname fur den Listener

uninstall

OpenCode deinstallieren und alle zugehorigen Dateien entfernen.

opencode uninstall

Flags

Flag	Kurz	Description
`--keep-config`	`-c`	Konfigurationsdateien behalten
`--keep-data`	`-d`	Sitzungsdaten und Snapshots behalten
`--dry-run`		Anzeigen, was entfernt wurde, ohne zu entfernen
`--force`	`-f`	Bestatigungsabfragen uberspringen

upgrade

Opencode auf die neueste Version oder eine bestimmte Version aktualisieren.

opencode upgrade [target]

Um auf die neueste Version zu aktualisieren.

opencode upgrade

Um auf eine bestimmte Version zu aktualisieren.

opencode upgrade v0.1.48

Flags

Flag	Kurz	Description
`--method`	`-m`	Die verwendete Installationsmethode; curl, npm, pnpm, bun, brew

Globale Flags

Die opencode-CLI akzeptiert die folgenden globalen Flags.

Flag	Kurz	Description
`--help`	`-h`	Hilfe anzeigen
`--version`	`-v`	Versionsnummer anzeigen
`--print-logs`		Logs auf stderr ausgeben
`--log-level`		Log-Level (DEBUG, INFO, WARN, ERROR)

Umgebungsvariablen

OpenCode kann mithilfe von Umgebungsvariablen konfiguriert werden.

Variable	Typ	Description
`OPENCODE_AUTO_SHARE`	boolean	Sitzungen automatisch freigeben
`OPENCODE_GIT_BASH_PATH`	string	Pfad zur Git-Bash-ausfuhrbaren Datei unter Windows
`OPENCODE_CONFIG`	string	Pfad zur Konfigurationsdatei
`OPENCODE_CONFIG_DIR`	string	Pfad zum Konfigurationsverzeichnis
`OPENCODE_CONFIG_CONTENT`	string	Inline-json-Konfigurationsinhalt
`OPENCODE_DISABLE_AUTOUPDATE`	boolean	Automatische Update-Prufungen deaktivieren
`OPENCODE_DISABLE_PRUNE`	boolean	Bereinigung alter Daten deaktivieren
`OPENCODE_DISABLE_TERMINAL_TITLE`	boolean	Automatische Terminal-Titel-Updates deaktivieren
`OPENCODE_PERMISSION`	string	Inline-json-Berechtigungs-Konfiguration
`OPENCODE_DISABLE_DEFAULT_PLUGINS`	boolean	Standard-Plugins deaktivieren
`OPENCODE_DISABLE_LSP_DOWNLOAD`	boolean	Automatische LSP-Server-Downloads deaktivieren
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	boolean	Experimentelle Modelle aktivieren
`OPENCODE_DISABLE_AUTOCOMPACT`	boolean	Automatische Kontext-Komprimierung deaktivieren
`OPENCODE_DISABLE_CLAUDE_CODE`	boolean	Lesen von `.claude` deaktivieren (Prompt + Skills)
`OPENCODE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	Lesen von `~/.claude/CLAUDE.md` deaktivieren
`OPENCODE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	Laden von `.claude/skills` deaktivieren
`OPENCODE_CLIENT`	string	Client-Bezeichner (standardmafig `cli`)
`OPENCODE_ENABLE_EXA`	boolean	Exa-Web-Suche-Tools aktivieren

Experimentell

Diese Umgebungsvariablen aktivieren experimentelle Funktionen, die sich andern konnen oder entfernt werden.

Variable	Typ	Description
`OPENCODE_EXPERIMENTAL`	boolean	Alle experimentellen Funktionen aktivieren
`OPENCODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	Icon-Suche aktivieren
`OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Kopieren bei Auswahl in TUI deaktivieren
`OPENCODE_EXPERIMENTAL_BASH_MAX_OUTPUT_LENGTH`	number	Maximale Ausgabelange fur Bash-Befehle
`OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	Standard-Timeout fur Bash-Befehle in ms
`OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	Maximale Ausgabe-Tokens fur LLM-Antworten
`OPENCODE_EXPERIMENTAL_FILEWATCHER`	boolean	Dateiuberwachung fur gesamtes Verzeichnis aktivieren
`OPENCODE_EXPERIMENTAL_OXFMT`	boolean	Oxfmt-Formatierer aktivieren
`OPENCODE_EXPERIMENTAL_LSP_TOOL`	boolean	Experimentelles LSP-Tool aktivieren