1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
---
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.
|
