OpenCode, o que é: guia completo do agente de código open source em 2026

O OpenCode é um agente de código open source, sob licença MIT, que roda no terminal, no desktop e na IDE e aceita 75 ou mais providers de modelos via Models.dev. Na prática, ele escreve, edita e revisa código dentro do seu repositório, com diagnósticos automáticos de LSP, sessões múltiplas e links de compartilhamento. Em setembro de 2026, o site oficial opencode.ai informa mais de 195.000 stars, 950 contribuidores, mais de 13.000 commits e mais de 16 milhões de devs por mês (site oficial opencode.ai, set/2026).

Se você escreve código todo dia, a pergunta direta é esta: vale trocar um assistente preso a um vendor por um harness aberto onde você escolhe o modelo por tarefa? Este guia responde com fatos verificáveis. Ele mostra a instalação, o fluxo com AGENTS.md, o custo real dos planos Zen e Go e quando o OpenCode perde para Claude Code ou Codex. Sem promessa mágica, sem jargão de landing page.

Neste pilar você vai entender o que o OpenCode é (e o que ele não é), por que ele cresceu tão rápido em 2026, como ele funciona por dentro, como instalar e versionar o AGENTS.md, quanto custa de verdade e qual agente escolher para o seu caso. Nos pontos que pedem profundidade, este guia aponta para os quatro satélites do cluster. Eles tratam de comandos, comparativo, skills e custo baixo.

• O que é o OpenCode?
• Por que o OpenCode importa em 2026?
• Como o OpenCode funciona na prática?
• Como instalar e configurar o primeiro projeto?
• Quanto custa usar o OpenCode?
• OpenCode vs Claude Code vs Codex: qual escolher?
• Quais são os limites e cuidados antes de adotar?
• Perguntas frequentes
• Conclusão: por onde continuar no OpenCode?

O OpenCode é um agente de programação que opera direto no seu ambiente de desenvolvimento e executa tarefas de código com permissão explícita sua: criar arquivos, refatorar, rodar testes, ler erros do compilador e abrir diffs para revisão. A definição curta, sem jargão, é esta: o OpenCode é um agente de código open source e multissessão que conecta dezenas de providers de modelos ao seu terminal, desktop ou IDE, com contexto versionado em AGENTS.md.

O formato aberto é o ponto central. O projeto é distribuído sob licença MIT, o que permite usar, auditar e adaptar o código sem depender da boa vontade de um fornecedor único (Nimbalyst, 01/fev/2026). Na ponta do modelo, o site oficial fala em mais de 75 providers via Models.dev, além de login com GitHub Copilot e com ChatGPT Plus ou Pro para quem prefere aproveitar assinaturas que já paga (site oficial opencode.ai, set/2026). Na ponta da privacidade, a promessa pública é simples: a ferramenta não armazena o seu código (site oficial opencode.ai, set/2026).

Os componentes que você precisa conhecer são poucos. As interfaces são terminal, desktop e IDE, então dá pra começar no shell e depois levar o mesmo projeto para a interface gráfica sem reaprender tudo (site oficial opencode.ai, set/2026). O LSP automático lê diagnósticos da linguagem enquanto o agente edita, o que reduz aquele ciclo de salvar, compilar, copiar erro e colar no chat. As sessões múltiplas deixam você tocar duas tarefas em paralelo, e os links de compartilhamento registram o que foi feito para revisão ou para pedir ajuda. O Zen aparece como a camada de modelos validados dentro do ecossistema, útil quando você quer trocar de provider sem reconfigurar tudo na mão (site oficial opencode.ai, set/2026).

Também vale dizer o que o OpenCode não é. Ele não é um editor nem um modelo, muito menos um oráculo que aprova PR sozinho. Ele é o harness entre o modelo e o repositório: recebe sua instrução, monta contexto com arquivos e diagnósticos, propõe mudanças e deixa o histórico auditável. Se o modelo alucina uma API, o teste quebra do mesmo jeito. A diferença é que o ciclo de detecção fica mais curto, porque o agente enxerga o erro no lugar onde o erro nasceu.

Se você chegou aqui buscando "o que é opencode" ou "opencode open source", o resumo é este: um harness aberto, sob licença MIT, entre modelos e repositório. Não um modelo único. É essa combinação de código auditável com troca de provider sem reescrever o fluxo que explica por que o projeto aparece em tanta thread sobre self-hosting e modelos locais. E "como usar opencode" começa na seção de instalação, com continuação nos satélites de comandos e skills.

O OpenCode importa em 2026 porque ele transformou portabilidade de modelo em recurso de sobrevivência, não em luxo. Quando um contrato muda, quem está preso a um vendor reescreve o fluxo de trabalho. Quem usa um harness aberto troca o provider e segue commitando.

O episódio que cristalizou essa tese aconteceu em 19 de fevereiro de 2026, quando a Anthropic atualizou os termos e baniu o uso de tokens de assinatura Pro e Max em ferramentas third-party como o OpenCode. A reação foi imediata e mensurável: cerca de 18 mil stars em duas semanas, com a tese do "exit ramp" contra lock-in ganhando tração entre devs (kemalcodes.com, 17/abr/2026). Independentemente de simpatias por qualquer empresa, o recado prático ficou claro. Assinatura barata que só funciona dentro de um app é aluguel. Harness aberto que aceita vários backends é saída de emergência.

a combinação do ban de tokens por assinatura com o pico de stars sugere que parte do crescimento do OpenCode em 2026 foi defensivo, por portabilidade, não só por mérito de produto.

Os números de escala contam a segunda parte da história. Em abril de 2026, o OpenCode passou de 147 mil stars e 6,5 milhões de devs mensais, com velocity de stars cerca de 4,5 vezes maior que a do Claude Code no período (andrew.ooo, 03/mai/2026). Em setembro de 2026, o site oficial registra mais de 195.000 stars e mais de 16 milhões de devs por mês, além de 950 contribuidores e mais de 13.000 commits (site oficial opencode.ai, set/2026).

Em cinco meses, a conta dá algo em torno de 48 mil stars e 9,5 milhões de devs mensais a mais. Crescimento de stars mede atenção, não qualidade, mas atenção sustentada nesse volume costuma atrair contribuidores, e contribuidores viram correções, providers novos e documentação melhor.

A terceira força é a convergência. Em maio de 2026, a análise setorial descreve os três agentes com AGENTS.md em cascata, marketplaces e sessões paralelas, além do lançamento do plano Go de US$10 por mês e do recurso Warping Sessions na versão 1.14.40 de 07 de maio (AIXplore, 12/mai/2026). Quando todo mundo copia formato de contexto e modo paralelo, a disputa sai do checklist. Sobra custo, latência e controle. É exatamente aí que um projeto MIT com 75 ou mais providers via Models.dev tem vantagem estrutural (site oficial opencode.ai, set/2026; Nimbalyst, 01/fev/2026).

O discurso recente de devs confirma o interesse prático, com viés local. O levantamento de 12 de agosto a 11 de setembro de 2026 mostra o tópico "OpenCode for coding" no r/LocalLLM, com 87 pontos e 158 comentários em 18 de agosto. No r/LocalLLaMA, uma thread de 27 de agosto debate construir harness próprio com Qwen local, com 75 pontos (last30days, 12/ago a 11/set/2026). O sinal é duplo: gente usando OpenCode para codar de verdade e gente estudando como reproduzir partes dele com modelo local. Para você, a leitura útil é que saber operar um harness aberto serve nos dois mundos, no modelo de fronteira e no modelo rodando na sua máquina.

O OpenCode funciona como um loop curto entre instrução, contexto e verificação: você pede em linguagem natural, ele lê arquivos e diagnósticos, edita o código e mostra o diff para você aceitar, ajustar ou reverter. A graça está menos no chat e mais no fato de o agente enxergar o repositório como um dev enxerga, com tipos, erros e histórico por perto.

Interfaces: terminal, desktop e IDE

A mesma sessão lógica aparece no terminal, no desktop e na IDE, e o site oficial lista as três superfícies como suportadas (site oficial opencode.ai, set/2026). O terminal é onde o OpenCode brilha para quem vive no shell: dá pra abrir a TUI na pasta do projeto, anexar imagens por drag-and-drop e compartilhar a sessão com /share quando precisa de segunda opinião (docs https://opencode.ai/docs/, atualizado 10/set/2026). O desktop organiza as sessões múltiplas com menos atrito visual, e a integração de IDE aproxima o agente do arquivo que já está aberto. Nada disso exige que você decore três ferramentas. O vocabulário de comandos se mantém, o que muda é o conforto.

Na rotina, dois gestos economizam mais tempo que qualquer flag esperta. A tecla Tab alterna entre Plan e Build, ou seja, entre pensar o plano e executar mudanças, e os comandos /undo e /redo permitem desfazer e refazer em múltiplos passos quando um refactor sai do trilho (docs https://opencode.ai/docs/, atualizado 10/set/2026). Parece detalhe, mas agente de código sem undo confiável vira cassino. Com undo em camadas, dá pra testar uma abordagem agressiva, ver o teste quebrar e voltar sem drama.

Agentes, planos e sessões múltiplas

O modelo mental recomendado tem dois agentes conceituais: um que planeja e um que executa. No modo Plan, você discute escopo, arquivos afetados e riscos antes de tocar no código. No modo Build, o agente aplica as edições e roda verificações. A troca por Tab mantém o contexto, então o plano não se perde quando a execução começa (docs https://opencode.ai/docs/, atualizado 10/set/2026). Para tarefas longas, as sessões múltiplas deixam um refactor rodando enquanto você investiga um bug em outra sessão. Esse paralelismo aparece como convergente entre os três grandes agentes (AIXplore, 12/mai/2026; site oficial opencode.ai, set/2026).

O Warping Sessions, lançado na versão 1.14.40 em 07 de maio, entra nessa mesma linha de paralelismo e retomada de contexto (AIXplore, 12/mai/2026). Na prática de quem programa, isso significa menos "vamos começar do zero" e mais "voltar ao ponto onde a ideia era boa". O diagnóstico via LSP completa o quadro. Em teste com o mesmo modelo no Builder.io, o OpenCode foi cerca de 78% mais lento que o Claude Code, porém mais minucioso. O próprio teste apontou o LSP como recurso distintivo (Nimbalyst, 01/fev/2026). Troca honesta: velocidade contra rigor. Para bug sutil em codebase grande, rigor ganha. Para script de 30 linhas, talvez não.

As skills são a camada que transforma esse loop genérico em comportamento repetível. Em vez de colar o mesmo prompt de revisão toda vez, você registra a instrução como skill e o agente aplica quando o gatilho aparece. A diferença entre commands, agents e skills, como criar um arquivo SKILL.md e como controlar permissões e autoinvocação estão no satélite dedicado, que este pilar resume e o satélite aprofunda: skills no OpenCode.

Sim, dá pra sair do zero a um projeto com contexto versionado com três movimentos: instalar, conectar o provider e gerar o AGENTS.md. O comando de instalação documentado é direto e a configuração inicial cabe em uma sessão curta de terminal (docs https://opencode.ai/docs/, atualizado 10/set/2026).

Comece pela instalação oficial. No macOS ou Linux, o comando documentado é:

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

Depois de instalar, abra a pasta do projeto e inicie a TUI. O comando /connect liga sua conta ou provider ao OpenCode, incluindo as opções de login com GitHub Copilot e ChatGPT Plus ou Pro citadas na página oficial (docs https://opencode.ai/docs/, atualizado 10/set/2026; site oficial opencode.ai, set/2026). Se você prefere modelo local ou outro provider, a lista ampla via Models.dev entra aqui como alternativa, sem travar seu fluxo a um único vendor (site oficial opencode.ai, set/2026).

O segundo movimento é gerar o contexto do repositório. Rode /init na raiz do projeto e revise o AGENTS.md criado. A orientação oficial é commitar esse arquivo, porque ele vira a memória compartilhada entre você, o time e o agente: convenções, comandos de teste, o que nunca fazer naquele repo (docs https://opencode.ai/docs/, atualizado 10/set/2026). Trate esse arquivo como código. Revise o diff, remova segredos, deixe instruções curtas e verificáveis. Um AGENTS.md bom diz como rodar testes, qual gerenciador de pacotes usar e quais pastas são geradas. Um AGENTS.md ruim é um manifesto genérico que o agente ignora na terceira sessão.

O arquivo AGENTS.md na rotina

Na rotina, o AGENTS.md em cascata resolve o dilema entre padrão global e regra local, padrão que a análise de maio de 2026 observa nos três agentes (AIXplore, 12/mai/2026). Você mantém um bloco raiz com o essencial do repo e blocos por pasta para exceções, como regras de migração só no diretório de banco ou estilo de testes só no pacote de UI. Quando algo der errado, /undo e /redo em múltiplos passos desfazem sem apagar o aprendizado, e /share gera o link da sessão para revisão (docs https://opencode.ai/docs/, atualizado 10/set/2026). Anexar um print de erro por drag-and-drop ajuda quando o texto do stack não conta a história toda, como em bug visual ou layout quebrado (docs https://opencode.ai/docs/, atualizado 10/set/2026).

O próximo passo natural depois do setup é dominar o vocabulário diário: sessões, fork, headless, atalhos e os comandos que quase ninguém abre no help. Eles estão organizados no satélite prático: comandos do OpenCode que quase ninguém usa.

O custo do OpenCode cabe em poucos parágrafos porque a estrutura é simples na ponta e detalhada no medidor. O Zen é gratuito com pay-as-you-go a partir de saldo mínimo de US$10. O Go custa US$10 por mês, com o primeiro mês a US$5. E a regra de medição mudou para dollar metering: US$10 compram até US$60 de uso dentro de tetos de US$12 por 5 horas, US$30 por semana e US$60 por mês. As cotas por modelo são de US$15 para cada premium (Grok 4.5, GPT-5.6 Luna, Kimi K3, Qwen3.8 Max e DeepSeek V4 Pro), US$30 para DeepSeek V4 Flash e US$60 para os demais open-weight (PromptGenius, 05/mai/2026; llmgateway.io, 24/ago/2026). O detalhamento com simulações, o setup local com Ollama para custo perto de zero e a escolha de modelos baratos como Kimi e DeepSeek estão no satélite de custo: OpenCode Zen vs Go vs Ollama.

A escolha em 2026 se resume a prioridade, não a fã-clube. O Claude Code é apontado como a melhor experiência pronta para uso. O OpenCode, como a escolha para liberdade de vendor. O Codex, como o mais natural para times centrados em OpenAI. No teste Builder.io com o mesmo modelo, o OpenCode ficou cerca de 78% mais lento, porém mais minucioso, com o LSP como diferencial (andrew.ooo, 03/mai/2026; Nimbalyst, 01/fev/2026). Se você quer ligar e codar sem configurar provider, comece pelo Claude Code. Se você quer trocar de modelo por tarefa, rodar local com Qwen ou similar e manter o contexto em AGENTS.md versionado, o OpenCode tende a pagar o esforço inicial. O comparativo completo com cenários, latência, privacidade e a convergência para AGENTS.md em cascata, marketplaces e sessões paralelas está no satélite dedicado: comparativo OpenCode vs Claude Code vs Codex.

Recorte de set/2026 a partir de andrew.ooo (03/mai/2026), Nimbalyst (01/fev/2026) e The AI Career Lab (jun-ago/2026).

O OpenCode não elimina code review, ele aumenta a taxa de diffs que pedem review. O teste citado com Builder.io deixa o trade-off explícito: com o mesmo modelo, o OpenCode foi cerca de 78% mais lento que o Claude Code, em troca de comportamento mais minucioso (Nimbalyst, 01/fev/2026). Para refactor em monorepo com tipos cruzados, essa lentidão relativa costuma se pagar em menos idas e vindas. Para gerar boilerplate simples, ela vira espera sem retorno. Use o modo Plan para sondar antes de executar, e reserve o Build com verificações ligadas para mudanças que tocam contrato público.

O segundo cuidado é contexto. AGENTS.md em cascata ajuda, mas não faz milagre em repo bagunçado (AIXplore, 12/mai/2026; docs https://opencode.ai/docs/, atualizado 10/set/2026). Se o projeto não tem teste que rode com um comando, o agente vai propor mudanças que você não consegue validar rápido. Antes de culpar o modelo, garanta o básico: README que roda, teste que falha alto e linter configurado. O LSP automático cobre parte do buraco ao trazer diagnósticos para dentro da sessão (site oficial opencode.ai, set/2026; Nimbalyst, 01/fev/2026), mas diagnóstico não substitui suíte de testes. Código sem teste continua sendo aposta, com ou sem agente.

O terceiro cuidado é custo e privacidade por tarefa. Modelo premium para tudo é desperdício. Separe exploração barata de finalização exigente, use Zen com pay-as-you-go para picos e Go com tetos para previsibilidade, dentro dos limites de US$12 por 5 horas, US$30 por semana e US$60 por mês (llmgateway.io, 24/ago/2026; PromptGenius, 05/mai/2026). Para dado sensível, prefira provider com contrato adequado ou modelo local. A promessa pública do projeto é não armazenar seu código, o que é bom. Mas não dispensa revisar o que sai pela rede em cada provider (site oficial opencode.ai, set/2026). O interesse por setups locais com Qwen, visível nas threads de agosto no r/LocalLLM e no r/LocalLLaMA, mostra que parte da comunidade já opera nesse modo híbrido de fronteira mais local (last30days, 12/ago a 11/set/2026).

O quarto cuidado é adoção em time. Defina quem é dono do AGENTS.md, porque arquivo sem dono vira colagem de regras contraditórias em um mês. Combine que toda mudança de comportamento do agente entra por PR com motivo escrito, do mesmo jeito que se revisa config de CI. Use os links de /share para revisar sessões longas antes de aplicar no branch principal, e registre no próprio AGENTS.md os comandos de teste que valem para aquele repo. Harness aberto escala bem quando o contrato de uso está escrito. Sem contrato, escala só a confusão.

• Site oficial: opencode.ai (dados de escala, set/2026)
• Documentação: opencode.ai/docs (instalação, comandos e fluxo, atualizado 10/set/2026) e plano Go
• andrew.ooo (comparativo de mercado, 03/mai/2026)
• Nimbalyst (comparativo técnico, 01/fev/2026)
• Kemal Codes (caso Anthropic x OpenCode, 17/abr/2026)
• AIXplore (análise de arquitetura, 12/mai/2026)
• PromptGenius (guia Zen vs Go, 05/mai/2026)
• LLM Gateway (novo pricing do Go, 24/ago/2026)

O que é o OpenCode em uma frase?

O OpenCode é um agente de código open source que conecta vários providers de modelos ao seu terminal, desktop ou IDE e edita seu repositório com contexto versionado em AGENTS.md. O projeto é MIT, lista mais de 75 providers via Models.dev e declara que não armazena seu código (site oficial opencode.ai, set/2026; Nimbalyst, 01/fev/2026).

Como começo a usar o OpenCode do zero?

Instale com curl -fsSL https://opencode.ai/install | bash, abra a pasta do projeto, rode /connect para ligar o provider e /init para gerar o AGENTS.md, revise o arquivo e faça commit. No dia a dia, use Tab para alternar Plan e Build, /undo e /redo para voltar passos e /share para revisar com o time (docs https://opencode.ai/docs/, atualizado 10/set/2026).

O OpenCode é gratuito?

Dá para começar sem mensalidade no Zen, que é gratuito com pay-as-you-go a partir de saldo mínimo de US$10, e o Go custa US$10 por mês, com o primeiro mês a US$5. No Go com dollar metering, US$10 compram até US$60 de uso dentro dos tetos vigentes (PromptGenius, 05/mai/2026; llmgateway.io, 24/ago/2026). Para custo perto de zero com modelo local e escolha de modelos baratos, veja o satélite de custo: OpenCode Zen vs Go vs Ollama.

Quando prefiro Claude Code ou Codex em vez do OpenCode?

Prefira Claude Code quando quiser a melhor experiência pronta, sem configurar provider, e Codex quando seu time já é centrado em OpenAI. Prefira OpenCode quando liberdade de vendor, troca de modelo por tarefa e contexto aberto pesarem mais, aceitando que ele pode ser mais lento em alguns cenários em troca de análise mais minuciosa (andrew.ooo, 03/mai/2026; Nimbalyst, 01/fev/2026). O cenário completo está aqui: comparativo OpenCode vs Claude Code vs Codex.

O ponto central deste guia é simples: o OpenCode troca lock-in por escolha. São 195.000+ stars e 16M+ devs mensais em setembro de 2026, fluxo com AGENTS.md versionado e diagnósticos de LSP dentro da sessão (site oficial opencode.ai, set/2026). Ele cresceu em 2026 também por reação ao cerco dos vendors, com o episódio dos tokens de assinatura em fevereiro e o pico de 18 mil stars em duas semanas. E segue relevante porque convergência de formato não equaliza custo nem controle (kemalcodes.com, 17/abr/2026; AIXplore, 12/mai/2026). Comece pelo setup mínimo, commite o AGENTS.md, opere em Plan antes de Build e meça custo por tarefa antes de assinar qualquer plano.

Continue aprendendo

Domine a ferramenta:

• comandos do OpenCode que quase ninguém usa
• skills no OpenCode

Escolha e custo:

• comparativo OpenCode vs Claude Code vs Codex
• OpenCode Zen vs Go vs Ollama