O que é o OpenCode? O agente de código aberto que roda no terminal

Cansa ficar refém de UM modelo só dentro do editor, né?

Tu assina a ferramenta, a empresa escolhe o provedor por ti, e no dia que aquele modelo piora ou encarece tu tem que trocar de ferramenta inteira só pra trocar de modelo

O OpenCode nasce do outro lado dessa história: é um agente de código aberto que ajuda a escrever código no terminal, na IDE ou no desktop, com modelos grátis já inclusos e a possibilidade de plugar qualquer modelo de qualquer provedor, incluindo Claude, GPT e Gemini

Nesse post tu sai sabendo o que é o OpenCode, pra quem ele serve, quanto custa e quando ele realmente faz sentido 🙂

Quem faz o OpenCode e por que ele é aberto de verdade

Antes de sair instalando, vale saber de onde vem a coisa

O repositório oficial é o anomalyco/opencode, e é na própria página do projeto no GitHub que consta a manutenção pela Anomaly, o time por trás do SST

Ou seja, não é boato de timeline: tu pode abrir o link e conferir a fonte tu mesmo

Se tu já viu o endereço antigo sst/opencode por aí, relaxa: ele aponta pra lá

Formação Recomendada

Formação Vibe Coding

Do Prompt ao Produto: Crie Software Real com IA

• 474 aulas
• 20 projetos
• 39h 27min

Conhecer formação

E o "aberto" aqui não é figura de linguagem: o código é público no GitHub sob licença MIT

Ou seja, tu pode ler, auditar e entender o que a ferramenta faz na tua máquina, em vez de confiar na palavra de alguém

Como leitura de tração, o repositório está em cerca de 192 mil estrelas, 945 contribuidores e 24,5 mil forks

Esse número de contribuidores é o dado que eu mais olho, sinceramente

Projeto com muita estrela e três gatos pingados commitando é risco de abandono; projeto com centenas de pessoas mexendo tem muito mais chance de continuar vivo daqui a um ano

Para quem o OpenCode serve (e para quem não serve)

Ele serve bem pra quem já vive no terminal e não quer sair de lá pra conversar com um agente

Serve pra quem quer trocar de modelo sem trocar de ferramenta, testando um modelo mais barato pra tarefa boba e um mais forte pra refatoração pesada

Serve pra quem precisa usar a chave própria de provedor, seja por política da empresa, seja porque já tem crédito comprado e não quer pagar duas vezes

Serve pra quem quer começar sem gastar nada, já que a página oficial afirma que modelos grátis vêm inclusos

E serve muito pra quem quer auditar o código da ferramenta, porque MIT e repositório público significam que dá pra abrir e ler

Se tu tá escolhendo entre agentes de terminal, também vale comparar o OpenCode com o Codex antes de fechar questão

Agora o outro lado: se tu quer tudo dentro de uma interface gráfica fechada, com botão pra tudo e zero decisão na tua mão, o OpenCode provavelmente vai te irritar

Ele assume que tu topa passar pelo terminal: conectar o provedor com opencode auth login e escolher o modelo com /models dentro da sessão

Os recursos que a página oficial cita

Dá pra resumir o "por dentro" dele em cinco coisas

Ferramentas nativas de código. O agente lê, escreve e edita arquivos, executa comandos no shell configurado e busca no projeto com grep, glob e listagem de diretórios

Integração com LSP. O OpenCode integra servidores LSP e usa os diagnósticos do Language Server Protocol como feedback pro agente, configurável pela opção lsp

Na prática é o agente enxergando o mesmo errinho vermelho que tu enxerga na IDE, em vez de escrever no escuro

Se esse ponto te interessa, tem um post inteiro sobre o que o LSP agrega ao agente

Suporte a MCP. Ele aceita ferramentas externas via MCP (Model Context Protocol), com servidores locais e remotos, e as ferramentas MCP ficam disponíveis ao modelo junto das nativas

"Que MCP?" É o protocolo que deixa tu plugar ferramentas de fora no agente, tipo acesso a um banco, a uma API interna, a um serviço teu

Permissões por agente. Cada chave de permissão pode ser definida como permitir, pedir aprovação antes de executar ou negar (allow, ask, deny)

Aqui mora o teu guardrail contra os rm -rf da vida, se liga nisso

Interface de terminal configurável. As configurações específicas da interface de terminal ficam no arquivo ~/.config/opencode/tui.json

Como instalar e rodar o OpenCode pela primeira vez

Vamos ver na prática?

1. Instale pelo script universal. É o caminho mais direto:

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

2. Ou instale pelo npm, se tu já tem Node na máquina (foi o que eu fiz no vídeo, por preguiça mesmo haha):

npm install -g opencode-ai

O erro comum desse passo é escolher o npm sem ter Node instalado e ficar brigando com mensagem de comando não encontrado; nesse caso, vai de script

3. Conecte um provedor de modelo antes de tentar usar:

opencode auth login

As credenciais ficam salvas em ~/.local/share/opencode/auth.json, e a lista de provedores é alimentada pelo Models.dev

O erro comum aqui é achar que a credencial sumiu depois de mexer na instalação: ela mora nesse arquivo, não dentro da pasta do teu projeto

4. Escolha o modelo dentro da sessão com o comando /models, que abre a seleção entre os provedores configurados, no formato provedor/modelo

O erro comum é sair pedindo código antes de conectar provedor e escolher modelo, e depois achar que a ferramenta está quebrada

5. Navegue até a pasta do projeto, rode o OpenCode ali e peça a inicialização. O agente analisa o projeto e cria um arquivo AGENTS.md na raiz

Tome cuidado com esse passo: se tu rodar na pasta errada, o agente vai analisar o que não é o teu projeto e o AGENTS.md nasce torto

O que eu notei usando o OpenCode no dia a dia

Primeira coisa: antes de sair usando, eu abri o repositório e li a documentação oficial

Parece papo de tiozão, mas a fonte fiel de informação é sempre a documentação, não a opinião de quem usou dez minutos

Depois de instalar, rodei o comando e a ferramenta abriu direto, sem configuração extra

O detalhe é que ela pede um provedor conectado antes de trabalhar, e a seleção de modelo PERSISTE entre sessões e entre projetos diferentes

Prova disso: eu tinha desinstalado a ferramenta antes de gravar, justamente pra refazer o processo do zero junto com o público, e mesmo assim a credencial antiga continuou salva em ~/.local/share/opencode/auth.json, fora da pasta do projeto, com modelo já selecionado 😀

Meu primeiro teste foi bobo de propósito: perguntei em qual pasta eu estava e quais arquivos existiam ali

A resposta veio certinha, apontando o diretório e avisando que não havia arquivos visíveis

Aí eu subi a régua e mandei criar um portfólio de desenvolvedor com HTML, CSS e JavaScript: página única, header, hero, seção de skills em cards, seção de projetos, footer, tema escuro e responsivo

O que eu mais gostei foi acompanhar o processo pelo terminal: o raciocínio na tela, o pedido quebrado em tarefas e o código aparecendo arquivo por arquivo, HTML, depois CSS, depois JavaScript, até concluir

E olha, a interface dele no terminal é mais bonita e mais cuidada que a da maioria das ferramentas do tipo, que geralmente ficam no visual padrão mesmo

Duas coisas que mudaram meu resultado:

Apontar o arquivo específico dentro do pedido, em vez de descrever "aquele arquivo do topo", deixa o pedido MUITO mais preciso e ainda economiza token

E usar um subagente com poder só de leitura, que não executa nada, pra varrer o projeto e contar linhas de código

Esse subagente trabalha em paralelo ao agente principal fazendo a análise exploratória, e a garantia de que ele não altera nada é ótima quando tu só quer entender o projeto ou caçar falha

Em projeto pequeno isso quase não aparece, em projeto real faz diferença

Quando comecei um projeto maior (um app com IA embutida pra escrever posts e e-mails), a primeira coisa que fiz foi mudar pro modo de planejamento antes de deixar a ferramenta executar

Isso é fundamental no começo de qualquer projeto ou funcionalidade grande, faça o teste!

E reparei numa coisa: com prompt bem descrito, ela seguiu direto sem me perguntar nada; com prompt ambíguo, ela costuma voltar com perguntas antes de fechar o plano

Vídeo: OpenCode na prática

No vídeo abaixo eu mostro tudo isso em movimento: a instalação, a conexão do provedor, a troca de modelo e o uso real no terminal, do teste bobo até o projeto rodando

Quanto custa o OpenCode: grátis, Go, Zen e Black

Dá pra começar sem pagar, e as opções pagas são separadas assim:

Repara no ponto do Go que quase ninguém lê: o limite é por VALOR de uso, não por contagem de requisição

Isso muda o teu comportamento, porque escolher um modelo mais barato pras tarefas simples estica o mês inteiro

Quando o OpenCode faz sentido (e quando não faz)

Faz sentido quando a liberdade de modelo é inegociável pra ti: tu escolhe o provedor, tu troca quando quiser, tu não fica preso à decisão comercial de uma empresa só

Faz sentido quando tu quer custo ligado ao uso, testando de graça e subindo pro Go só se o volume justificar

Faz sentido quando código aberto auditável importa, seja por curiosidade, seja por política da tua empresa

E faz sentido quando teu fluxo já é terminal: tu roda na pasta do projeto e segue a vida

Agora, se tu está confortável na ferramenta que já usa, com o modelo que já te atende, e não tem paciência pra conectar provedor e configurar permissão, não tem por que migrar por hype

Troca de ferramenta custa tempo, e tempo é a única coisa que a IA ainda não devolve pra ninguém haha

Próximo passo

Resumindo: o OpenCode é um agente de código aberto (MIT, repositório público) que roda no terminal, na IDE ou no desktop, com modelos grátis inclusos e conexão a qualquer provedor

A premissa é essa, tu no controle do modelo em vez de ficar preso ao provedor de uma empresa, e o pacote (LSP, MCP, permissões por agente, ferramentas nativas) é completão o bastante pra brigar de igual

Ação concreta pra hoje: instala, roda na pasta de um projeto REAL, pede a inicialização pra gerar o AGENTS.md e depois faz a mesma tarefa com dois modelos diferentes pra sentir a diferença na pele

Dá o play no vídeo pra ver o passo a passo em movimento, e passa nos outros posts do blog sobre agentes de código pra comparar as opções antes de escolher a tua

até o próximo post! =)