File size: 3,672 Bytes
3e05655 | 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 143 | ---
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.
|