OpenCode: terminal, web, desktop ou IDE? Qual interface usar em cada situação

Instalar o agente é a parte fácil, difícil é decidir em qual janela ele vai morar

Fala aí, tudo certo? O OpenCode é um agente de código open source, distribuído sob licença MIT, com o código no repositório anomalyco/opencode, e ele não te entrega uma interface só: tem interface de terminal (TUI), tem app desktop, tem extensão de IDE e tem a interface web aberta por comando do próprio OpenCode

Aí bate aquela vontade de instalar os quatro no mesmo dia só pra "ver qual é melhor"

Não precisa 🙂

A ideia aqui é te ajudar a escolher UMA porta de entrada, a que combina com o teu hábito de trabalho, e deixar o resto pra depois

(detalhe pra quem for caçar tutorial antigo: o projeto ficava em sst/opencode e migrou pra organização anomalyco, o endereço atual é anomalyco/opencode)

Formação Recomendada

Formação Agentes de IA

Domine a criação de Agentes de IA e Venda para Empresas

• 402 aulas
• 32 projetos
• 38h 19min

Conhecer formação

Terminal, web, desktop e IDE: comparação lado a lado

Antes de recomendar qualquer coisa, o mapa das interfaces do OpenCode com o que é verificável na documentação oficial:

Repara numa coisa antes de seguir: a interface web e a extensão de IDE nascem de comandos do OpenCode (opencode web e opencode)

Ou seja, elas não são caminhos paralelos ao terminal, elas saem de lá

Qual interface usar em cada situação

Agora o que interessa: qual porta abrir primeiro, dependendo de como tu trabalha

Você já vive no terminal e quer o caminho mais curto:

Esse é o cenário mais simples

Roda o script oficial e pronto:

curl -fsSL https://opencode.ai/install | bash

Se tu já é do time que instala tudo por gerenciador de pacote (se conhece npm ou brew, aqui é a mesma vibe), dá pra ir por eles também:

npm i -g opencode-ai
bun add -g opencode-ai
brew install anomalyco/tap/opencode

Recomendação: comece pela interface de terminal

O que ela exige: nada além do terminal que tu já usa todo dia (no Windows tem um detalhe, falo dele mais pra frente)

Você quer usar do navegador, ou de outra máquina da rede:

Aqui entra o opencode web

Ele sobe um servidor local em 127.0.0.1 numa porta disponível e abre o OpenCode no teu navegador padrão

opencode web

E se a ideia for acessar de outro aparelho na rede, o servidor aceita --hostname e --port, com o hostname indo pra 0.0.0.0 quando tu libera pra rede

Recomendação: vá de web se a tua vontade é trabalhar na aba do navegador ou alcançar a sessão de outro dispositivo

O que ela exige: o CLI instalado (o comando é do próprio OpenCode) e atenção redobrada com senha na hora de expor pra rede

Você prefere um app com janela própria:

Tem app desktop, e ele instala por Homebrew cask ou por download direto:

brew install --cask opencode-desktop

Os downloads cobrem macOS (Apple Silicon), macOS (Intel), Windows (x64), Linux (.deb) e Linux (.rpm)

Só que tem um asterisco honesto aqui: o desktop está em beta

Recomendação: vale como escolha se tu gosta de manter a ferramenta numa janela separada do editor, com a consciência de que é software em beta

O que ele exige: Homebrew ou o instalador do teu sistema, e tolerância a arestas de versão beta

Você edita o dia inteiro na IDE e não quer sair dela:

Existem extensões oficiais pra VS Code, Cursor, Zed, Windsurf e VSCodium

E a instalação é bem diferente do "procura na loja de extensões": tu abre o terminal integrado do editor e roda

opencode

A extensão é instalada automaticamente

Tome cuidado com dois detalhes, porque é aqui que a maioria trava:

• o OpenCode chama a ferramenta de linha de comando da IDE pra instalar a extensão, então o CLI do editor precisa estar disponível no PATH
• a detecção da IDE usa variáveis de ambiente que o editor define no terminal integrado, ou seja, rodar num terminal externo não serve

Recomendação: vá de extensão se o teu fluxo é editar arquivo e conversar com o agente sem trocar de janela

O que ela exige: o CLI do OpenCode instalado, o CLI do editor no PATH e o comando rodado DENTRO do terminal integrado

O que não muda entre as interfaces

Essa é a parte que tira o medo de escolher errado: por trás das quatro portas é o mesmo agente

As ferramentas internas são as mesmas: ler, escrever e editar arquivos, rodar comandos de shell e usar diagnósticos de LSP

Os modos também: Plan e Build, com etapa de revisão antes de alterar arquivos

E a conexão com modelo segue igual, com suporte a provedores diferentes (Anthropic, OpenAI, Google, por aí vai) e a possibilidade de usar chave própria

Essa separação entre planejar e executar não é exclusividade daqui, viu? Outras ferramentas resolvem a mesma questão com nomes próprios, tipo a diferença entre Skills, Rules e Workflows no Antigravity: muda o rótulo, a intenção de dar limite pro agente é a mesma

Então escolher terminal hoje e experimentar a IDE semana que vem não é recomeçar do zero

Cuidados antes de escolher: rede, senha e Windows

Tem três pontos práticos que pesam MUITO na decisão, principalmente se tu for de web

1. Por padrão o servidor é só local

O opencode web escuta em 127.0.0.1, e é assim que deve ficar enquanto tu estiver só na tua máquina

Ao liberar pra rede local, o hostname vai pra 0.0.0.0, e aí a coisa muda de figura: um agente com acesso a arquivo e shell passa a estar alcançável por outros aparelhos

É o mesmo tipo de cuidado que vale pra qualquer agente que ganha superpoder no teu ambiente, como quando você libera automação de navegador com Chrome headless pra ele: quanto mais alcance, mais limite explícito

2. Senha não vem ligada sozinha

Existe a variável OPENCODE_SERVER_PASSWORD, que ativa HTTP basic auth (usuário padrão opencode, alterável por OPENCODE_SERVER_USERNAME), valendo tanto pro opencode serve quanto pro opencode web

Se ela não estiver definida, o servidor fica desprotegido, o que só é aceitável em uso local

export OPENCODE_SERVER_PASSWORD="suasenha"
opencode web --hostname 0.0.0.0 --port 3000

3. Windows: a doc recomenda WSL

A documentação recomenda rodar pelo WSL em vez do PowerShell, por compatibilidade

Se tu está no Windows e ia mandar o script direto no PowerShell, já sabe: WSL primeiro, dor de cabeça a menos

Veredito: por onde começar com o OpenCode

Sem hype e sem enrolação: comece por UMA interface, e que seja o terminal

O motivo é estrutural, não é gosto

A web sobe com opencode web, e a extensão de IDE é instalada rodando opencode no terminal integrado

As duas dependem do CLI estar instalado, então o terminal é a base de qualquer caminho que tu escolher depois

O app desktop é a opção mais confortável pra quem quer janela própria, mas está em beta, e beta é beta: entre sabendo

A extensão de IDE é a que menos muda teu dia, porque ela mora onde tu já trabalha, com o preço de dois requisitos chatos (CLI do editor no PATH e terminal integrado)

E o que eu NÃO vou afirmar aqui: qual delas é mais rápida ou mais completa no uso diário

Isso depende de teste próprio no teu projeto, e chutar isso seria só barulho

Conclusão

A escolha entre as interfaces do OpenCode é menos sobre recurso e mais sobre hábito: onde tu já passa o dia?

Terminal pra quem vive no shell, web pra quem quer navegador ou acesso de outra máquina da rede, desktop pra quem gosta de app separado (em beta), extensão pra quem não larga a IDE

O próximo passo concreto é curtinho:

1. instale o CLI (curl -fsSL https://opencode.ai/install | bash, ou npm, bun, brew)
2. rode uma vez dentro de um projeto teu, de verdade, com um pedido pequeno
3. só depois experimente opencode web, o app desktop ou a extensão no teu editor

Uma porta de cada vez, e tu vai saber em uma tarde qual delas ficou

até o próximo post! 😀