Português
Documentação
Web

Web

OpenCode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma experiência poderosa de codificação com IA sem precisar de um terminal.

Começando

Inicie a interface web:

opencode web

Isso inicia um servidor local em 127.0.0.1 com uma porta selecionada automaticamente e abre a aplicação no seu navegador padrão.

Nota de Segurança: Sem OPENCODE_SERVER_PASSWORD definido, o servidor não tem segurança. Isso é aceitável para uso local, mas é obrigatório ao expor para a rede.

Opções de Configuração

Porta

Especifique uma porta personalizada:

opencode web --port 4096

Hostname

Vincule a todas as interfaces de rede:

opencode web --hostname 0.0.0.0

Por padrão, o servidor vincula a 127.0.0.1 (apenas localhost). Use 0.0.0.0 para permitir acesso pela rede.

Descoberta mDNS

Habilite a descoberta na rede local:

opencode web --mdns

Isso automaticamente define o hostname para 0.0.0.0 e anuncia o servidor como opencode.local na sua rede local.

CORS

Permita domínios adicionais para requisições cross-origin:

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

Autenticação

Proteja o acesso ao servidor com uma senha:

OPENCODE_SERVER_PASSWORD=secret opencode web

O nome de usuário padrão é opencode, mas pode ser personalizado via OPENCODE_SERVER_USERNAME.

Recursos da Interface Web

  • Sessões: Visualize e gerencie sessões ativas na página inicial
  • Status do Servidor: Acesse servidores conectados pela opção "Ver Servidores"

Conexão de Terminal

Conecte um TUI de terminal a um servidor web em execução:

opencode web --port 4096
opencode attach http://localhost:4096

Isso permite acesso simultâneo tanto pelo navegador quanto pelo terminal.

Arquivo de Configuração

Configure as opções do servidor em opencode.json:

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

As flags de linha de comando sobrescrevem as configurações do arquivo de configuração.