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?
  • Como consigo os 5 USD de crédito?
• Em resumo

Dois nomes que não se deve misturar

• OpenCode: o CLI. Você instala uma vez. É software livre, roda como opencode.
• OpenCode Go: a assinatura (~5 USD o primeiro mês, 10 depois) 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 e os modelos abertos. Crie a conta com o link de 5 USD, complete o billing e conecte o Go pelo /connect. O detalhe dos tetos (5 horas / semana / mês) 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.
• 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.

Como consigo os 5 USD de crédito?

Com o link do Go. Eles se aplicam a limites de uso.

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 e barato de testar com o crédito de referido.
• Preços e tetos: os outros dois posts.

👉 Testar OpenCode Go com 5 USD de crédito

---

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