OpenCode 2.0 funciona como um único servidor em segundo plano que compartilham o terminal, a web e o app de desktop, traz uma API reconstruída que o próprio agente pode chamar, e soma Code Mode, subagentes em segundo plano e um novo sistema de plugins. Para atualizar, passe para a última versão 1.x e execute opencode upgrade --major. Fizemos isso em uma instalação real de macOS e testamos cada novidade com um modelo gratuito, por um custo total de 0,00 dólares.
yoDEV Tested · 14 de outubro de 2026
Atualizamos uma instalação real de macOS de 1.17.11 para OpenCode 2 e repetimos os testes em um ambiente Linux limpo com@opencode/cli2.0.29. Os resultados que reportamos como nossos saem desse teste.
Anomaly anunciou OpenCode 2.0 em 12 de outubro de 2026, mas o pacote é anterior ao anúncio: @opencode/cli 2.0.0 apareceu no npm em 11 de setembro, e a versão vigente quando fizemos os testes, em 14 de outubro, era a 2.0.29.
O que é OpenCode?
OpenCode é um agente de programação com IA de código aberto que funciona no seu terminal, no navegador e como app de desktop, e se conecta com dezenas de provedores de modelos, entre eles o seu próprio, OpenCode Zen, que oferece modelos gratuitos. Se você está comparando com outros agentes de terminal, nosso comparativo OpenCode vs Crush cobre a linha 1.x.
Como atualizar OpenCode para a versão 2.0?
A atualização tem dois passos, porque a opção --major só existe nas versões 1.x recentes; o comando upgrade da versão 2 não a tem.
Primeiro, faça um backup da sua configuração:
cp -r ~/.config/opencode ~/.config/opencode.v1-backup
Depois, coloque a 1.x em dia e pule para a 2:
opencode upgrade
opencode upgrade --major
opencode --version
Na versão 1.19.0, a ajuda de --major diz que atualiza para OpenCode 2 e remove OpenCode 1. Ou seja, substitui a v1: as duas versões não convivem instaladas. Se instalou com npm, tenha em mente que o nome do pacote muda: a v1 era opencode-ai e a v2 é @opencode/cli.
Nosso teste: 1.17.11 → opencode upgrade → 1.19.0 → opencode upgrade --major → OpenCode 2. Repetimos o segundo passo com --method npm em um ambiente Linux limpo, onde removeu opencode-ai e deixou instalado apenas @opencode/cli.
Como instalar OpenCode 2.0 do zero?
Se nunca usou OpenCode, você pode instalar a versão 2 diretamente do npm, com o mesmo comando que usa a documentação oficial em seu exemplo de CI:
npm install --global @opencode/cli
Depois entre na pasta de um projeto e execute opencode para abrir a interface de terminal.
O que quebra ao atualizar para OpenCode 2.0?
O guia de migração enumera exatamente três mudanças incompatíveis, todas intencionais:
- Plugins. As implementações de plugins da v1 não funcionam na v2. A chave de configuração também muda de
pluginparaplugins, mas renomeá-la não é suficiente: cada plugin precisa ser portado com o guia de migração específico para plugins. (Não testamos um plugin da v1; isso é o que indica a documentação do provedor). - A API do servidor. Tudo que chamar a API do servidor da v1 precisa passar para a API da v2, através do novo pacote
@opencode/client. - A configuração do cliente de terminal. Os arquivos
tui.jsonpor camadas são substituídos por um único arquivo global,~/.config/opencode/cli.json, que é migrado automaticamente na primeira vez que o terminal da v2 inicia.
Se você depende de algum plugin de OpenCode, revise antes de atualizar. Nossa lista de 10 plugins e agentes de OpenCode que vale a pena instalar foi escrita para a 1.x.
Minha configuração de OpenCode 1.x ainda funciona?
Sim. A v2 lê a configuração das mesmas localizações que a v1 e normaliza o formato antigo na memória, sem reescrever seus arquivos. Em nossa máquina de teste, o opencode.jsonc existente sobreviveu intacto à atualização e a v2 funcionou com ele como estava. Em um teste separado, um agente da v1 definido com prompt foi lido como system na v2, e um servidor MCP no formato da v1 se conectou normalmente.
Converter a configuração para o formato nativo da v2 é opcional. O guia de migração recomenda deixar que OpenCode faça isso com este prompt:
Migrate my OpenCode configuration, including file-based definitions, from the V1 format to the native V2 format.
Preserve its behavior and all unrelated settings.
Antes de usar a v2 diariamente, é útil conhecer duas mudanças de comportamento:
- A v2 só lê
AGENTS.md. Se sua configuração da v1 dependia de um arquivoCLAUDE.mdcomo fallback, passe essas instruções paraAGENTS.md. - A v2 não executa servidores de linguagem. Aceita a configuração
lsp, mas não os inicia nem produz diagnósticos LSP; a documentação sugere usar no lugar os comandos de lint, typecheck ou compilação do seu projeto.
O que é Code Mode no OpenCode?
Code Mode permite que o agente escreva um script curto em JavaScript que chama várias ferramentas de uma vez, em vez de chamá-las uma por uma, com uma ida e volta para cada chamada. Funciona sobre um intérprete mínimo incluído no pacote @opencode/codemode, que converte servidores MCP e endpoints OpenAPI em funções que o script pode invocar. Na 2.0, todos os servidores MCP vêm com Code Mode ativado por padrão.
Nosso teste. Adicionamos o servidor MCP de Context7 com um único comando, sem nada mais:
opencode mcp add context7 --url https://mcp.context7.com/mcp
Depois pedimos ao OpenCode que comparasse como lidam com o estado React e Vue usando Context7. O primeiro bloco execute enviou as duas consultas, a de React e a de Vue, juntas. A de React falhou porque Context7 moveu o identificador de React de /facebook/react para /react/react; o segundo bloco execute tentou novamente com o identificador correto e lançou duas consultas de React de uma só vez. No total: quatro chamadas MCP em dois percursos de ida e volta, quando chamá-las uma por uma teria levado quatro.
Anomaly afirma além disso que Code Mode permite adicionar mil servidores MCP com um impacto mínimo no contexto. Essa é a afirmação do provedor; testamos com um único servidor.
OpenCode pode executar tarefas em segundo plano?
Sim, tanto subagentes quanto comandos de shell. O agente principal pode delegar trabalho em um subagente em segundo plano (de forma automática ou quando você pede, até com outro modelo) e continuar trabalhando. Os comandos de shell longos também podem rodar de forma assíncrona, e qualquer comando ou subagente em primeiro plano pode ser mandado para o segundo plano com ctrl+b.
Nosso teste. Pedimos um subagente em segundo plano para revisar README.md enquanto sleep 45 era executado, e o agente respondeu a um segundo prompt com ambos ainda em andamento. Depois lançamos um sleep 60 em primeiro plano e pressionamos ctrl+b: passou para o segundo plano instantaneamente. Cerca de um minuto depois, a transcrição mostrou ↳ Shell finished · sleep 60 e o agente confirmou sem que pedíssemos.
Como OpenCode cria um git worktree por conta própria?
OpenCode 2.0 conhece sua própria API e a usa. O exemplo do anúncio é mover a sessão atual para um novo git worktree quando você começa um trabalho novo, e isso é exatamente o que vimos.
Nosso teste. Pedimos: “Start rate limiting uploads in a new worktree.” O agente executou opencode.worktree_create [name=rate-limit-uploads] dentro de um bloco execute, e depois opencode.session_move para o novo diretório, ~/.local/share/opencode/worktree/<projeto>/rate-limit-uploads. Em outras palavras, funcionou com sua própria API através de Code Mode. (O rate limiting em si não avançou: nosso repositório de teste não tem nenhum endpoint de upload de arquivos).
Você pode chamar a mesma API você mesmo com opencode api:
opencode api session.list --param limit=10
opencode api session.create --data '{"title": "New session"}'
O que é o serviço em segundo plano de OpenCode?
Na 2.0, OpenCode inicia um único servidor compartilhado em segundo plano para sua conta de usuário, e todos os clientes locais (terminal, web e desktop) se conectam a ele. Esse servidor é dono das sessões, da configuração, das integrações, das permissões e da execução de ferramentas; por isso uma sessão que você começa no terminal também aparece na interface web.
Você o gerencia com opencode service:
opencode service status
opencode service start
opencode service stop
Se preferir o comportamento anterior, com um processo por terminal, opencode --standalone executa um servidor privado, e opencode service set disabled true o converte no comportamento padrão. opencode pair imprime links únicos e um código QR para conectar outro navegador ou app ao servidor.
O que muda nos plugins de OpenCode 2?
O sistema de plugins foi reconstruído, e Anomaly implementou quase todas as funcionalidades da 2.0 como plugins internos para manter a API em bom estado. Ao consultar nossa instalação através da API obtivemos 88 plugins integrados, entre eles os de worktrees, os padrões de Code Mode e os subagentes. (No momento de nossos testes, opencode plugin list --builtin não mostrava nenhum plugin na mesma sessão; a listagem da API é a confiável).
Os plugins da interface de terminal passaram de experimentais para estáveis, e tudo pode ser recarregado em tempo real, então OpenCode pode escrever um plugin para si mesmo em plena sessão e usá-lo imediatamente. Os plugins são gerenciados com opencode plugin add, opencode plugin list, opencode plugin check e opencode plugin update.
Também há um novo pacote, @opencode/sdk, para usar OpenCode como biblioteca: é o mesmo código que alimenta a CLI. No momento de publicar esta nota, Anomaly o descrevia como ainda em desenvolvimento.
OpenCode é grátis?
OpenCode é de código aberto, e seu provedor integrado, OpenCode Zen, inclui modelos gratuitos que funcionam sem chave de API. Todos os testes do agente deste artigo foram feitos com Big Pickle (opencode/big-pickle), um desses modelos gratuitos, e opencode stats --cost --days 1 reportou 0,00 dólares para o dia: cerca de 120.000 tokens de entrada e 13.000 de saída, com 90 por cento da entrada servida do cache. A lista de modelos gratuitos muda; execute opencode models para ver a atual.
Como testamos?
- Atualização e funcionalidades do agente: a instalação de macOS de Greg, atualizada de 1.17.11, em 14 de outubro de 2026, com Big Pickle no agente Build padrão.
- API, plugins integrados e compatibilidade com configuração da v1: um ambiente Linux limpo com
@opencode/cli2.0.29.
E você? Qual das novidades de OpenCode 2.0 vai usar primeiro no seu fluxo de trabalho?
- Sim, já estou na 2.0
- Ainda não: espero que meus plugins sejam atualizados
- Uso outro agente de programação
- Prefiro outra opção (conte qual)
Comente abaixo ou, se este artigo chegou até você por email, responda diretamente ao email: sua resposta é publicada aqui.
Relacionado: Seu OpenCode Está Vazio: 10 Plugins e Agentes que Vale a Pena Instalar