Neste artigo
- OpenCode 2.0: o que é o opencode agent servico local mcp/openapi e por que a atualização quebra plugins da 1.x
- O que muda de fato na versão 2.0
- Por que os plugins da 1.x quebram
- Comparativo rápido: 1.x vs 2.0
- O que fazer agora: checklist para dev iniciante
- Por que isso importa para quem está estudando
- Vale a pena migrar já?
OpenCode 2.0: o que é o opencode agent servico local mcp/openapi e por que a atualização quebra plugins da 1.x
O opencode agent servico local mcp/openapi é a nova arquitetura do OpenCode 2.0: o agente deixa de ser só uma ferramenta de linha de comando e passa a rodar como um serviço local, com API nova e um Code Mode para MCP/OpenAPI. Para quem usa a versão 1.x, o aviso importante é direto: os plugins antigos quebram com essa atualização.
A notícia ganhou tração na comunidade brasileira, conforme noticiado pelo r/brdev, com o tema em alta e prioridade de cobertura. Se você é dev júnior ou estudante usando OpenCode no dia a dia, este guia prático explica o que muda e o que fazer agora.
O que muda de fato na versão 2.0
A grande virada é conceitual: o OpenCode deixa de ser apenas um agente que você chama no terminal e vira um serviço rodando na sua máquina. Isso significa que outras aplicações podem consumir o agente pela API nova, sem precisar reiniciar nada a cada tarefa.
Na prática, o agente fica disponível como um processo local persistente. Ferramentas, editores e scripts podem conversar com ele por HTTP, integrando o agente ao seu fluxo de trabalho em vez de tratá-lo como um comando isolado.
O segundo destaque é o Code Mode para MCP e OpenAPI. Ele permite que o agente interaja com servidores MCP (Model Context Protocol) e APIs documentadas em OpenAPI de forma mais estruturada, escrevendo e executando código para orquestrar essas integrações.
Por que os plugins da 1.x quebram
A mudança para serviço local exigiu uma API nova — e é ela a causa da quebra. Plugins escritos para a arquitetura da versão 1.x dependiam de interfaces que não existem mais na 2.0.
Não é um bug nem uma punição: é uma quebra deliberada de compatibilidade para sustentar o novo modelo de serviço. Mas o efeito prático é o mesmo — quem atualizou e viu tudo parar de funcionar precisa agir.
OpenCode 2.0: agente vira serviço local com API nova. Code Mode adiciona suporte a MCP e OpenAPI. Plugins da versão 1.x não são compatíveis e quebram após a atualização.
Comparativo rápido: 1.x vs 2.0
O que fazer agora: checklist para dev iniciante
Se você já atualizou (ou está pensando em atualizar), o caminho é se organizar antes de perder tempo debugando o que não tem conserto. Eu já perrei um prazo de estudo uma vez por atualizar ferramenta crítica sem ler changelog — não repita esse erro.
- Antes de atualizar: liste os plugins que você usa e verifique se já existem versões compatíveis com a 2.0.
- Ambiente separado: mantenha a 1.x funcionando em um diretório enquanto testa a 2.0 em outro, se puder.
- Depois de atualizar: espere erros de carregamento de plugins — eles são esperados, não são falha sua.
- Migração: consulte a documentação do OpenCode para adaptar plugins à API nova antes de reinstalar tudo às cegas.
- Code Mode: se você consome APIs no trabalho, teste o modo MCP/OpenAPI — é o ganho mais concreto da versão.
Por que isso importa para quem está estudando
Essa mudança acompanha uma tendência maior: agentes de IA deixaram de ser "chat com código" e viraram infraestrutura. Rodar um agente como serviço local é o mesmo princípio por trás de plataformas que orquestram múltiplos agentes em produção.
Se você quer entender esse ecossistema, vale ler também nosso guia sobre o openai agentkit agentes de ia, que mostra como frameworks de agentes se conectam a APIs e ferramentas externas.
E se o objetivo é dominar a base, há caminho gratuito: o portal tem um agentes ia salesforce curso gratuito para quem quer aprender a construir agentes sem gastar nada. Confira os detalhes de inscrição no site oficial da plataforma.
Vale a pena migrar já?
Depende do seu cenário. Se seu fluxo atual na 1.x está estável e seus plugins são essenciais, não há pressa: espere as versões compatíveis saírem e migre com calma.
Agora, se você consome APIs externas com frequência ou quer construir integrações com MCP, o Code Mode da 2.0 é argumento forte para migrar logo. A API nova também abre a porta para usar o agente dentro de outras ferramentas do seu setup.
Para estudantes, a recomendação é simples: instale a 2.0 num ambiente de teste, explore o serviço local e a API nova, e trate a quebra de plugins como oportunidade de entender a arquitetura por baixo dos panos.
Conforme noticiado pelo r/brdev — OpenCode 2.0: agent vira serviço local com API nova e Code Mode pra MCP/OpenAPI — plugins da 1.x quebram