Vai al contenuto
Docs di V1
Per iniziare

Web

OpenCode puo funzionare come applicazione web nel browser, offrendo la stessa potente esperienza di coding AI senza bisogno di un terminale.

OpenCode Web - Nuova sessione

Avvia l’interfaccia web eseguendo:

Terminale
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.


Puoi configurare il server web con i flag della riga di comando o nel tuo file di config.

Per impostazione predefinita, OpenCode sceglie una porta disponibile. Puoi specificare una porta:

Terminale
opencode web --port 4096

Per impostazione predefinita, il server si lega a 127.0.0.1 (solo localhost). Per rendere OpenCode accessibile sulla rete:

Terminale
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

Abilita mDNS per rendere il server individuabile sulla rete locale:

Terminale
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:

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

Per consentire domini aggiuntivi per CORS (utile per frontend personalizzati):

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

Per proteggere l’accesso, imposta una password usando la variabile d’ambiente OPENCODE_SERVER_PASSWORD:

Terminale
OPENCODE_SERVER_PASSWORD=secret opencode web

Lo username predefinito e opencode, ma puo essere cambiato con OPENCODE_SERVER_USERNAME.


Una volta avviata, l’interfaccia web ti da accesso alle tue sessioni OpenCode.

Visualizza e gestisci le sessioni dalla homepage. Puoi vedere le sessioni attive e avviarne di nuove.

OpenCode Web - Sessione attiva

Fai clic su “See Servers” per vedere i server connessi e il loro stato.

OpenCode Web - See Servers


Puoi collegare una TUI da terminale a un server web gia in esecuzione:

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


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.