Pular para o conteúdo
Docs de V1
Primeiros passos

Web

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.

opencode Web - Nova Sessão

Inicie a interface web executando:

Terminal
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.

Você pode configurar o servidor web usando flags de linha de comando ou no seu arquivo de configuração.

Por padrão, o opencode escolhe uma porta disponível. Você pode especificar uma porta:

Terminal
opencode web --port 4096

Por padrão, o servidor se vincula a 127.0.0.1 (apenas localhost). Para tornar o opencode acessível na sua rede:

Terminal
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

Ative o mDNS para tornar seu servidor descobrível na rede local:

Terminal
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:

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

Para permitir domínios adicionais para CORS (útil para frontends personalizados):

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

Para proteger o acesso, defina uma senha usando a variável de ambiente OPENCODE_SERVER_PASSWORD:

Terminal
OPENCODE_SERVER_PASSWORD=secret opencode web

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

Uma vez iniciada, a interface web fornece acesso às suas sessões do opencode.

Visualize e gerencie suas sessões a partir da página inicial. Você pode ver sessões ativas e iniciar novas.

opencode Web - Sessão Ativa

Clique em “Ver Servidores” para visualizar os servidores conectados e seu status.

opencode Web - Ver Servidores

Você pode anexar um terminal TUI a um servidor web em execução:

Terminal
# 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.

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.