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: Usando OpenCode en su navegador.
---
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.
## Empezar
Inicie la interfaz web ejecutando:
```bash
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.
:::caution
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.
:::
:::tip[Windows Usuarios]
Para obtener la mejor experiencia, ejecute `opencode web` desde [WSL](/docs/windows-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](/docs/config).
### Puerto
De forma predeterminada, OpenCode elige un puerto disponible. Puede especificar un puerto:
```bash
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:
```bash
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:
```bash
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:
```bash
opencode web --mdns --mdns-domain myproject.local
```
### CORS
Para permitir dominios adicionales para CORS (útil para interfaces personalizadas):
```bash
opencode web --cors https://example.com
```
### Autenticación
Para proteger el acceso, establezca una contraseña utilizando la variable de entorno `OPENCODE_SERVER_PASSWORD`:
```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```
El nombre de usuario predeterminado es `opencode` pero se puede cambiar con `OPENCODE_SERVER_USERNAME`.
---
## Usar 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:
```bash
# 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`:
```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.
|
