OpenCode 2.0: o que mudou na prática e se vale a pena

O OpenCode 2.0 transforma o agente de código open source num serviço único em segundo plano, e assim terminal, desktop e navegador dividem a mesma sessão. Lançada pela Anomaly em outubro de 2026, a versão traz ainda subagentes em background, Code Mode para MCP e plugins refeitos. Vale testar se você quer escolher o modelo e gastar menos, mas quem depende da assinatura do Claude tende a ficar no Claude Code.

Este guia reúne o que mudou, como instalar e como o OpenCode 2.0 se compara a Claude Code, Codex e Antigravity. A base prática é o vídeo do criador Eli Rigobeli, que montou um projeto com três agentes em paralelo. Além disso, cruzamos cada recurso com a documentação oficial e o changelog. Por fim, se você ainda não conhece a ferramenta, comece pelo guia do OpenCode como alternativa ao Claude Code.

O interesse segue alto. Segundo dados do GitHub de outubro de 2026, o repositório anomalyco/opencode passa de 215 mil estrelas. Para comparação, o Codex CLI da OpenAI tem cerca de 129 mil. Portanto, trata-se de um dos agentes de código mais acompanhados do mundo.

O que mudou no OpenCode 2.0?

A grande mudança do OpenCode 2.0 é arquitetural: um processo local em segundo plano controla sessões, plugins, permissões e ferramentas. Assim, terminal, desktop e web viram clientes desse serviço. A Anomaly resume a novidade assim: “In 2.0 this server now automatically runs as a single background process on your machine”. Ou seja, o servidor sobe sozinho como um único processo na sua máquina.

Na prática, o fluxo muda. No vídeo, Eli abre uma sessão no terminal, pede ao agente para renomeá-la e depois a abre no app desktop. Em seguida, ele manda uma mensagem pelo desktop e ela surge no terminal na hora. De fato, a versão 1 já tinha terminal, app e web, mas agora eles trabalham juntos por padrão.

Quem prefere o comportamento antigo tem saída. Por exemplo, a flag --standalone roda o agente com um servidor privado. Já a flag --server conecta o terminal a outro servidor. Dessa forma, dá para isolar um projeto sensível.

Pareamento com o celular e acesso remoto

Como o serviço é um servidor, ele pode ser exposto a outros aparelhos. O comando opencode pair sobe a interface web e gera um link de acesso de curta duração. Já o opencode pair --remote pede confirmação antes de expor o servidor na internet. Depois, ele mostra um link e um QR code para abrir a sessão no celular. No desktop, o fluxo fica em Configurações, Pareamento.

Segundo o changelog oficial, a versão 2.0.29, de 14 de outubro de 2026, trouxe o pareamento remoto via OpenTunnel. No vídeo, Eli diz que o link vale por cerca de 5 minutos e só uma vez. Contudo, o aparelho pareado continua conectado. No entanto, nada roda na nuvem: desligou o computador, o acesso cai junto.

Como funcionam os subagentes em background e o Code Mode?

Os subagentes em background deixam você delegar uma tarefa e seguir conversando com o agente principal. A versão 1 já tinha subagentes, mas eles travavam a conversa. Agora, o atalho Ctrl+B manda para segundo plano um subagente ou comando de shell em execução. Assim, uma instalação demorada deixa de bloquear o resto do trabalho.

Segundo a documentação, há dois agentes primários: o build, padrão e com acesso completo, e o plan, que planeja sem editar. Além disso, existem dois subagentes embutidos, o general e o explore, que só lê. Por fim, você cria os seus em arquivos Markdown na pasta .opencode/agents/.

O corpo do Markdown vira o prompt de sistema. Veja a seguir um exemplo ilustrativo:

O campo model segue o formato provedor/modelo#variante. Inclusive, um subagente sem modelo herda o da sessão principal. Com isso, um agente caro coordena e subagentes baratos executam partes isoladas.

Code Mode: o agente escreve código para chamar ferramentas

Antes, cada chamada de ferramenta MCP era uma ida e volta com o modelo. O agente pedia a ferramenta A, esperava e só então pedia a B. No Code Mode, por outro lado, o modelo escreve um script em JavaScript que chama várias ferramentas. Além disso, ele roda consultas em paralelo e filtra os dados. Consequentemente, menos dados intermediários entram no contexto.

No anúncio, a Anomaly afirma que “All MCP servers in 2.0 are opted into code mode by default”. Ou seja, todo servidor MCP já entra no Code Mode, e codemode: false desliga o recurso por servidor. Além disso, o interpretador não tem acesso livre a arquivos nem fetch direto. Se o protocolo é novo para você, o guia de MCP Server no Claude Code explica a base.

Por sua vez, as ferramentas de worktree chegaram na versão 2.0.27, de 12 de outubro de 2026. Um worktree é uma cópia do projeto em outra pasta, ligada ao mesmo repositório Git. Com isso, cada agente trabalha numa branch e numa pasta próprias. Afinal, a branch separa a linha de desenvolvimento, e o worktree dá a cada agente o seu espaço.

Como foi o teste prático do OpenCode 2.0 no vídeo?

O teste de Eli Rigobeli criou uma página de links no estilo Linktree, com front-end, back-end e contagem de cliques, dividida entre três agentes. O principal ficou com o back-end, usando um GPT da assinatura do ChatGPT. Em seguida, um subagente fez o front-end com o DeepSeek V4 Flash via OpenRouter. Por fim, outro subagente, com Sonnet via OpenRouter, testou tudo.

O detalhe está na configuração. Em vez de escrever os agentes à mão, ele passou ao agente o link da documentação. Assim, o próprio OpenCode leu a sintaxe, perguntou o ID exato do DeepSeek e criou os arquivos. Além disso, ele definiu um contrato de API entre as partes.

Depois, ele iniciou o front-end em background e seguiu com a API sem esperar. Na interface, dá para abrir a sessão filha do subagente e voltar à principal.

Em seguida, o testador abriu um navegador, checou carregamento, links inválidos e respostas 404, e devolveu um relatório. Por último, o agente criou um repositório Git e publicou o site numa VPS da Hostinger, parceira do canal, via MCP com login OAuth. Segundo o Eli, o site subiu em containers próprios, sem mexer em outros projetos.

A nossa leitura dos números é direta. O front-end com DeepSeek custou 4 centavos de dólar, mas os testes com Sonnet custaram seis vezes mais. Por isso, recomendamos reservar modelos premium para revisão e mandar o trabalho braçal para modelos baratos. Afinal, o OpenCode 2.0 torna essa divisão trivial.

Como instalar ou atualizar para o OpenCode 2.0?

Quem já usa a versão 1 deve estar na última 1.x e rodar opencode upgrade --major, segundo o anúncio oficial. Afinal, desde a 1.19.2 a migração é uma escolha explícita. Já quem instalou via npm, como Eli no Windows, precisa trocar o pacote, porque o nome mudou:

Também há Homebrew (brew install anomalyco/tap/opencode-v2), Bun, pnpm, mise e WinGet. Além disso, existe o app desktop para macOS, Windows e Linux, e o vídeo cita extensões para VS Code, Cursor e Zed. Depois, abra o terminal na pasta do projeto e digite opencode.

Em seguida, conecte um provedor com /connect. A lista inclui OpenAI, Anthropic, Google, DeepSeek, OpenRouter e o OpenCode Go, que custa US$ 10 por mês segundo a documentação. Na OpenAI, dá para entrar com a conta do ChatGPT e usar o plano. Por outro lado, a chave de API cobra por token. Logo, quem tem boa placa de vídeo pode preferir um modelo local, como no guia do Ollama.

Antes de atualizar, faça backup, principalmente se você usa plugins. Afinal, o guia de migração avisa que plugins da versão 1 não rodam na nova. Da mesma forma, o tui.json virou ~/.config/opencode/cli.json. Nas permissões, por sua vez, bash virou shell.

OpenCode 2.0 vale a pena vs Claude Code, Codex e Antigravity?

O OpenCode 2.0 vale a pena para quem quer escolher o modelo e controlar o custo. Por outro lado, quem busca qualidade pronta tende a preferir o Claude Code. Veja abaixo as diferenças que mais pesam.

Na qualidade bruta, o Claude Code segue na frente. Segundo o Coding Agent Index da Artificial Analysis, ele marca 68 pontos contra 54 do OpenCode. Contudo, o índice usa modelos diferentes em cada agente: Sonnet 5.5 contra GLM-5.3. Logo, parte da distância vem do modelo, e não só do harness.

O custo pesa mais no Brasil. Desde o início de 2026, a Anthropic restringe as assinaturas Claude Pro e Max em ferramentas de terceiros. Por isso, no OpenCode os modelos Claude entram via API, cobrados por token. Em compensação, o login com o ChatGPT funciona, como o vídeo mostra.

Na nossa visão, o OpenCode 2.0 virou uma plataforma para orquestrar vários modelos. Preferimos o Claude Code para quem já paga o Max e quer pouca configuração. Por outro lado, sugerimos o OpenCode para quem quer combinar DeepSeek, Kimi e GPT, ou rodar tudo localmente. Nesse caso, vale ler sobre agentic engineering.

O que observar antes de migrar?

A versão 2 tem quebras reais que convém conhecer antes de migrar. Primeiro, uma issue no GitHub de 13 de outubro relatou que a extensão do VS Code parou, porque a flag --port saiu. Em seguida, o guia de migração avisa que a versão 2 não roda servidores de LSP. De fato, essa integração era um dos destaques do OpenCode 1.

Há também cuidados de segurança. Na versão 2, o acesso a pastas fora do projeto (external_directory) fica liberado por padrão, salvo uma regra ask. Além disso, o hot reload deixa o agente escrever um plugin e usá-lo na mesma sessão, o que gerou debate no Hacker News. Da mesma forma, o pair --remote expõe um serviço que roda comandos na sua máquina.

Por fim, paralelo não significa isolado. Dois agentes no mesmo arquivo ainda entram em conflito. Por isso, apontamos os worktrees como parte do fluxo. Inclusive, a lista de skills mais populares do Claude Code traz padrões que valem para qualquer agente.

Conclusão

Portanto, o OpenCode 2.0 muda menos a cara do agente e mais o que acontece por trás dele. O serviço compartilhado junta terminal, desktop, web e celular numa sessão. Além disso, subagentes em background e Code Mode deixam cada modelo no papel em que custa menos. No entanto, o preço são as quebras de plugins e extensões, além da perda do LSP.

Para experimentar, siga três passos. Primeiro, faça backup e teste o OpenCode 2.0 num projeto pequeno. Em seguida, crie um subagente com modelo barato e compare o custo. Por fim, só migre o projeto principal depois de conferir seus plugins e extensões.