Deutsch
Dokumentation
Web

Web

OpenCode im Browser verwenden.

OpenCode kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet dieselbe leistungsstarke KI-Coding-Erfahrung, ohne dass ein Terminal benötigt wird.

OpenCode Web - Neue Sitzung

Erste Schritte

Starten Sie die Weboberfläche, indem Sie Folgendes ausführen:

opencode web

Dies startet einen lokalen Server auf 127.0.0.1 mit einem zufällig verfügbaren Port und öffnet OpenCode automatisch in Ihrem Standardbrowser.

Achtung: Wenn OPENCODE_SERVER_PASSWORD nicht gesetzt ist, ist der Server ungesichert. Dies ist für die lokale Nutzung in Ordnung, sollte aber für den Netzwerkzugriff gesetzt werden.

Tipp: Für die beste Erfahrung führen Sie opencode web aus WSL statt aus PowerShell aus. Dies gewährleistet einen ordnungsgemäßen Dateisystemzugriff und eine Terminal-Integration.

Konfiguration

Sie können den Webserver über Befehlszeilen-Flags oder in Ihrer Konfigurationsdatei konfigurieren.

Port

Standardmäßig wählt OpenCode einen verfügbaren Port. Sie können einen Port angeben:

opencode web --port 4096

Hostname

Standardmäßig bindet sich der Server an 127.0.0.1 (nur localhost). Um OpenCode in Ihrem Netzwerk zugänglich zu machen:

opencode web --hostname 0.0.0.0

Bei Verwendung von 0.0.0.0 zeigt OpenCode sowohl lokale als auch Netzwerkadressen an:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

mDNS-Erkennung

Aktivieren Sie mDNS, um Ihren Server im lokalen Netzwerk auffindbar zu machen:

opencode web --mdns

Dies setzt den Hostnamen automatisch auf 0.0.0.0 und bewirbt den Server als opencode.local.

Sie können den mDNS-Domainnamen anpassen, um mehrere Instanzen im selben Netzwerk auszuführen:

opencode web --mdns --mdns-domain myproject.local

CORS

Um zusätzliche Domains für CORS zuzulassen (nützlich für benutzerdefinierte Frontends):

opencode web --cors https://example.com

Authentifizierung

Um den Zugriff zu schützen, setzen Sie ein Passwort über die Umgebungsvariable OPENCODE_SERVER_PASSWORD:

OPENCODE_SERVER_PASSWORD=secret opencode web

Der Benutzername ist standardmäßig opencode, kann aber mit OPENCODE_SERVER_USERNAME geändert werden.

Verwendung der Weboberfläche

Nach dem Start bietet die Weboberfläche Zugriff auf Ihre OpenCode-Sitzungen.

Sitzungen

Zeigen Sie Ihre Sitzungen von der Startseite aus an und verwalten Sie sie. Sie können aktive Sitzungen sehen und neue starten.

OpenCode Web - Aktive Sitzung

Serverstatus

Klicken Sie auf "See Servers", um verbundene Server und ihren Status anzuzeigen.

OpenCode Web - See Servers

Ein Terminal anhängen

Sie können ein Terminal-TUI an einen laufenden Webserver anhängen:

# Start the web server
opencode web --port 4096
 
# In another terminal, attach the TUI
opencode attach http://localhost:4096

Dadurch können Sie sowohl die Weboberfläche als auch das Terminal gleichzeitig verwenden und dieselben Sitzungen und denselben Status teilen.

Konfigurationsdatei

Sie können die Servereinstellungen auch in Ihrer opencode.json-Konfigurationsdatei konfigurieren:

{
  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true,
    "cors": ["https://example.com"]
  }
}

Befehlszeilen-Flags haben Vorrang vor den Einstellungen der Konfigurationsdatei.

CLIIDE