CLI

Der OpenCode CLI startet standardmäßig das TUI, wenn er ohne Argumente ausgeführt wird.

Terminal

opencode

Es akzeptiert aber auch Befehle, wie auf dieser Seite dokumentiert. Dadurch können Sie programmgesteuert mit OpenCode interagieren.

Terminal

opencode run "Explain how closures work in JavaScript"

Starten Sie die Terminalbenutzeroberfläche OpenCode.

Terminal

opencode [project]

Optionen

Flag	Kurz	Beschreibung
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session`)
`--prompt`		Prompt zur Verwendung
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--port`		Port zum Abhören
`--hostname`		Hostname zum Abhören

Der OpenCode CLI verfügt außerdem über die folgenden Befehle.

Schließen Sie ein Terminal an einen bereits laufenden OpenCode-Backend-Server an, der über die Befehle serve oder web gestartet wurde.

Terminal

opencode attach [url]

Dies ermöglicht die Verwendung von TUI mit einem Remote-Backend OpenCode. Zum Beispiel:

Terminal

# Start the backend server for web/mobile access
opencode web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
opencode attach http://10.20.30.40:4096

Optionen

Flag	Kurz	Beschreibung
`--dir`		Arbeitsverzeichnis zum Starten von TUI in
`--continue`	`-c`	Letzte Sitzung fortsetzen
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen abzweigen (mit `--continue` oder `--session` verwenden)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `OPENCODE_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `OPENCODE_SERVER_USERNAME` oder `opencode`)

Befehl zum Verwalten von Anmeldeinformationen und Anmelden für Anbieter.

Terminal

opencode auth [command]

OpenCode wird von der Anbieterliste bei Models.dev unterstützt, sodass Sie opencode auth login verwenden können, um API-Schlüssel für jeden Anbieter zu konfigurieren, den Sie verwenden möchten. Dies wird in ~/.local/share/opencode/auth.json gespeichert.

Terminal

opencode auth login

Wenn OpenCode startet, lädt es den Anbieter aus der Anmeldeinformationsdatei. Und ob in Ihren Umgebungen Schlüssel sind oder in Ihrem Projekt eine .env-Datei vorhanden ist.

list

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

Terminal

opencode auth list

Oder die Kurzversion.

Terminal

opencode auth ls

logout

Melden Sie sich von einem Anbieter ab, indem Sie ihn aus der Anmeldeinformationsdatei löschen.

Terminal

opencode auth logout

Verwalten Sie den GitHub-Agenten für die Repository-Automatisierung.

Terminal

opencode github [command]

install

Installieren Sie den GitHub-Agenten in Ihrem Repository.

Terminal

opencode github install

Dadurch wird der erforderliche GitHub-Aktionsworkflow eingerichtet und Sie durch den Konfigurationsprozess geführt. Learn more.

run

Führen Sie den GitHub-Agenten aus. Dies wird normalerweise in GitHub-Aktionen verwendet.

Terminal

opencode github run

Optionen

Flag	Beschreibung
`--event`	GitHub Scheinereignis zum Ausführen des Agenten für
`--token`	GitHub persönliches Zugriffstoken

Verwalten Sie Model Context Protocol-Server.

Terminal

opencode mcp [command]

add

Fügen Sie Ihrer Konfiguration einen MCP-Server hinzu.

Terminal

opencode mcp add

Dieser Befehl führt Sie durch das Hinzufügen eines lokalen oder Remote-MCP-Servers.

list

Listen Sie alle konfigurierten MCP-Server und deren Verbindungsstatus auf.

Terminal

opencode mcp list

Oder nutzen Sie die Kurzversion.

Terminal

opencode mcp ls

auth

Authentifizieren Sie sich mit einem OAuth-fähigen MCP-Server.

Terminal

opencode mcp auth [name]

Wenn Sie keinen Servernamen angeben, werden Sie aufgefordert, einen der verfügbaren OAuth-fähigen Server auszuwählen.

Sie können auch OAuth-fähige Server und deren Authentifizierungsstatus auflisten.

Terminal

opencode mcp auth list

Oder nutzen Sie die Kurzversion.

Terminal

opencode mcp auth ls

logout

Entfernen Sie OAuth-Anmeldeinformationen für einen MCP-Server.

Terminal

opencode mcp logout [name]

debug

Beheben Sie OAuth-Verbindungsprobleme für einen MCP-Server.

Terminal

opencode mcp debug <name>

Listen Sie alle verfügbaren Modelle der konfigurierten Anbieter auf.

Terminal

opencode models [provider]

Dieser Befehl zeigt alle bei Ihren konfigurierten Anbietern verfügbaren Modelle im Format provider/model an.

Dies ist nützlich, um die genauen Modellnamen herauszufinden, die in Ihrer Konfiguration verwendet werden sollen.

Sie können optional eine Anbieter-ID übergeben, um Modelle nach diesem Anbieter zu filtern.

Terminal

opencode models anthropic

Optionen

Flag	Beschreibung
`--refresh`	Aktualisieren Sie den Modellcache von models.dev
`--verbose`	Verwenden Sie eine ausführlichere Modellausgabe (einschließlich Metadaten wie Kosten)

Verwenden Sie das Flag --refresh, um die zwischengespeicherte Modellliste zu aktualisieren. Dies ist nützlich, wenn einem Anbieter neue Modelle hinzugefügt wurden und Sie diese in OpenCode sehen möchten.

Terminal

opencode models --refresh

Führen Sie OpenCode im nicht interaktiven Modus aus, indem Sie direkt eine Eingabeaufforderung übergeben.

Terminal

opencode run [message..]

Dies ist nützlich für die Skripterstellung, die Automatisierung oder wenn Sie eine schnelle Antwort wünschen, ohne das vollständige TUI zu starten. Zum Beispiel:

Terminal

opencode run Explain the use of context in Go

Sie können auch eine Verbindung zu einer laufenden opencode serve-Instanz herstellen, um bei jedem Lauf Kaltstartzeiten für den MCP-Server zu vermeiden:

Terminal

# Start a headless server in one terminal
opencode serve

# In another terminal, run commands that attach to it
opencode run --attach http://localhost:4096 "Explain async/await in JavaScript"

Optionen

Flag	Kurz	Beschreibung
`--command`		Der auszuführende Befehl, Argumente als Nachricht verwenden
`--continue`	`-c`	Setzen Sie die letzte Sitzung fort
`--session`	`-s`	Session-ID zum Fortfahren
`--fork`		Sitzung beim Fortsetzen verzweigen (mit `--continue` oder `--session` verwenden)
`--model`	`-m`	Zu verwendendes Modell in der Form provider/model
`--agent`		Zu verwendender Agent
`--file`	`-f`	Datei(en) zum Anhängen an die Nachricht
`--format`		Format: default (formatiert) oder json (rohe JSON-Ereignisse)
`--title`		Titel für die Sitzung (verwendet eine verkürzte Eingabeaufforderung, wenn kein Wert angegeben wird)
`--attach`		An einen laufenden OpenCode-Server anschließen (z.B. http://localhost:4096)
`--password`	`-p`	Basic-Auth-Passwort (standardmäßig `OPENCODE_SERVER_PASSWORD`)
`--username`	`-u`	Basic-Auth-Benutzername (standardmäßig `OPENCODE_SERVER_USERNAME` oder `opencode`)
`--dir`		Verzeichnis für die Ausführung, oder Pfad auf dem Remote-Server beim Anhängen
`--variant`		Modellvariante (anbieterspezifischer Reasoning-Aufwand)
`--thinking`		Denkblöcke anzeigen
`--port`		Port für den lokalen Server (standardmäßig zufälliger Port)

Starten Sie einen Headless-OpenCode-Server für den API-Zugriff. Sehen Sie sich die Server-Dokumentation für die vollständige HTTP-Schnittstelle an.

Terminal

opencode serve

Dadurch wird ein HTTP-Server gestartet, der API-Zugriff auf OpenCode-Funktionalität ohne die TUI-Schnittstelle bietet. Legen Sie OPENCODE_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig opencode).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

OpenCode-Sitzungen verwalten.

Terminal

opencode session [command]

list

Listen Sie alle OpenCode-Sitzungen auf.

Terminal

opencode session list

Optionen

Flag	Kurz	Beschreibung
`--max-count`	`-n`	Beschränken auf die N neuesten Sitzungen
`--format`		Ausgabeformat: table oder json (table)

Zeigen Sie Token-Nutzungs- und Kostenstatistiken für Ihre OpenCode-Sitzungen an.

Terminal

opencode stats

Optionen

Flag	Beschreibung
`--days`	Statistiken für die letzten N Tage anzeigen (alle Zeiten)
`--tools`	Anzahl der angebotenen Werkzeuge (alle)
`--models`	Aufschlüsselung der Modellnutzung anzeigen (standardmäßig ausgeblendet). Übergeben Sie eine Zahl, um die obersten N anzuzeigen
`--project`	Nach Projekt filtern (alle Projekte, leere Zeichenfolge: aktuelles Projekt)

Sitzungsdaten als JSON exportieren.

Terminal

opencode export [sessionID]

Wenn Sie keine Sitzungs-ID angeben, werden Sie aufgefordert, eine der verfügbaren Sitzungen auszuwählen.

Importieren Sie Sitzungsdaten aus einer JSON-Datei.

Terminal

opencode import <file>

Terminal

opencode import session.json

Starten Sie einen Headless-OpenCode-Server mit einer Weboberfläche.

Terminal

opencode web

Dadurch wird ein HTTP-Server gestartet und ein Webbrowser geöffnet, um über eine Webschnittstelle auf OpenCode zuzugreifen. Legen Sie OPENCODE_SERVER_PASSWORD fest, um die HTTP-Basisauthentifizierung zu aktivieren (Benutzername ist standardmäßig opencode).

Optionen

Flag	Beschreibung
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören
`--mdns`	mDNS-Discovery aktivieren
`--cors`	Zusätzliche Browser-Ursprünge für CORS zulassen

Starten Sie einen ACP (Agent Client Protocol) Server.

Terminal

opencode acp

Dieser Befehl startet einen ACP-Server, der über stdin/stdout unter Verwendung von nd-JSON kommuniziert.

Optionen

Flag	Beschreibung
`--cwd`	Arbeitsverzeichnis
`--port`	Port zum Abhören
`--hostname`	Hostname zum Abhören

Deinstallieren Sie OpenCode und entfernen Sie alle zugehörigen Dateien.

Terminal

opencode uninstall

Optionen

Flag	Kurz	Beschreibung
`--keep-config`	`-c`	Konfigurationsdateien behalten
`--keep-data`	`-d`	Sitzungsdaten und Snapshots aufbewahren
`--dry-run`		Zeigt, was entfernt werden würde, ohne zu entfernen
`--force`	`-f`	Bestätigungsaufforderungen überspringen

Aktualisiert OpenCode auf die neueste Version oder eine bestimmte Version.

Terminal

opencode upgrade [target]

Um auf die neueste Version zu aktualisieren:

Terminal

opencode upgrade

Um auf eine bestimmte Version zu aktualisieren.

Terminal

opencode upgrade v0.1.48

Optionen

Flag	Kurz	Beschreibung
`--method`	`-m`	Die zu verwendende Installationsmethode; curl, npm, pnpm, bun, brew

Der OpenCode CLI akzeptiert die folgenden globalen Flags.

Flag	Kurz	Beschreibung
`--help`	`-h`	Hilfe anzeigen
`--version`	`-v`	Versionsnummer drucken
`--print-logs`		Protokolle nach stderr drucken
`--log-level`		Protokollebene (DEBUG, INFO, WARN, ERROR)

OpenCode kann mithilfe von Umgebungsvariablen konfiguriert werden.

Variable	Typ	Beschreibung
`OPENCODE_GIT_BASH_PATH`	Zeichenfolge	Pfad zur ausführbaren Git Bash-Datei unter Windows
`OPENCODE_CONFIG`	Zeichenfolge	Pfad zur Konfigurationsdatei
`OPENCODE_CONFIG_DIR`	Zeichenfolge	Pfad zum Konfigurationsverzeichnis
`OPENCODE_CONFIG_CONTENT`	Zeichenfolge	Inline-JSON-Konfigurationsinhalt
`OPENCODE_DISABLE_AUTOUPDATE`	boolescher Wert	Automatische Update-Prüfungen deaktivieren
`OPENCODE_DISABLE_PRUNE`	boolescher Wert	Bereinigung alter Daten deaktivieren
`OPENCODE_DISABLE_TERMINAL_TITLE`	boolescher Wert	Deaktivieren Sie die automatische Aktualisierung von Terminaltiteln
`OPENCODE_PERMISSION`	Zeichenfolge	Inline-JSON-Berechtigungskonfiguration
`OPENCODE_DISABLE_DEFAULT_PLUGINS`	boolescher Wert	Standard-Plugins deaktivieren
`OPENCODE_DISABLE_LSP_DOWNLOAD`	boolescher Wert	Automatische LSP-Server-Downloads deaktivieren
`OPENCODE_ENABLE_EXPERIMENTAL_MODELS`	boolescher Wert	Experimentelle Modelle aktivieren
`OPENCODE_DISABLE_AUTOCOMPACT`	boolescher Wert	Automatische Kontextkomprimierung deaktivieren
`OPENCODE_DISABLE_CLAUDE_CODE`	boolescher Wert	Deaktivieren Sie das Lesen von `.claude` (Prompt + Skills)
`OPENCODE_DISABLE_CLAUDE_CODE_PROMPT`	boolescher Wert	Deaktivieren Sie das Lesen von `~/.claude/CLAUDE.md`
`OPENCODE_DISABLE_CLAUDE_CODE_SKILLS`	boolescher Wert	Deaktivieren Sie das Laden von `.claude/skills`
`OPENCODE_DISABLE_MODELS_FETCH`	boolescher Wert	Deaktivieren Sie das Abrufen von Modellen aus Remote-Quellen
`OPENCODE_FAKE_VCS`	Zeichenfolge	Gefälschter VCS-Anbieter zu Testzwecken
`OPENCODE_CLIENT`	Zeichenfolge	Client-ID (standardmäßig `cli`)
`OPENCODE_ENABLE_EXA`	boolescher Wert	Exa-Websuchtools aktivieren
`OPENCODE_SERVER_PASSWORD`	Zeichenfolge	Aktivieren Sie die Basisauthentifizierung für `serve`/`web`
`OPENCODE_SERVER_USERNAME`	Zeichenfolge	Benutzernamen für die Basisauthentifizierung überschreiben (Standard `opencode`)
`OPENCODE_MODELS_URL`	Zeichenfolge	Benutzerdefinierte URL zum Abrufen der Modellkonfiguration

Diese Umgebungsvariablen ermöglichen experimentelle Funktionen, die sich ändern oder entfernt werden können.

Variable	Typ	Beschreibung
`OPENCODE_EXPERIMENTAL`	boolescher Wert	Experimentelle Funktionen unter dem Sammelflag aktivieren
`OPENCODE_EXPERIMENTAL_ICON_DISCOVERY`	boolescher Wert	Symbolerkennung aktivieren
`OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolescher Wert	Kopieren bei Auswahl in TUI deaktivieren
`OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	Zahl	Standard-Timeout für Bash-Befehle in ms
`OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	Zahl	Maximale Ausgabetokens für LLM-Antworten
`OPENCODE_EXPERIMENTAL_FILEWATCHER`	boolescher Wert	Dateiüberwachung für das gesamte Verzeichnis aktivieren
`OPENCODE_EXPERIMENTAL_OXFMT`	boolescher Wert	Oxfmt-Formatierer aktivieren
`OPENCODE_EXPERIMENTAL_LSP_TOOL`	boolescher Wert	Experimentelles LSP-Tool aktivieren
`OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolescher Wert	Dateiüberwachung deaktivieren
`OPENCODE_EXPERIMENTAL_EXA`	boolescher Wert	Experimentelle Exa-Funktionen aktivieren
`OPENCODE_EXPERIMENTAL_LSP_TY`	boolescher Wert	TY LSP für Python-Dateien aktivieren
`OPENCODE_EXPERIMENTAL_PLAN_MODE`	boolescher Wert	Planmodus aktivieren
`OPENCODE_EXPERIMENTAL_EVENT_SYSTEM`	boolescher Wert	Experimentelles Ereignissystem aktivieren
`OPENCODE_EXPERIMENTAL_NATIVE_LLM`	boolescher Wert	Nativen LLM-Anfragepfad aktivieren
`OPENCODE_EXPERIMENTAL_PARALLEL`	boolescher Wert	Parallele Websuche aktivieren
`OPENCODE_EXPERIMENTAL_SCOUT`	boolescher Wert	Scout-Subagent aktivieren
`OPENCODE_EXPERIMENTAL_WORKSPACES`	boolescher Wert	Workspace-Unterstützung aktivieren

CLI

tui

Optionen

Befehle

attach

Optionen

auth

login

list

logout

github

install

run

Optionen

mcp

add

list

auth

logout

debug

models

Optionen

run

Optionen

serve

Optionen

session

list

Optionen

stats

Optionen

export

import

web

Optionen

acp

Optionen

uninstall

Optionen

upgrade

Optionen

Globale Flags

Umgebungsvariablen

Experimentell