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 o opencode no seu navegador.
---
O opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com IA sem precisar de um terminal.
## Primeiros passos
Inicie a interface web executando:
```bash
opencode web
```
Isso inicia um servidor local em `127.0.0.1` com uma porta aleatória disponível e abre automaticamente o opencode no seu navegador padrão.
:::caution
Se `OPENCODE_SERVER_PASSWORD` não estiver definido, o servidor ficará sem segurança. Isso é aceitável para uso local, mas deve ser configurado para acesso à rede.
:::
:::tip[Usuários do Windows]
Para a melhor experiência, execute `opencode web` a partir do [WSL](/docs/windows-wsl) em vez do PowerShell. Isso garante acesso adequado ao sistema de arquivos e integração com o terminal.
:::
---
## Configuração
Você pode configurar o servidor web usando flags de linha de comando ou no seu [arquivo de configuração](/docs/config).
### Porta
Por padrão, o opencode escolhe uma porta disponível. Você pode especificar uma porta:
```bash
opencode web --port 4096
```
### Nome do Host
Por padrão, o servidor se vincula a `127.0.0.1` (apenas localhost). Para tornar o opencode acessível na sua rede:
```bash
opencode web --hostname 0.0.0.0
```
Ao usar `0.0.0.0`, o opencode exibirá endereços locais e de rede:
```
Local access: http://localhost:4096
Network access: http://192.168.1.100:4096
```
### Descoberta mDNS
Ative o mDNS para tornar seu servidor descobrível na rede local:
```bash
opencode web --mdns
```
Isso define automaticamente o nome do host como `0.0.0.0` e anuncia o servidor como `opencode.local`.
Você pode personalizar o nome de domínio mDNS para executar várias instâncias na mesma rede:
```bash
opencode web --mdns --mdns-domain myproject.local
```
### CORS
Para permitir domínios adicionais para CORS (útil para frontends personalizados):
```bash
opencode web --cors https://example.com
```
### Autenticação
Para proteger o acesso, defina uma senha usando a variável de ambiente `OPENCODE_SERVER_PASSWORD`:
```bash
OPENCODE_SERVER_PASSWORD=secret opencode web
```
O nome de usuário padrão é `opencode`, mas pode ser alterado com `OPENCODE_SERVER_USERNAME`.
---
## Usando a Interface Web
Uma vez iniciada, a interface web fornece acesso às suas sessões do opencode.
### Sessões
Visualize e gerencie suas sessões a partir da página inicial. Você pode ver sessões ativas e iniciar novas.
### Status do Servidor
Clique em "Ver Servidores" para visualizar os servidores conectados e seu status.
---
## Anexando um Terminal
Você pode anexar um terminal TUI a um servidor web em execução:
```bash
# Start the web server
opencode web --port 4096
# In another terminal, attach the TUI
opencode attach http://localhost:4096
```
Isso permite que você use tanto a interface web quanto o terminal simultaneamente, compartilhando as mesmas sessões e estado.
---
## Arquivo de Configuração
Você também pode configurar as configurações do servidor no seu arquivo de configuração `opencode.json`:
```json
{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}
```
As flags de linha de comando têm precedência sobre as configurações do arquivo de configuração.
|
