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: Usa OpenCode nel browser.
---
OpenCode puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminale.
## Per iniziare
Avvia l'interfaccia web eseguendo:
```bash
opencode web
```
Questo avvia un server locale su `127.0.0.1` con una porta disponibile scelta a caso e apre automaticamente OpenCode nel browser predefinito.
:::caution
Se `OPENCODE_SERVER_PASSWORD` non e impostata, il server non sara protetto. Va bene per l'uso locale, ma va impostata per l'accesso in rete.
:::
:::tip[Utenti Windows]
Per la migliore esperienza, esegui `opencode web` da [WSL](/docs/windows-wsl) invece che da PowerShell. Questo garantisce accesso corretto al file system e integrazione col terminale.
:::
---
## Configurazione
Puoi configurare il server web con i flag della riga di comando o nel tuo [file di config](/docs/config).
### Porta
Per impostazione predefinita, OpenCode sceglie una porta disponibile. Puoi specificare una porta:
```bash
opencode web --port 4096
```
### Nome host
Per impostazione predefinita, il server si lega a `127.0.0.1` (solo localhost). Per rendere OpenCode accessibile sulla rete:
```bash
opencode web --hostname 0.0.0.0
```
Usando `0.0.0.0`, OpenCode mostrera sia l'indirizzo locale sia quello di rete:
```
Local access: http://localhost:4096
Network access: http://192.168.1.100:4096
```
### Scoperta mDNS
Abilita mDNS per rendere il server individuabile sulla rete locale:
```bash
opencode web --mdns
```
Questo imposta automaticamente l'hostname a `0.0.0.0` e pubblicizza il server come `opencode.local`.
Puoi personalizzare il nome di dominio mDNS per eseguire piu istanze sulla stessa rete:
```bash
opencode web --mdns --mdns-domain myproject.local
```
### CORS
Per consentire domini aggiuntivi per CORS (utile per frontend personalizzati):
```bash
opencode web --cors https://example.com
```
### Autenticazione
Per proteggere l'accesso, imposta una password usando la variabile d'ambiente `OPENCODE_SERVER_PASSWORD`:
```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```
Lo username predefinito e `opencode`, ma puo essere cambiato con `OPENCODE_SERVER_USERNAME`.
---
## Usa l'interfaccia web
Una volta avviata, l'interfaccia web ti da accesso alle tue sessioni OpenCode.
### Sessioni
Visualizza e gestisci le sessioni dalla homepage. Puoi vedere le sessioni attive e avviarne di nuove.
### Stato del server
Fai clic su "See Servers" per vedere i server connessi e il loro stato.
---
## Collegare un terminale
Puoi collegare una TUI da terminale a un server web gia in esecuzione:
```bash
# Avvia il web server
opencode web --port 4096
# In un altro terminale, collega la TUI
opencode attach http://localhost:4096
```
Questo ti permette di usare contemporaneamente interfaccia web e terminale, condividendo le stesse sessioni e lo stesso stato.
---
## File di configurazione
Puoi anche configurare le impostazioni del server nel file di config `opencode.json`:
```json
{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}
```
I flag della riga di comando hanno precedenza sulle impostazioni del file di config.
|
