Como usar o OpenCode: o assistente de IA de código aberto que já ultrapassou 170 mil estrelas no GitHub

Renê Fraga
14 min de leitura

Principais destaques

  • 💻 O OpenCode é um agente de IA de código aberto que roda direto no terminal, funciona com mais de 75 provedores de modelos (incluindo Claude, GPT, Gemini e modelos locais) e já passou de 170 mil estrelas no GitHub, tornando-se o agente de codificação open source mais popular do mercado.
  • 🔄 Desde janeiro de 2026, é possível autenticar o OpenCode diretamente com uma assinatura paga do GitHub Copilot, depois que a Anthropic bloqueou o login via OAuth de contas Pro/Max em clientes de terceiros.
  • 🔒 Diferente de assistentes baseados em nuvem, o OpenCode não envia seu código para servidores remotos por padrão: você escolhe o provedor de modelo, e pode até rodar tudo localmente com modelos como os disponíveis via Ollama.

A inteligência artificial deixou de ser apenas uma ajudante e está se tornando uma verdadeira parceira de programação. Nos últimos anos, ferramentas como GitHub Copilot e ChatGPT transformaram a forma como código é escrito, mas a maioria delas vive dentro de editores ou navegadores.

O OpenCode, um projeto de código aberto, segue um caminho diferente: leva um assistente de IA direto para dentro do seu terminal, permitindo escrever, depurar e refatorar código usando linguagem natural, tudo sem sair da linha de comando. Este guia explica o que é o OpenCode, como instalá-lo, como ele lida com contexto e privacidade, e traz prompts prontos para você começar a usar hoje.

🖥️ O que é o OpenCode

O OpenCode é um agente de codificação com IA, de código aberto, que roda dentro do seu terminal. Foi construído para desenvolvedores que preferem a velocidade da linha de comando, mas ainda querem a inteligência dos modelos de IA modernos. Dá para pensar nele como ter um assistente parecido com o Claude Code embutido no seu ambiente de desenvolvimento local, com a diferença de ser totalmente aberto e sob seu controle.

O projeto é mantido no repositório sst/opencode (que hoje redireciona para anomalyco/opencode, refletindo a mudança de nome da organização mantenedora, que cresceu a partir do time da SST) e rapidamente se tornou uma das ferramentas de IA para desenvolvedores mais populares do mundo open source.

Em meados de 2026, o projeto já ultrapassava 170 mil estrelas no GitHub e mais de 21 mil forks, com mais de 7,5 milhões de desenvolvedores usando a ferramenta mensalmente, o que o coloca à frente de praticamente todos os concorrentes pagos em rankings recentes de ferramentas de desenvolvimento com IA.

Vale um esclarecimento sobre a história do projeto: a versão original do OpenCode era escrita em Go. Depois de uma divisão em 2025, esse código em Go foi arquivado e passou a ser mantido separadamente sob o nome Crush, enquanto o time por trás do nome OpenCode reconstruiu o projeto do zero em TypeScript. Quando desenvolvedores falam em “OpenCode” hoje, quase sempre estão se referindo a essa versão em TypeScript.

🤔 Por que usar o OpenCode

A maioria dos assistentes de codificação com IA funciona dentro de editores como VS Code ou ferramentas da JetBrains. O OpenCode, por outro lado, vive no seu terminal, o que significa que consegue trabalhar com qualquer linguagem, qualquer editor e qualquer ambiente. Dá para usá-lo enquanto se constrói um back-end em Go, um front-end em React, ou até ao gerenciar scripts de infraestrutura.

O OpenCode usa o contexto do seu projeto para entender seu código em profundidade. Ele varre seus arquivos, reconhece dependências e mantém contexto entre vários comandos, o que permite operações complexas como refatorar vários arquivos de uma vez, adicionar novos recursos a partir de instruções em linguagem natural, explicar erros e sugerir correções, e revisar seu código antes de você fazer o commit. Tudo isso acontece sem a necessidade de enviar seu código para a nuvem por padrão, o que é uma vantagem importante para times que lidam com bases de código privadas ou sensíveis.

Um diferencial técnico relevante é a integração com o Language Server Protocol (LSP): o OpenCode consegue receber diagnósticos reais do compilador depois de cada edição, o que ajuda o modelo a corrigir seus próprios erros com mais precisão do que apenas inferindo a partir do texto do código.

⚙️ Como o OpenCode funciona, na prática

O OpenCode conecta seus arquivos locais, o histórico do Git e os modelos de linguagem entre si. Quando você roda um comando pedindo para explicar uma função, ele reúne contexto dos arquivos em que você está trabalhando, passa isso para um modelo de IA, e mostra a resposta direto no terminal.

Instalação, com um único comando:

bash

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

Também é possível instalar via gerenciador de pacotes:

bash

npm i -g opencode-ai@latest
# ou, no macOS:
brew install sst/tap/opencode

Depois de instalado, basta rodar opencode para abrir a interface interativa de terminal, onde é possível conversar, executar tarefas e deixar a IA fazer edições automaticamente. O OpenCode é alimentado pela lista de provedores do Models.dev, com suporte a mais de 75 opções, incluindo Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, OpenRouter, e modelos locais via Ollama.

Um ponto importante e recente: em janeiro de 2026, a Anthropic passou a bloquear o login via OAuth de contas Pro/Max em clientes de terceiros, o que afetou diretamente quem usava o OpenCode com essas assinaturas. Uma semana depois, o próprio OpenCode respondeu adicionando suporte a autenticação direta com uma assinatura paga do GitHub Copilot (nos planos Pro, Pro+, Business ou Enterprise), usando um fluxo de código de dispositivo. Na prática, isso significa que quem já paga pelo Copilot não precisa de uma conta ou licença de IA separada para usar o OpenCode.

Depois de instalado, entre no repositório do seu projeto, rode opencode e digite /init para que a ferramenta analise seu repositório e crie um arquivo de regras do projeto, chamado AGENTS.md (ou, se você migrou de outra ferramenta como o Claude Code, ele reconhece automaticamente um CLAUDE.md já existente).

Prompt para o primeiro contato com um repositório desconhecido:

O que este repositório faz? Descreva a arquitetura geral, as principais
dependências e onde fica o ponto de entrada da aplicação.

🧠 O poder do contexto

Um dos maiores pontos fortes do OpenCode é como ele lida com contexto. Chatbots tradicionais perdem o fio do que você está fazendo depois de algumas trocas de mensagem. O OpenCode não. Ele lembra da sua base de código, entende importações e mantém rastreamento de arquivos relacionados, o que o faz funcionar mais como um assistente de desenvolvimento real do que como uma ferramenta isolada.

Digamos que você peça: “adicione autenticação ao meu aplicativo Express.js”. O OpenCode vai varrer seu projeto, identificar onde as rotas estão definidas, criar um middleware de login, e até sugerir onde armazenar tokens de forma segura.

Prompt de exemplo para uma tarefa completa com contexto:

Adicione autenticação por JWT ao meu aplicativo Express.js. Identifique
onde as rotas já estão definidas, crie um middleware de verificação de
token, e sugira onde armazenar o token de forma segura no lado do
cliente. Não modifique rotas que já não exigem autenticação.

O OpenCode também opera em dois modos distintos: um modo de planejamento, somente leitura, útil para explorar mudanças antes de aplicá-las, e um modo de construção completo, com acesso total às ferramentas para editar e executar comandos. Também é possível definir subagentes personalizados, que combinam ferramentas MCP específicas para tarefas de domínio.

Prompt para explorar uma mudança em modo de planejamento antes de aplicar:

No modo de planejamento, avalie o que seria necessário para migrar este
projeto de JavaScript para TypeScript. Liste os arquivos afetados, a
ordem recomendada de migração e os riscos envolvidos, sem fazer nenhuma
alteração ainda.

🔐 Privacidade e controle

Um motivo importante pelo qual desenvolvedores gostam do OpenCode é o controle. Diferente de assistentes baseados em nuvem, o OpenCode não envia seu código para servidores remotos por padrão. Você escolhe o provedor de modelo e o que é compartilhado. Se você roda um modelo local, todo o seu fluxo de trabalho permanece privado, o que é especialmente importante para empresas com regras rígidas de proteção de dados: times conseguem integrar IA com segurança em seus fluxos sem quebrar conformidade ou arriscar vazamentos.

A ferramenta também se integra a sistemas de controle de versão como o Git. Toda mudança sugerida pela IA pode ser visualizada antes do commit, e você pode aceitar, rejeitar ou modificar essas sugestões, praticamente como em um pull request, o que mantém transparência e o desenvolvedor humano no comando.

Prompt para revisão antes de commit:

Revise as mudanças pendentes neste diretório de trabalho, resuma o que
foi alterado em cada arquivo, e aponte qualquer coisa que pareça
arriscada ou fora do escopo do que foi pedido originalmente, antes de eu
fazer o commit.

🛠️ Casos de uso reais

Desenvolvedores usam o OpenCode de formas bastante variadas. Engenheiros de back-end o usam para gerar rotas de API. Times de front-end o usam para corrigir erros de TypeScript. Engenheiros de DevOps dependem dele para gerar scripts Terraform e Dockerfiles. Até pesquisadores e estudantes acham útil para explorar bases de código novas, simplesmente perguntando coisas como “o que este repositório faz?” ou “onde fica o ponto de entrada?”, recebendo resumos claros e gerados por IA de projetos complexos.

Prompt para gerar um Dockerfile a partir do projeto atual:

Analise a stack deste projeto e gere um Dockerfile de produção otimizado,
com build em múltiplos estágios, seguindo boas práticas de segurança
(usuário não root, imagem base mínima). Explique cada etapa do arquivo.

Prompt para corrigir erros de TypeScript em lote:

Rode a checagem de tipos do projeto, liste todos os erros encontrados
agrupados por arquivo, e corrija cada um deles, explicando brevemente a
causa antes de aplicar a correção.

A flexibilidade do OpenCode significa que ele se encaixa em praticamente qualquer fluxo de trabalho. Ele não substitui suas ferramentas, ele as complementa: seja você usuário de Vim, VS Code ou de IDEs da JetBrains, o OpenCode funciona ao lado da sua configuração já existente.

👥 Comunidade e ecossistema

O OpenCode não é apenas uma ferramenta, é uma comunidade em crescimento. As discussões no GitHub do projeto e o Discord estão cheios de contribuidores compartilhando fluxos de trabalho, plugins e dicas de configuração de modelo. Os mantenedores, hoje parte do time Anomaly (que cresceu a partir da SST), são conhecidos por construir ferramentas que simplificam o desenvolvimento em nuvem e com IA, e continuam lançando atualizações com bastante frequência, muitas vezes mais de uma versão por dia.


O OpenCode representa um ponto de virada em como desenvolvedores interagem com IA. É de código aberto, respeita a privacidade por padrão, e está profundamente integrado ao terminal, o que o torna ao mesmo tempo poderoso e flexível.

Enquanto outros assistentes são construídos em torno de IDEs específicas ou serviços de nuvem fechados, o OpenCode mantém o desenvolvedor no centro da decisão, com suporte a mais de 75 provedores de modelo e a opção real de rodar tudo localmente.

Com sua comunidade em crescimento, arquitetura inteligente e compromisso com privacidade, somado à recente integração com assinaturas do GitHub Copilot, o OpenCode não é apenas mais um assistente de codificação, é um sinal de para onde o desenvolvimento de software assistido por IA está caminhando: um futuro em que o terminal se torna a parte mais inteligente do seu fluxo de trabalho.

Apoie o Eurisko
Este conteúdo é independente, sem anúncios e feito por pessoas.
A inteligência artificial e as mudanças recentes do Google reduziram significativamente o alcance dos sites independentes. Se este conteúdo foi útil para você, considere apoiar o Eurisko e todo o ecossistema de projetos com qualquer valor.
Quero apoiar
Seguir
Renê Fraga é fundador e editor-chefe do Eurisko, ecossistema editorial independente dedicado à inteligência artificial, código aberto, tecnologia e cultura digital. Atuando com projetos online desde 1996, escreve há mais de 20 anos sobre tecnologia e inovação, acompanhando a evolução da internet e o impacto das novas tecnologias na forma como vivemos, trabalhamos e pensamos.
Nenhum comentário