OpenCode CLI-Nutzung

OpenCode bietet eine leistungsstarke Befehlszeilenschnittstelle (CLI). Sie kann nicht nur die interaktive TUI starten, sondern auch automatisierte und skriptgesteuerte Vorgänge über Befehle ausführen.

Standardmäßig startet die OpenCode CLI die TUI, doch ihre wahre Stärke liegt im programmierbaren Aufruf.

Die OpenCode CLI ist nicht nur ein Befehlswerkzeug; sie ist eine programmierbare KI-Entwicklungsschnittstelle.

Die OpenCode CLI lässt sich in drei Schichten abstrahieren:

  • Interaktionsschicht：tui / web / attach
  • Ausführungsschicht：run / agent / mcp / github
  • Service-Schicht：serve / acp

👉 Im Wesentlichen ist esKI-Agent + lokale Entwicklungsumgebung + programmierbare CLI + Server-APIein einheitlicher Einstiegspunkt.

Im Folgenden finden Sie die vollständige Befehlstabelle der OpenCode CLI:

Grundverhalten

Befehl/Verwendung Beschreibung Hinweise
opencode TUI standardmäßig starten Wenn keine Parameter angegeben werden
opencode run "msg" Aufgaben nicht-interaktiv ausführen Automatisierung/Skripting

TUI-Startparameter

Flag Short Beschreibung
--continue -c Vorherige Sitzung fortsetzen
--session -s Sitzungs-ID angeben
--fork — Sitzung forken
--prompt — Initial-Prompt
--model -m Modell angeben
--agent — Agent angeben
--port — Listen-Port
--hostname — Host-Adresse

Zentrale CLI-Befehle

Befehl Beschreibung Wichtige Unterbefehle
agent Agenten verwalten create / list
auth Authentifizierung verwalten login / list / logout
attach Verbindung zum Remote-Backend herstellen —
github GitHub-Automatisierung install / run
mcp MCP-Dienstverwaltung add / list / auth / debug
models Modellliste anzeigen —
run Nicht-interaktive Ausführung —
serve API-Dienst starten —
web Web-UI-Dienst —
session Sitzungsverwaltung Liste
stats Token-/Kostenstatistiken —
export Sitzungen exportieren —
import Sitzungen importieren —
acp ACP-Protokolldienst starten —
uninstall Deinstallieren —
upgrade Version aktualisieren —

Parameter des run-Befehls

Flag Short Beschreibung
--continue -c Sitzung fortsetzen
--session -s Sitzung angeben
--fork — Fork
--share — Sitzung teilen
--model -m Modell angeben
--agent — Agent angeben
--file -f Dateien anhängen
--format — Ausgabeformat (json)
--title — Sitzungstitel
--attach — Mit vorhandenem Dienst verbinden
--port — Lokaler Port

Dienstbefehlsparameter

serve / web / acp

Flag Beschreibung
--port Listen-Port
--hostname Host-Adresse
--mdns LAN-Erkennung
--cors Cross-Origin zulassen

session / stats-Parameter
Befehl Flag Beschreibung
session --max-count (-n) Letzte N Einträge
session --format table/json
stats --days Letzte N Tage
stats --tools Tool-Statistiken
stats --models Modellnutzung
stats --project Projektfilter

Globale Flags

Flag Short Beschreibung
--help -h Hilfe
--version -v Version
--print-logs — Ausgabeprotokoll
--log-level — Log-Level

Umgebungsvariablen

Variable Type Zweck
OPENCODE_AUTO_SHARE boolesch Automatisch teilen
OPENCODE_CONFIG string Konfigurationspfad
OPENCODE_TUI_CONFIG string TUI-Konfiguration
OPENCODE_DISABLE_AUTOUPDATE boolesch Updates deaktivieren
OPENCODE_SERVER_PASSWORD string API-Authentifizierung
OPENCODE_MODELS_URL string Modellquelle

Experimentelle Funktionen

Variable Type Zweck
OPENCODE_EXPERIMENTAL boolesch Alle experimentellen Funktionen aktivieren
OPENCODE_EXPERIMENTAL_LSP_TOOL boolesch LSP-Tools
OPENCODE_EXPERIMENTAL_PLAN_MODE boolesch Planungsmodus
OPENCODE_EXPERIMENTAL_FILEWATCHER boolesch Dateiüberwachung

I. Grundlegende Verwendung

1. TUI starten (Standardverhalten)

opencode

Entspricht dem Aufrufen der interaktiven Terminal-Schnittstelle

2. Projektverzeichnis angeben

opencode /path/to/project

Starten Sie die TUI im angegebenen Verzeichnis, zum Beispiel im Verzeichnis opencode-example-test:

opencode opencode-example-test

3. Nicht-interaktiver Modus (Skriptaufruf)

opencode run 解释一下 JavaScript 中闭包的原理

Gibt Ergebnisse direkt zurück, ohne die Oberfläche zu betreten.

II. Kernfunktionen der CLI

Die Kernfunktionen der OpenCode CLI lassen sich in drei Kategorien zusammenfassen:

  • Interaktiver Modus:TUI (Standard)
  • Befehlsausführung:run / serve
  • Systemverwaltung:agent / auth / session, usw.

III. Gängige Parameter (Flags)

Parameter Short Beschreibung
--continue -c Vorherige Sitzung fortsetzen
--session -s Sitzungs-ID angeben
--fork Von der aktuellen Sitzung forken
--model -m Modell angeben (provider/model)
--agent Agent angeben
--port Dienstport
--hostname Listen-Adresse

IV. Details der Kernbefehle

1. run (am häufigsten verwendet)

Wird für nicht interaktive Ausführung verwendet:

opencode run 分析这个 Go 项目的上下文使用方式

Anwendbare Szenarien:

  • Skript-Automatisierung
  • CI/CD
  • Schnelle Fragen und Antworten

Mit einem Hintergrunddienst verbinden (Kaltstart vermeiden)

# 启动后台服务
opencode serve

# 使用 run 连接
opencode run --attach http://localhost:4096 解释 async/await

Allgemeine Parameter

Parameter Beschreibung
--model Modell angeben
--file Dateien anhängen
--format Ausgabeformat (json / default)
--share Sitzung teilen

V. auth (Authentifizierungsverwaltung)

Anmelden

opencode auth login

API-Schlüssel konfigurieren (lokal gespeichert)

Angemeldete Anbieter anzeigen

opencode auth list

Abmelden

opencode auth logout

VI. models (Modellverwaltung)

Alle Modelle anzeigen

opencode models

Nach Anbieter filtern

opencode models anthropic

Modellliste aktualisieren

opencode models --refresh

VII. agent (Agentensystem)

Agent erstellen

opencode agent create

Anpassbare Prompts + Tools

Agenten anzeigen

opencode agent list

VIII. session (Sitzungsverwaltung)

Sitzungen anzeigen

opencode session list

Anzahl begrenzen

opencode session list -n 10

IX. serve (Dienstmodus)

API-Dienst starten:

opencode serve

Bietet HTTP-Schnittstelle (keine UI)

Optionale Parameter:

  • --port: Port
  • --hostname: Abhöradresse

X. web (Web-UI)

opencode web

Version mit Web-Oberfläche starten

XI. mcp (Erweiterungsfähigkeit)

MCP-Dienst hinzufügen

opencode mcp add

Liste anzeigen

opencode mcp list

MCP wird verwendet, um KI-Fähigkeiten zu erweitern (z. B. Tool-Aufrufe)

XII. Statistiken (Nutzungsstatistiken)

opencode stats

Token-Nutzung und Kosten anzeigen

XIII. Export / Import

Sitzungen exportieren

opencode export

Sitzungen importieren

opencode import session.json

XIV. Upgrade und Deinstallation

Upgrade

opencode upgrade

Deinstallieren

opencode uninstall

XV. Globale Parameter

Parameter Beschreibung
--help Hilfe anzeigen
--version Version anzeigen
--log-level Log-Level

XVI. Umgebungsvariablen (erweiterte Konfiguration)

OpenCode unterstützt die Steuerung des Verhaltens über Umgebungsvariablen, zum Beispiel:

OPENCODE_DISABLE_AUTOUPDATE=true
OPENCODE_SERVER_PASSWORD=123456

Häufige Verwendungen:

  • Automatische Updates deaktivieren
  • Dienstauthentifizierung konfigurieren
  • Benutzerdefinierter Konfigurationspfad

XVII. Nutzungsempfehlungen (Kernpunkte)

  • TUI für die tägliche Entwicklung verwenden
  • run zur Automatisierung verwenden
  • agent für komplexe Aufgaben kombinieren
  • serve + attach für hochfrequente Aufrufe verwenden
Weitere Erweiterungen