OpenCode (OpenCLAW)
Como instalar, configurar e usar com segurança a alternativa open-source ao Claude Code — passo a passo, com riscos explicados.
Agente de código no terminal, sem lock-in
OpenCode (apelidado de OpenCLAW pela comunidade) é um agente de IA open-source para programação que roda direto no seu terminal. Diferente do Claude Code, é agnóstico de provedor — você escolhe entre Anthropic, OpenAI, Google, Groq, OpenRouter ou modelos locais via Ollama — e o código é 100% auditável (MIT).
curl -fsSL https://opencode.ai/install | bash export ANTHROPIC_API_KEY=sk-ant-... cd meu-projeto && opencode
O que o OpenCode pode fazer
Não é só autocomplete. É um agente que lê o repositório, planeja, edita arquivos, roda comandos, valida o resultado e te entrega o diff.
Cria rotas, componentes, schema de banco, migration e testes a partir de uma descrição em linguagem natural.
Move, renomeia e extrai módulos atualizando todos os call sites via LSP. Sugere diffs revisáveis antes de aplicar.
Indexa o projeto, responde 'onde mora X?', desenha o fluxo de uma feature e gera onboarding técnico em minutos.
Você cola o stack trace ou o log; ele localiza a causa raiz, propõe o fix, roda os testes e mostra o diff.
Cria suíte de testes unitários e de integração, executa, lê a saída vermelha e itera até passar.
JS→TS, REST→tRPC, Express→Fastify, Pages Router→App Router. Faz por arquivo com checkpoints.
Gera README, ADRs, JSDoc/TSDoc e changelog a partir do histórico do git e do código atual.
Escreve Dockerfile, GitHub Actions, Terraform/CDK. Lê erros de CI e abre PR de correção.
Modela schema, gera migrations, otimiza queries SQL lentas e cria seeds com dados realistas.
Sobe versões de dependências, resolve breaking changes, lê CHANGELOGs e adapta o código.
Roda contra um PR local apontando smells, riscos de segurança, cobertura faltante e sugestões.
Conecta a servidores MCP (Linear, Jira, Notion, Postgres, Playwright) e usa ferramentas reais durante a sessão.
Exemplos práticos do dia a dia
Prompts reais que você pode digitar dentro da TUI — e o que o agente faz a partir deles.
> Adicione login por e-mail/senha usando Supabase. Crie /login, /signup, proteja /dashboard e mostre o e-mail no header.
- 1Lê o package.json e detecta o stack (Next, Vite, etc.)
- 2Instala @supabase/supabase-js e cria o client
- 3Gera as páginas, o middleware de proteção e o componente de header
- 4Roda o lint e mostra o diff para você aprovar
> Tô recebendo 'TypeError: Cannot read properties of undefined (reading map)' em /api/orders. Aqui está o stack: …
- 1Busca o handler /api/orders no repositório
- 2Identifica que o retorno do Supabase pode vir null
- 3Adiciona guarda e teste de regressão
- 4Roda os testes — passa — e propõe o commit
> Tem lógica de formatar moeda repetida em 6 componentes. Extraia para um hook useCurrency e atualize todos.
- 1Faz grep semântico pelos 6 usos
- 2Cria hooks/useCurrency.ts com opções pt-BR/USD
- 3Atualiza cada componente substituindo a função inline
- 4Roda typecheck e testes
> A GitHub Action 'deploy' falhou. Aqui o log: … Conserta.
- 1Lê o YAML em .github/workflows/deploy.yml
- 2Identifica que o Node 18 não suporta o pacote novo
- 3Sobe para Node 20 e ajusta cache
- 4Sugere abrir PR com a correção
> Esse repo não tem README. Gera um com instalação, scripts, stack, estrutura de pastas e exemplos.
- 1Lê package.json, tsconfig, estrutura de src/
- 2Detecta scripts npm e variáveis de ambiente
- 3Escreve README.md em PT-BR com seções padronizadas
- 4Cria também um .env.example
> Converta progressivamente o diretório src/lib de JS para TS, mantendo tudo funcionando entre commits.
- 1Configura tsconfig com allowJs
- 2Converte arquivo a arquivo inferindo tipos
- 3Roda os testes a cada conversão
- 4Para se algo quebrar e pede orientação
Problemas do dia a dia que ele resolve
Situações reais em que o OpenCode encurta horas de trabalho braçal.
Novo dev leva 2 semanas para se localizar num monólito de 500k linhas.
Issues 'fáceis' acumulam porque ninguém quer parar feature para resolver.
Time não escreve testes porque já está atrasado em entregas.
README e ADRs nunca acompanham o código real.
Seniores ficam horas por dia revisando PRs com problemas óbvios.
Pular várias versões major vira projeto de mês, então ninguém faz.
Impacto no desempenho das empresas
Por que times de engenharia estão adotando agentes como OpenCode — e o que muda nos números do negócio.
Custo de testar uma hipótese cai; o time roda 2–3× mais experimentos no mesmo orçamento, acelerando aprendizado de produto.
Refatorações e upgrades que ficavam parados saem porque o esforço marginal é baixo. Base de código envelhece menos.
Novo contratado conversa com o agente sobre o repositório no primeiro dia. Tempo para primeira PR cai de semanas para dias.
Por ser open-source e multi-provedor, a empresa troca de modelo conforme preço e qualidade — não fica refém de um único contrato.
Rodando com Ollama on-prem, código sensível nunca sai da rede da empresa — viabiliza uso em bancos, saúde e setor público.
Regras em opencode.json e skills compartilhadas garantem que todo dev receba as mesmas convenções, testes e checks.
Números são referências de mercado (DORA 2024, GitHub Copilot studies, McKinsey AI 2024). O ganho real depende da maturidade do time, qualidade da base de código e disciplina de revisão. Sem guardrails, o efeito pode ser inverso.
Quem ganha mais com o OpenCode
Diferentes perfis extraem valor diferente — veja onde encaixa no seu time.
Entrega projetos completos para clientes em prazos antes inviáveis. Cobra por valor, não por hora.
Time enxuto valida múltiplas hipóteses por sprint. Reduz necessidade de contratar para crescer.
Cada dev vira mais autônomo em áreas fora da sua especialidade (front entende back e vice-versa).
Cria skills internas com padrões da empresa (logging, auth, observabilidade) e distribui para todos os times.
Roda 100% on-prem com Ollama, mantendo código e dados dentro do perímetro de compliance.
Alunos aprendem programação conversando, professores criam exercícios automatizados, pesquisadores prototipam scripts.
Passo a passo de instalação e uso
Clique em uma etapa para ver os detalhes e copiar os comandos.
Pré-requisitos
macOS, Linux ou Windows (WSL recomendado). Terminal moderno (iTerm2, Windows Terminal, Ghostty). Git instalado.
Modos de permissão
O que o agente pode fazer sem te perguntar. Comece em ask, suba o nível só quando confiar.
Pede confirmação antes de cada edição de arquivo e antes de cada comando shell. Seguro para começar.
Aplica edições de arquivo sem perguntar, mas ainda pede para rodar comandos sensíveis (git push, rm, deploy).
Executa tudo sem perguntar — incluindo comandos destrutivos. Só use em sandbox, container ou VM descartável.
Riscos e cuidados
Um agente que edita arquivos e roda comandos no seu computador exige higiene. Os 6 pontos abaixo cobrem 90% dos incidentes reais relatados.
Em modo auto/yolo o agente pode rodar rm -rf, git push --force, drop database. Sempre revise propostas críticas.
Arquivos .env, chaves SSH e tokens podem ser enviados ao provedor de IA junto do contexto. Configure .opencodeignore.
Mudança de preço, latência ou política do fornecedor afeta diretamente seu fluxo. Tenha plano B (Ollama local).
Issues, READMEs ou comentários maliciosos podem reprogramar o agente. Não dê yolo em repositório que aceita PRs externos.
Sessões longas com contexto grande queimam tokens rápido. Monitore o uso pelo painel do provedor.
Vibe coding sem leitura gera dívida técnica e bugs sutis. Sempre rode testes e revise o diff final.
Comandos úteis da TUI
Atalhos digitados dentro do prompt do OpenCode.
/helpLista todos os comandos da TUI/modelTroca o modelo em uso na hora/initCria opencode.json e indexa o projeto/sessionsLista e retoma sessões antigas/clearLimpa o contexto atual/shareGera link público da sessão (cuidado!)/undoDesfaz a última mudança aplicada/exitSai da TUIChecklist de uso seguro
- Adicione .env, *.pem, .ssh/ ao .opencodeignore
- Comece sempre em modo ask
- Rode em um worktree ou branch separado
- Habilite testes automáticos antes de aceitar diffs grandes
- Defina um teto de gasto no painel do provedor
- Não use yolo em máquina pessoal — use container/VM
- Audite skills/MCPs de terceiros antes de instalar
- Faça commits pequenos para reverter fácil
OpenCode vs Claude Code vs Cursor
| Critério | OpenCode | Claude Code | Cursor |
|---|---|---|---|
| Open-source | Sim (MIT) | Não | Não |
| Multi-provedor | Sim | Só Anthropic | Sim |
| Interface | Terminal (TUI) | Terminal | IDE (fork VS Code) |
| Roda local (Ollama) | Sim | Não | Limitado |
| Custo da ferramenta | Grátis (paga só o modelo) | Plano Anthropic | Assinatura |
| MCP | Sim | Sim | Sim |