Como instalar OpenCode e programar com IA passo a passo

Índice

• Dois nomes que não se deve misturar
• Passo a passo

  • 1. Instale o CLI do OpenCode
  • 2. Confirme que roda
  • 3. Conecte um provedor
  • 4. Entre em um repo real
  • 5. Envie a primeira tarefa
• Se algo falhar
• Perguntas frequentes

  • OpenCode e OpenCode Go são a mesma coisa?
  • Posso instalar com Homebrew ou Scoop?
  • Preciso de uma GPU potente?
  • Quanto custa o OpenCode Go?
• Em resumo

Os posts que já escrevi sobre OpenCode são de preço e tetos de uso: Go a 10 USD e Zen vs Go. Este não. Este é sobre como deixar o programa instalado e respondendo no seu repo.

O OpenCode é um agente de código que vive no terminal (TUI). Não é um IDE. Não substitui o VS Code. É a peça que abre o projeto, lê arquivos e propõe mudanças com o modelo que você conecta a ele.

Se você usar o OpenCode Go, ele custa 10 USD por mês desde o primeiro mês. O Go Plus custa 40 USD por mês quando você precisa de mais cota. Já não há primeiro mês a 5 USD nem crédito de indicação. A assinatura está em opencode.ai/go.

Atualizado em 30 de setembro de 2026.

Dois nomes que não se deve misturar

• OpenCode: o CLI. Você instala uma vez. É software livre, roda como opencode.
• OpenCode Go: a assinatura de 10 USD por mês (Go Plus, 40 USD) com modelos abertos e tetos de uso. É um provedor que você pode conectar. Não é obrigatório para instalar o CLI.

Você pode instalar o OpenCode hoje e conectar a API da Anthropic, Z.ai ou outra. O Go é o atalho se você não quiser administrar dez API keys.

Passo a passo

1. Instale o CLI do OpenCode

A doc oficial v2 dá esses caminhos. Escolha um:

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

pnpm add -g --allow-build=@opencode/cli @opencode/cli

yarn global add @opencode/cli

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

O pacote do npm usa um script de postinstall de confiança para baixar o binário nativo da sua plataforma. Por isso bun e pnpm pedem a flag de --trust / --allow-build.

O que não usar, segundo essa mesma doc: Homebrew, AUR, Scoop, Chocolatey nem um .exe solto de um mirror. Tutoriais de 2025 que dizem brew install opencode estão desatualizados em relação à v2.

Docker existe (ghcr.io/anomalyco/opencode com tags de versão) se o seu fluxo é container. Para o primeiro dia, npm ou o script bastam.

2. Confirme que roda

Feche e abra o terminal (o PATH às vezes não se atualiza). Depois:

opencode

Tem que abrir a TUI, não command not found. Se o script do curl instalou em um diretório que seu shell não carrega, abra uma sessão nova ou faça source do seu .bashrc / .zshrc.

Não precisa de GPU. Não precisa de opencode tui como subcomando mágico: o binário sem argumentos lança a interface.

3. Conecte um provedor

Dentro da TUI, o comando é:

/connect

Ali você escolhe o provedor. Caminhos razoáveis:

• OpenCode Go: se você quer o plano de 10 USD (ou Go Plus a 40) e os modelos abertos. Crie a conta em opencode.ai/go, complete o billing e conecte o Go pelo /connect. O detalhe dos tetos está no post de preços; aqui só importa que a sessão autentique.
• Z.ai / GLM: se você já tem o Coding Plan, conecte como provedor custom com o endpoint de coding. Não misture a key de chat genérico.
• Anthropic, OpenAI ou outro: /connect e cole a key. O OpenCode traz vários de fábrica.

Sem provedor, a TUI é uma carcaça vazia. O erro típico do dia um não é "não instala": é abrir o opencode sem ter conectado nada.

4. Entre em um repo real

cd /caminho/do/seu/projeto
opencode

O agente vê os arquivos de esse diretório. Se você lançar no $HOME, ele vai querer opinar sobre o seu disco inteiro. Não faça isso.

Se o projeto já tem um AGENTS.md ou um opencode.json, ele respeita. Se não, você pode inicializar depois; não bloqueia o primeiro prompt.

5. Envie a primeira tarefa

Peça algo que você possa verificar sem fé:

• "O que faz o src/auth.ts?"
• "Escreva um teste para esta função e não toque no resto."

Se editar o arquivo certo e o diff fizer sentido, a instalação está pronta. Só então vale a pena falar de MCP, plugins e temas — a doc de customize existe para o dia 2.

Se algo falhar

• command not found: PATH. Reabra o terminal. No npm global, às vezes falta o prefixo do npm no PATH do Windows.
• O postinstall do npm travou: é o script que baixa o binário. No bun/pnpm você precisou ter passado --trust / --allow-build.
• Qualquer outro erro de instalação: o postinstall que não roda, o brew install que não existe, o PATH do Windows: cada um tem solução em os erros comuns de instalação do OpenCode e suas soluções.
• A TUI abre mas o modelo não responde: não é a instalação, é o /connect. Revise a key e o provedor.
• O Go se esgota no meio da tarde: é o teto de uso, não é um bug do CLI. Isso está explicado no post de limites.

Perguntas frequentes

OpenCode e OpenCode Go são a mesma coisa?

Não. CLI vs assinatura de modelos. Você pode usar o CLI sem o Go.

Posso instalar com Homebrew ou Scoop?

Não segundo a doc v2. npm/bun/pnpm/yarn ou o script opencode.ai/v2/install.

Preciso de uma GPU potente?

Não para o Go nem para APIs na nuvem.

Quanto custa o OpenCode Go?

10 USD por mês desde a primeira cobrança. O Go Plus custa 40 USD por mês. O detalhe dos limites está no post de preços. Não há crédito de indicação.

Em resumo

• Instale o CLI pela via oficial v2, não por um brew de um blog.
• /connect é o passo que a gente pula.
• Lance o opencode dentro do repo.
• O Go é opcional: 10 USD por mês, ou 40 USD no Go Plus.
• Preços e tetos: os outros dois posts.

O plano, se você quiser, está em OpenCode Go.

Se você está montando o seu kit de ferramentas de programação com IA e vai pagar licenças ou assinaturas, na Eneba você consegue 5% de desconto com o meu link. É um link de afiliado: para você sai mais barato e para mim ajuda a manter o blog. Se for para o seu time, aqui explico como comprar licenças de software baratas na Eneba. Os 5% aplicam-se com o código CreaCosas no pagamento, desde que entre pelo link.

---

Se você já tem o agente na cabeça e falta "fazer rodar nesta máquina", você não precisa de outra comparação. Precisa de um install que a doc oficial ainda respalde.

— Leandro Valencia