Deutsch
Dokumentation
Web

Web

OpenCode in Ihrem Browser verwenden.

OpenCode kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet dieselbe leistungsstarke KI-Coding-Erfahrung ohne Terminal.

Erste Schritte

Starten Sie die Web-Oberfläche mit folgendem Befehl:

opencode web

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

⚠️

Wenn OPENCODE_SERVER_PASSWORD nicht gesetzt ist, ist der Server ungeschützt. Das ist für die lokale Nutzung in Ordnung, sollte aber für den Netzwerkzugriff gesetzt werden.

Für die beste Erfahrung führen Sie opencode web von WSL statt von PowerShell aus. Dies gewährleistet den korrekten Dateisystemzugriff und die Terminal-Integration.

Konfiguration

Sie können den Webserver über Befehlszeilenflags 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 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 zu erlauben (nützlich für benutzerdefinierte Frontends):

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

Authentifizierung

Um den Zugriff zu schützen, setzen Sie ein Passwort mit der 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.

Die Web-Oberfläche verwenden

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

Sitzungen

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

Serverstatus

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

Ein Terminal anhängen

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

# Webserver starten
opencode web --port 4096
 
# In einem anderen Terminal das TUI anhängen
opencode attach http://localhost:4096

Dies ermöglicht es Ihnen, sowohl die Web-Oberfläche als auch das Terminal gleichzeitig zu nutzen und dieselben Sitzungen und Zustände zu teilen.

Konfigurationsdatei

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

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

Befehlszeilenflags haben Vorrang vor Konfigurationsdatei-Einstellungen.

CLIIDE