Web

OpenCode puede ejecutarse como una aplicación web en su navegador, brindando la misma poderosa experiencia de codificación de IA sin necesidad de una terminal.

Empezando

Inicie la interfaz web ejecutando:

opencode web

Esto inicia un servidor local en 127.0.0.1 con un puerto disponible aleatorio y abre automáticamente OpenCode en su navegador predeterminado.

Precaución

Si no se establece OPENCODE_SERVER_PASSWORD, el servidor no será seguro. Esto está bien para uso local, pero debe configurarse para acceso a la red.

Windows Usuarios

Para obtener la mejor experiencia, ejecute opencode web desde WSL en lugar de PowerShell. Esto garantiza el acceso adecuado al sistema de archivos y la integración del terminal.

---

Configuración

Puede configurar el servidor web usando indicadores de línea de comando o en su archivo de configuración.

Puerto

De forma predeterminada, OpenCode elige un puerto disponible. Puede especificar un puerto:

opencode web --port 4096

Nombre de host

De forma predeterminada, el servidor se vincula a 127.0.0.1 (solo localhost). Para hacer que OpenCode sea accesible en su red:

opencode web --hostname 0.0.0.0

Al usar 0.0.0.0, OpenCode mostrará direcciones locales y de red:

  Local access:       http://localhost:4096
  Network access:     http://192.168.1.100:4096

Descubrimiento de mDNS

Habilite mDNS para que su servidor sea reconocible en la red local:

opencode web --mdns

Esto establece automáticamente el nombre de host en 0.0.0.0 y anuncia el servidor como opencode.local.

Puede personalizar el nombre de dominio mDNS para ejecutar varias instancias en la misma red:

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

CORS

Para permitir dominios adicionales para CORS (útil para interfaces personalizadas):

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

Autenticación

Para proteger el acceso, establezca una contraseña utilizando la variable de entorno OPENCODE_SERVER_PASSWORD:

OPENCODE_SERVER_PASSWORD=secret opencode web

El nombre de usuario predeterminado es opencode pero se puede cambiar con OPENCODE_SERVER_USERNAME.

---

Uso de la interfaz web

Una vez iniciada, la interfaz web proporciona acceso a sus sesiones OpenCode.

Sesiones

Vea y administre sus sesiones desde la página de inicio. Puedes ver sesiones activas e iniciar otras nuevas.

Estado del servidor

Haga clic en “Ver servidores” para ver los servidores conectados y su estado.

---

Adjuntar una terminal

Puede conectar un terminal TUI a un servidor web en ejecución:

# Start the web server
opencode web --port 4096

# In another terminal, attach the TUI
opencode attach http://localhost:4096

Esto le permite utilizar la interfaz web y el terminal simultáneamente, compartiendo las mismas sesiones y estados.

---

Archivo de configuración

También puede configurar los ajustes del servidor en su archivo de configuración opencode.json:

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

Los indicadores de la línea de comando tienen prioridad sobre la configuración del archivo de configuración.