OpenCode tutorial: agente IA open source
Liberte-se de planos pagos e restrições: veja como usar o OpenCode, um agente de IA gratuito, open source, para programar do seu jeito, com modelos gratuitos, integração com
Por que isso é importante
OpenCode tutorial: rode o agente OSS (TUI/desktop), /connect nos providers, /init (AGENTS.md), depois Plan → Build com BYO API key. Standalone — não é o stack Antigravity+OpenRouter.
Leitura relacionada: comparativo de AI coding tools · programar com IA sem perder a lógica · guerra das IDEs com IA · Kiro vs Cursor vs Claude Code · curso de Claude Code com 9 dicas.
OpenCode: agente open source no terminal (tutorial)
OpenCode = agente IA open source (TUI/desktop): instale, /connect, /init (AGENTS.md), Plan → Build com BYO key. Chega de escolher entre planos pagos, limites de créditos ou ferramentas fechadas. Este OpenCode tutorial mostra o agente IA de código aberto feito para te dar independência: instalação fácil, modelos gratuitos pré-instalados e integração com qualquer provedor moderno de IA. Use do terminal, web ou desktop, e esqueça as cercas artificiais — você toma o controle.
OpenCode, Claude Code ou Cursor: para quem é cada um
Este guia é o tutorial standalone do OpenCode (install → Plan/Build). A matriz abaixo só posiciona frente a Claude Code e Cursor — sem misturar com o cluster de stack OpenCode+Antigravity+OpenRouter.
OpenCode
Agente open source (TUI/desktop/web), BYO API key ou Zen, /connect + AGENTS.md — troca de provedor sem trocar de ferramenta.
+ Prós
- • Open source
- • Troca de provedor
- • AGENTS.md no repo
− Contras
- • Menos “IDE visual” que Cursor
Claude Code
Agent CLI no ecossistema Anthropic (pago, fluxo “oficial” Claude).
+ Prós
- • Fluxo Claude maduro
- • Bom em agent CLI
− Contras
- • Amarrado ao ecossistema Anthropic
Cursor
IDE com agente embutido, tab complete e indexing de repo.
+ Prós
- • IDE + agent no mesmo lugar
- • Indexing de repo
− Contras
- • Preço e lock-in de workflow de editor
- Precisa de IDE visual + tab complete → Cursor (ou Trae; ver /2025-3/o-trae-pode-nao-ser-o-que-voce).
- Quer agent no terminal com modelo próprio/OpenRouter/Ollama → OpenCode.
- Já paga Anthropic e quer o fluxo Claude “oficial” → Claude Code; use OpenCode quando quiser trocar de provedor sem trocar de ferramenta.
Instalar OpenCode: desktop, terminal ou web
Você escolhe como vai usar: baixe o app desktop para seu sistema (Windows, macOS ou Linux), rode no navegador ou use direto no terminal, inclusive com extensão para VSCode e outros editores. Acesse opencode.ai, clique em download e selecione a versão que quiser. Versatilidade máxima para adaptar ao seu ambiente de trabalho ou estudo.
Atenção
O site detecta seu sistema automaticamente, mas você pode baixar outra versão se quiser. Instale no desktop para uma experiência completa, ou rode em navegador sem instalar nada. Quer integração? Use a extensão do VSCode e turbine seu editor.
OpenCode no desktop: IA poderosa na sua máquina
Ao abrir o app desktop, você encontra tela de projetos recentes, possibilidade de criar novas sessões com contexto independente, painel de revisão automática de código alterado, terminal embutido para rodar sua aplicação e opções visuais de temas rápidos, incluindo modo escuro e layouts customizáveis.
Dica rápida
Simplifique ainda mais a interface: oculte painéis laterais e foque só no prompt se preferir. Atalhos personalizados deixam o fluxo ainda mais rápido.
Terminal: OpenCode direto da linha de comando
Instale o OpenCode no terminal em poucos segundos. Use no shell padrão ou em terminais modernos como Warp, aproveitando recursos de navegação em pastas, histórico, comandos rápidos e integração nativa com agentes de IA. Prático para quem vive na CLI.
Atenção
No terminal você alterna modos do agente com o TAB (construção, planejamento) e pode usar comandos de barra para acessar sessões, temas e outras funções, tudo sem sair do teclado.
OpenCode Web: IA completa direto no navegador
Prefere não instalar nada? Use o OpenCode rodando direto do navegador. Experiência idêntica ao desktop: sessões, painel de revisão, terminal integrado e modelos IA, tudo acessível com um clique.
Modelos prontos e customizáveis: adicione IA aos seus termos
O OpenCode já vem com opções de modelos gratuitos configurados, mas você adiciona qualquer outro provedor: Gemini, GPT, Minimax ou qualquer IA cloud. Basta pegar sua API key, colar e pronto, todos modelos ficam disponíveis, na hora.
Atenção
Suas chaves de API dão acesso aos seus dados e limites — nunca compartilhe elas ou mostre em público. A segurança é sua, mantenha sigilo total!
Como conectar provedores avançados (Gemini, Minimax, outros)
No menu de modelos, clique em conectar provedor, selecione Google, Minimax ou outro, cole sua chave de API. Escolha o model ID vigente no provedor (família Gemini 3.x atual — o preview Gemini 3 Pro foi desligado em mar/2026). Se precisar de uma chave nova, crie no painel da Google ou Minimax — processo rápido e controlado por você.
Atenção
Não encontrou o provedor desejado? Dívida, bug ou limitação momentânea, mas o projeto evolui rápido. Vale checar as docs e comunidades para novidades.
Benchmark: descubra qual IA gratuita se encaixa melhor
Compare desempenho dos agentes: acesse LM Arena AI para ver ranking, categorias e comparativos dos modelos de IA disponíveis para texto, código, edição de imagem e mais. Assim, você escolhe a melhor IA conforme seu objetivo: economia, qualidade, velocidade ou profundidade.
Dica pro
Procure modelos free ou open source com uso generoso — ideal para quem está testando, aprendendo ou evitando gasto agora. Minimax é uma ótima opção gratuita para IA de código.
Acerte na escolha e configure múltiplos modelos no OpenCode
Use mais de um modelo de IA, de provedores diferentes. Você pode alternar entre eles dentro do app. Compare resultados, escolha o que entrega mais para seu workflow e adeque o uso conforme o desafio — algumas tarefas ficam melhores em um modelo, outras em outro.
Plan mode e Build mode: o primeiro workflow real
O OpenCode possui dois modos claros de operação: o modo build permite que o agente reescreva seu código direto, enquanto o modo planejamento só sugere, sem alterar os arquivos. Você decide quando quer IA ativa na prática ou apenas como conselheira estratégica para projetos complexos.
AGENTS.md, /connect e primeiro job Plan → Build
Caminho PT colável (opencode.ai/docs): no repo, rode opencode → /connect (provedor + API key ou Zen) → /init para gerar/atualizar AGENTS.md (build/lint/test, estrutura, convenções). Commit o AGENTS.md. Tab alterna Plan (análise; edit/bash pedem confirmação) e Build (implementação). Primeiro job: Plan descreve mudança pequena → você aprova → Build executa só o escopo. Global opcional: ~/.config/opencode/AGENTS.md; projeto ganha do CLAUDE.md se ambos existirem.
- Instale (script opencode.ai ou npm i -g opencode-ai) → abra o repo → /connect.
- /init → revise AGENTS.md (stack, pastas off-limits, comandos de test) → git commit.
- Tab → Plan: peça plano de uma feature pequena; itere sem escrever código.
- Tab → Build: “implemente o plano aprovado”; use /undo se o diff sair do escopo.
- Ollama/local: útil offline; contexto e qualidade ≠ cloud — não prometa paridade.
Visual limpo e experiência customizável
Ajuste temas (dracula, claro, escuro e outros), configure atalhos e personalize idiomas — inclusive sincronize o tema com o do seu sistema operacional para consistência visual. Todo conforto adaptado ao seu gosto, produtividade no volume máximo.
Integração: expanda seu dev flow, do terminal ao VSCode
O OpenCode funciona bem como app independente, mas via plugin oficial, pode ser integrado direto no VSCode, Cursor e outros editores avançados. Fluxo de trabalho fica ainda mais rápido, com IA presente onde você mais precisa.
Voice to Prompt: vá além digitando, use voz
Aproveite extensões que transcrevem sua fala em prompt para IA, economizando tempo ou otimizando e-mails e comandos complexos. O controle de voz integra perfeitamente e simplifica ainda mais o uso diário.
Atenção
Ferramentas de transcrição são acessórios, não estão incluídas diretamente no OpenCode, mas combinam bem com o fluxo de desenvolvimento assistido.
Próximos passos: do tutorial ao fluxo diário
Agora você sabe: IA livre, sem custos, customizável e pronta para transformar seu modo de programar. Experimente OpenCode, compartilhe suas ideias com a comunidade e não fique dependente das regras das big techs — crie, evolua, hackeie o sistema. E se ficou com dúvida ou quer ver mais dicas, acesse o canal Dev Doido no Youtube para vídeos práticos, sem enrolação!
Atenção
Seu código, seu modelo, seu ambiente — alcance outro nível de autonomia hoje. Refaça seu fluxo de trabalho e foque só em criar!
Fontes
Revisão em agosto de 2026. Modelos Gemini 3.x e IDs de preview mudam (ex.: preview 3 Pro desligado) — valide no painel/API do dia. Fluxos Cursor/VS Code são sugestão de workflow, não ranking universal de IDEs.
Perguntas frequentes
O que é o OpenCode?
OpenCode é um agente de coding open source (terminal/desktop) para programar com IA sem ficar preso a um único vendor de IDE fechada.
Como instalar e usar o OpenCode pela primeira vez?
Instale pelo canal oficial, conecte um provider/modelo (/connect), rode /init se houver AGENTS.md e comece com um refactor pequeno em Plan → Build antes de tarefas grandes.
OpenCode substitui Cursor ou Claude Code?
Não como clone 1:1. Ganha em liberdade e BYO key; polish e fluxo podem diferir. Compare no seu repo — este artigo é tutorial standalone, não o stack Antigravity+OpenRouter.
OpenCode é grátis de verdade?
O software pode ser gratuito/open source; tokens e APIs dos modelos ainda custam. Local (ex.: Ollama) muda a conta, não elimina limite de qualidade/hardware.
Continue explorando
Perguntas frequentes
O que é o OpenCode?
OpenCode é um agente de coding open source (terminal/desktop) para programar com IA sem ficar preso a um único vendor de IDE fechada.
Como instalar e usar o OpenCode pela primeira vez?
Instale pelo canal oficial, conecte um provider/modelo (/connect), rode /init se houver AGENTS.md e comece com um refactor pequeno em Plan → Build antes de tarefas grandes.
OpenCode substitui Cursor ou Claude Code?
Não como clone 1:1. Ganha em liberdade e BYO key; polish e fluxo podem diferir. Compare no seu repo — este artigo é tutorial standalone, não o stack Antigravity+OpenRouter.
OpenCode é grátis de verdade?
O software pode ser gratuito/open source; tokens e APIs dos modelos ainda custam. Local (ex.: Ollama) muda a conta, não elimina limite de qualidade/hardware.
Como conectar provedores avançados (Gemini, Minimax, outros)
No menu de modelos, clique em conectar provedor, selecione Google, Minimax ou outro, cole sua chave de API. Escolha o model ID vigente no provedor (família Gemini 3.x atual — o preview Gemini 3 Pro foi desligado em mar/2026). Se precisar de uma chave nova, crie no painel da Google ou Minimax — processo rápido e controlado por você.