OpenCode no celular, num servidor seu

O OpenCode é um agente de código open source (MIT) que funciona com praticamente qualquer provedor de modelos. Ele é popular entre quem não quer ficar preso à assinatura de um único fornecedor. Também foi feito para ser comandado remotamente: o opencode serve roda uma API HTTP headless, e o opencode web adiciona uma interface no navegador por cima. Então a questão não é se dá para acessá-lo pelo celular, mas como fazer isso com segurança e mantê-lo rodando.

Formas de usar o OpenCode pelo celular

As duas primeiras são boas opções e não custam nada. O OpenCode Mobile é um projeto da comunidade que deixa claro que não é afiliado ao OpenCode. Se você só usa o OpenCode em casa, numa única rede, o opencode web pode ser tudo de que você precisa. O Maude é pensado para o OpenCode num servidor remoto que precisa continuar trabalhando enquanto você está longe, ao lado de outros agentes como o Claude Code e o Codex. Nosso panorama de apps de celular para agentes de código compara o cenário mais amplo.

Segurança: não exponha a porta 4096 à internet

Por padrão, o opencode serve escuta em 127.0.0.1:4096, e o opencode web escolhe uma porta local aleatória. É um padrão seguro. O problema começa quando você o abre para alcançar o celular. Nas palavras do próprio OpenCode: "Se OPENCODE_SERVER_PASSWORD não estiver definida, o servidor ficará desprotegido." Uma API do OpenCode aberta é um shell aberto naquela máquina, porque o agente pode executar comandos.

Se você for montar tudo por conta própria:

• Sempre defina OPENCODE_SERVER_PASSWORD. Ela ativa a autenticação HTTP básica tanto no serve quanto no web.
• Prefira uma rede privada como o Tailscale a um túnel público, e nunca faça bind em 0.0.0.0 numa VPS com IP público e sem firewall.
• Se precisar usar um túnel público, coloque autenticação na frente dele também.

O Maude evita essa questão. O OpenCode fica local no servidor, o daemon do Maude conversa com ele por stdio usando o Agent Client Protocol, e o daemon chega ao seu celular conectando-se para fora, ao relay do Maude. O tráfego tem criptografia de ponta a ponta com uma chave por servidor, então o relay só vê dados cifrados. O SSH fica como alternativa. Nosso guia de tmux, mosh e Tailscale aprofunda a parte de rede no estilo faça você mesmo.

Rodando o OpenCode numa VPS 24/7

O OpenCode em si é leve. São os builds e testes do seu projeto que definem o tamanho do servidor, e nosso guia de VPS para agentes de código trata do dimensionamento. Com o Maude, a configuração é:

1. Adicione o servidor no app pelo endereço, colando um comando ssh … ou escaneando o QR code gerado por curl -fsSL https://maude.pilotdev.fr/setup | sh. Qualquer máquina Linux ou macOS, x86-64 ou ARM.
2. O app implanta o daemon dele por SSH. O daemon instala o OpenCode numa versão testada e fixada, com checksum verificado em relação ao release, incluindo builds para Alpine (musl) e para CPUs mais antigas sem AVX2. Ele mantém o OpenCode atualizado.
3. Faça login num provedor pelo celular (próxima seção) e inicie uma sessão num diretório de projeto, opcionalmente na própria worktree do git.

A partir daí, as sessões rodam no servidor com o app aberto ou não. Quando o OpenCode pede permissão para executar algo, o pedido aparece como um cartão no chat, direto na caixa de entrada e como notificação push com Permitir e Negar. Os dois agentes principais do OpenCode correspondem ao seletor de modo do Maude: Build (padrão, todas as ferramentas) e Plan (um agente restrito para análise, que pergunta antes de qualquer edição ou comando). O /compact funciona, e cada sessão tem Arquivos, Git (revisão de diff, commit, push, pull requests via gh) e um terminal de verdade.

Modelos e chaves

O ponto forte do OpenCode é não estar preso a um único fornecedor de modelos. No Maude, você pode fazer o login dele pelo celular de qualquer uma destas formas:

• ChatGPT Plus/Pro, pelo login headless com código de dispositivo do OpenCode.
• GitHub Copilot, pelo fluxo de dispositivo do GitHub.
• Uma chave de API da Anthropic ou do OpenRouter, colada no app e guardada pelo OpenCode no servidor.

Provedores que você já configurou no servidor com opencode auth login também são detectados e usados. Os gateways do próprio OpenCode são outra opção. O OpenCode Zen dá acesso pago por uso a modelos que a equipe do OpenCode testou e inclui alguns modelos gratuitos por tempo limitado. O OpenCode Go é uma assinatura de modelos abertos populares para programação, $10 por mês, com o Go Plus a $40 para limites maiores. Escolha o modelo por sessão no seletor acima do campo de texto. O Maude não inclui nenhum uso de modelos.

Para ver como o OpenCode se compara aos agentes dos fornecedores em preço e comportamento, veja Claude Code vs Codex vs OpenCode. Uma sessão ociosa também pode ser passada para outro agente. O novo agente recebe um resumo com o plano, os arquivos alterados, o estado do git e a conversa recente, e voltar retoma a própria sessão do OpenCode.

Perguntas frequentes

O que mudou

• 1 de outubro de 2026 — Página publicada. Licença do OpenCode, padrões do servidor, orientação sobre senha e preços do Go/Zen conferidos com a documentação em opencode.ai nesta data.