Zum Inhalt springen
V1-Doku
Erste Schritte

Web

OpenCode kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet das gleiche leistungsstarke KI-Codierungserlebnis, ohne dass ein Terminal erforderlich ist.

OpenCode Web – Neue Sitzung

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

Terminal
opencode web

Dadurch wird ein lokaler Server auf 127.0.0.1 mit einem zufällig verfügbaren Port gestartet und OpenCode automatisch in Ihrem Standardbrowser geöffnet.

Sie können den Webserver mithilfe von Befehlszeilen-Flags oder in Ihrer Konfigurationsdatei konfigurieren.

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

Terminal
opencode web --port 4096

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

Terminal
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

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

Terminal
opencode web --mdns

Dadurch wird der Hostname automatisch auf 0.0.0.0 gesetzt und der Server als opencode.local angekündigt.

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

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

So erlauben Sie zusätzliche Domänen für CORS (nützlich für benutzerdefinierte Frontends):

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

Um den Zugriff zu schützen, legen Sie mithilfe der Umgebungsvariablen OPENCODE_SERVER_PASSWORD ein Passwort fest:

Terminal
OPENCODE_SERVER_PASSWORD=secret opencode web

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

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

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

OpenCode Web – Aktive Sitzung

Klicken Sie auf „Server anzeigen“, um verbundene Server und deren Status anzuzeigen.

OpenCode Web – Siehe Server

Sie können eine Terminal-TUI an einen laufenden Webserver anschließen:

Terminal
# 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.

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

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

Befehlszeilenflags haben Vorrang vor Konfigurationsdateieinstellungen.