mirror of
https://github.com/anomalyco/opencode.git
synced 2026-05-01 22:10:23 +00:00
142 lines
3.8 KiB
Text
142 lines
3.8 KiB
Text
---
|
||
title: Web
|
||
description: Verwenden Sie OpenCode in Ihrem Browser.
|
||
---
|
||
|
||
OpenCode kann als Webanwendung in Ihrem Browser ausgeführt werden und bietet das gleiche leistungsstarke KI-Codierungserlebnis, ohne dass ein Terminal erforderlich ist.
|
||
|
||
|
||
|
||
## Erste Schritte
|
||
|
||
Starten Sie die Weboberfläche, indem Sie Folgendes ausführen:
|
||
|
||
```bash
|
||
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.
|
||
|
||
:::caution
|
||
Wenn `OPENCODE_SERVER_PASSWORD` nicht gesetzt ist, ist der Server ungesichert. Dies ist für den lokalen Gebrauch in Ordnung, sollte aber für den Netzwerkzugriff eingestellt werden.
|
||
:::
|
||
|
||
:::tip[Windows-Nutzer]
|
||
Um die beste Erfahrung zu erzielen, führen Sie `opencode web` über [WSL](/docs/windows-wsl) und nicht über PowerShell aus. Dies gewährleistet den ordnungsgemäßen Zugriff auf das Dateisystem und die Terminalintegration.
|
||
:::
|
||
|
||
---
|
||
|
||
## Konfiguration
|
||
|
||
Sie können den Webserver mithilfe von Befehlszeilen-Flags oder in Ihrer [Konfigurationsdatei](/docs/config) konfigurieren.
|
||
|
||
### Port
|
||
|
||
Standardmäßig wählt OpenCode einen verfügbaren Port aus. Sie können einen Port angeben:
|
||
|
||
```bash
|
||
opencode web --port 4096
|
||
```
|
||
|
||
### Hostname
|
||
|
||
Standardmäßig bindet der Server an `127.0.0.1` (nur localhost). So machen Sie OpenCode in Ihrem Netzwerk zugänglich:
|
||
|
||
```bash
|
||
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 erkennbar zu machen:
|
||
|
||
```bash
|
||
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:
|
||
|
||
```bash
|
||
opencode web --mdns --mdns-domain myproject.local
|
||
```
|
||
|
||
### CORS
|
||
|
||
So erlauben Sie zusätzliche Domänen für CORS (nützlich für benutzerdefinierte Frontends):
|
||
|
||
```bash
|
||
opencode web --cors https://example.com
|
||
```
|
||
|
||
### Authentifizierung
|
||
|
||
Um den Zugriff zu schützen, legen Sie mithilfe der Umgebungsvariablen `OPENCODE_SERVER_PASSWORD` ein Passwort fest:
|
||
|
||
```bash
|
||
OPENCODE_SERVER_PASSWORD=secret opencode web
|
||
```
|
||
|
||
Der Benutzername ist standardmäßig `opencode`, kann aber mit `OPENCODE_SERVER_USERNAME` geändert werden.
|
||
|
||
---
|
||
|
||
## Verwenden der Weboberfläche
|
||
|
||
Nach dem Start bietet die Weboberfläche Zugriff auf Ihre OpenCode-Sitzungen.
|
||
|
||
### Sitzungen
|
||
|
||
Zeigen Sie Ihre Sitzungen auf der Startseite an und verwalten Sie sie. Sie können aktive Sitzungen sehen und neue starten.
|
||
|
||
|
||
|
||
### Serverstatus
|
||
|
||
Klicken Sie auf „Server anzeigen“, um verbundene Server und deren Status anzuzeigen.
|
||
|
||
|
||
|
||
---
|
||
|
||
## Anschließen eines Terminals
|
||
|
||
Sie können eine Terminal-TUI an einen laufenden Webserver anschließen:
|
||
|
||
```bash
|
||
# 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 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.
|