OpenCode: o que é, se é grátis, como instalar e usar no terminal

Nos nossos grupos de alunos, existe uma cena que se repete toda semana: um desenvolvedor experiente ou um profissional de tecnologia entra na turma com dez projetos impecáveis salvos na própria máquina, mas confessa que está apanhando na hora de conseguir o primeiro cliente pagante. Ao mesmo tempo, quem está começando a pesquisar sobre vibe coding costuma esbarrar no valor da mensalidade da Anthropic e sai procurando um substituto aberto para rodar no terminal. É exatamente nesse cruzamento que o OpenCode disparou nas buscas no Brasil nos últimos meses.

O que é o OpenCode (e o que ele não é)

O OpenCode é um agente de codificação de código aberto feito para rodar no terminal, além de contar com aplicativo de desktop e extensão para editores de código. Assim como acontece no Claude Code, você abre a ferramenta dentro da pasta do projeto no seu computador, descreve em linguagem natural o que precisa construir ou corrigir e o agente lê os arquivos, edita o código e executa comandos no sistema.

Vale desfazer logo de cara uma confusão muito comum em português: quando falamos de OpenCode (muitas vezes digitado separado como open code), estamos tratando do nome próprio desse agente de terminal, e não do conceito genérico de software de código aberto. A diferença central dele para os agentes das grandes empresas de inteligência artificial é que o OpenCode não pertence a um único laboratório de modelos. Ele funciona como uma estrutura independente em que você escolhe qual cérebro de IA vai responder aos seus pedidos.

Para quem quer criar site com IA e prestar serviços para empresas locais, essa liberdade técnica tem dois lados claros: por um lado, você pode testar modelos gratuitos ou conectar chaves de vários provedores; por outro, precisa gerenciar contas, limites e configurações que já vêm prontas quando você usa o Claude Code, o Codex ou o Antigravity.

O OpenCode é grátis? O que é grátis e o que você paga

O programa do OpenCode em si é 100% gratuito e de código aberto, mas o modelo de inteligência artificial que pensa e escreve o código dentro dele pode ter custo. Como o agente é apenas a ponte instalada no seu computador, a conta financeira depende de qual motor você decide ligar na ferramenta.

Na prática, a documentação oficial do OpenCode divide o uso dos modelos em quatro formatos principais:

• Modelos gratuitos embutidos. A plataforma disponibiliza modelos grátis por tempo limitado dentro do próprio OpenCode, como o DeepSeek V4.1 Flash Free e o GLM-5.3-Flash Free. É a porta de entrada para quem quer testar o agente no terminal sem cadastrar cartão, sabendo que a lista de modelos sem custo muda com frequência.
• OpenCode Go (assinatura mensal de modelos abertos). Para quem quer previsibilidade usando modelos abertos selecionados pela equipe do projeto, existe o plano pago que custa US$ 10 por mês no OpenCode Go, com modelos abertos testados pra programar com agente (o Go Plus, com mais limite, sai US$ 40 por mês).
• OpenCode Zen (pagamento por consumo). Funciona como uma carteira pré-paga dentro do próprio ecossistema da ferramenta, em que você carrega saldo e paga por token consumido nos modelos homologados.
• Chave de API própria (traga a sua chave). Você pode conectar diretamente uma chave de API da Anthropic, da OpenAI, do Google AI Studio ou de dezenas de outros provedores, pagando a fatura direto para a empresa dona do modelo.

Muita gente passa dias configurando provedores alternativos no OpenCode apenas por medo de assumir uma assinatura mensal de inteligência artificial antes de fechar o primeiro negócio. Só que a conta comercial da vida real é muito simples: mesmo que você demorasse meses para fechar um único site simples de R$ 1.000 ou R$ 1.500 para um comércio do seu bairro, esse primeiro contrato já pagaria todo o custo da ferramenta com folga. Na nossa operação, são os clientes fechados que pagam os tokens, e nunca o contrário.

E se a sua prioridade absoluta hoje for começar com orçamento zero, sem precisar configurar chaves de API e já rodando toda a estrutura do MazyOS com aula dedicada passo a passo, a melhor porta gratuita oficial é o Antigravity, do Google, ou as opções que detalho no guia sobre Claude gratuito.

Como instalar o OpenCode (Windows primeiro)

Como o OpenCode nasceu no universo de linha de comando, a instalação é feita diretamente pelo terminal do seu sistema operacional. Se você utiliza Windows, o caminho mais rápido é abrir o PowerShell ou o terminal com o Node.js instalado e rodar o comando global via npm:

No Mac ou no Linux, além do comando via npm acima, você também pode instalar direto pelo gerenciador Homebrew:

Depois de concluir a instalação no computador, os passos para dar o primeiro comando dentro de um projeto são diretos:

1. 1Crie uma pasta nova para o seu projeto e abra o terminal apontando para dentro desse diretório.
2. 2Digite o comando opencode e pressione Enter para abrir a interface de texto do agente em tela cheia.
3. 3Use o comando interno /connect ou o seletor de modelos para escolher um dos modelos gratuitos disponíveis no dia ou colar a sua chave de API.
4. 4Escreva o seu pedido normalmente em português, descrevendo a página ou a alteração que deseja fazer nos arquivos da pasta.

Mesmo que a interface inicial e os menus de configuração do programa apareçam em inglês, a conversa inteira com o agente pode ser conduzida em português claro, pois quem processa o idioma é o modelo conectado por trás.

Skills, plugins e MCP no OpenCode

Quem já trabalha com agentes modernos sabe que pedir código solto em uma janela em branco gera resultados genéricos. O que transforma um agente de terminal em uma linha de produção séria é a capacidade de ler instruções permanentes da pasta, carregar habilidades prontas e conversar com ferramentas externas.

• Regras do projeto (`AGENTS.md` e `CLAUDE.md`). De acordo com a documentação técnica do OpenCode, o agente procura por padrão o arquivo AGENTS.md na raiz do projeto para entender as regras de arquitetura e estilo, mantendo também leitura de compatibilidade com arquivos CLAUDE.md.
• Pasta de skills (`opencode skills`). O sistema permite organizar instruções especializadas em pastas de skills locais dentro do projeto ou na pasta do usuário, seguindo a mesma lógica modular que explico em detalhes no guia sobre Claude Skills.
• Plugins e personalização (`opencode plugins`). A comunidade desenvolveu extensões e pacotes de configuração, como o conhecido oh-my-opencode, para adicionar atalhos, temas e fluxos automatizados ao terminal.
• Servidores MCP (`opencode mcp`). O OpenCode suporta o protocolo Model Context Protocol (MCP), permitindo conectar o agente a bancos de dados, navegadores de teste e serviços externos através do arquivo de configuração local.

Apenas tome um cuidado importante se você também usa a ferramenta do Google: conforme alerta a documentação oficial da empresa, usar outro programa com o login do Antigravity, como o Claude Code, o OpenCode ou o OpenClaw, viola os termos do Google e pode suspender ou encerrar a conta; pra usar o Gemini num agente de fora, o Google indica uma chave de API do Google AI Studio ou do Gemini Enterprise. Portanto, se quiser usar os modelos do Google dentro do OpenCode, conecte sempre uma chave de API oficial em vez de tentar reaproveitar logins de outros programas.

O OpenCode tem limite?

Como o OpenCode é um software de código aberto instalado na sua máquina, o programa em si não impõe travas artificiais na sua tela. Quem define o teto de requisições por minuto, o tamanho da janela de contexto e a cota diária é sempre o provedor do modelo que você escolheu usar.

Nos modelos gratuitos liberados por tempo limitado dentro da ferramenta, os limites costumam ser mais curtos e podem sofrer lentidão nos horários de pico ou sair do ar sem aviso prévio. Por isso, eu sempre repito uma regra de ouro para os alunos: nunca construa o castelo da sua operação dependendo de um favor temporário no terreno dos outros. Use os modelos gratuitos para conhecer a tela e estudar, mas mantenha os arquivos e o contexto dos seus clientes salvos na sua própria pasta local.

OpenCode ou Claude Code?

Para colocar todas as cartas na mesa, compare na tabela abaixo como o OpenCode se posiciona diante das três portas oficiais em que trabalhamos para construir e vender sites de clientes:

Olhando para a tabela, a decisão prática fica livre de fanatismo por ferramenta: se você já assina o Claude Pro, vá direto de Claude Code; se já paga o ChatGPT, aproveite o comparativo Codex vs Claude Code; e se não quer desembolsar nada agora, comece pelo Antigravity gratuito (ou veja por que o antigo Gemini CLI deixou de ser a opção grátis do Google).

O OpenCode faz sentido principalmente para o desenvolvedor que gosta de customizar o terminal e quer alternar entre diferentes modelos abertos e chaves de API na mesma janela. Já para quem quer comparar editores completos ou construtores visuais de navegador, vale ler também as análises de Cursor vs Claude Code, de melhor IA para programar, do Lovable e do Base44.

No vídeo abaixo, eu mostro na tela do meu computador como funciona na prática o fluxo do Claude Code construindo um projeto completo do zero, conversando apenas em português:

O OpenCode roda o MazyOS?

Aqui vale a transparência total que eu mantenho em todas as páginas da casa: hoje, de forma oficial e testada pela nossa equipe, o MazyOS roda no Claude Code, no Codex e no Antigravity. No Codex o comando /instalar funciona do mesmo jeito que no Claude Code, e para a ferramenta do Google o curso tem uma aula só do Antigravity, mostrando exatamente onde posicionar os arquivos.

Pela documentação oficial do OpenCode, ele lê arquivos AGENTS.md, reconhece instruções CLAUDE.md e carrega pastas de skills no mesmo padrão aberto de mercado. Porém, como eu só prometo suporte oficial naquilo que a minha equipe testa à exaustão em entregas reais de clientes, a minha recomendação é que você rode o MazyOS em uma das três ferramentas homologadas, como explico em o MazyOS só funciona no Claude?.

O ponto mais importante é entender que o agente de terminal sozinho é apenas o motor; o que faz a página sair com acabamento de agência, copywriting persuasivo e memória persistente do cliente são as skills e os arquivos de contexto que o MazyOS instala na sua pasta (qual a diferença do MazyOS pro Claude sozinho?).

Sou dev e não vendo: o que nenhum agente resolve

Se você já sabe instalar pacotes no terminal, configurar variáveis de ambiente e colocar um site no ar, o seu problema nunca foi escolher entre OpenCode, Claude Code ou Codex. Criar software ficou rápido e acessível; a parte que trava 90% dos profissionais técnicos sempre foi saber abordar um empresário, apresentar valor sem falar difícil e cobrar pelo projeto.

Na nossa comunidade, vários programadores experientes relatavam exatamente essa dor: sabiam construir qualquer sistema no fim de semana, mas travavam na hora de mandar a primeira mensagem no WhatsApp (já trabalho com sites ou programação: serve pra mim?). Quando você aplica um método comercial direto, parando de vender siglas técnicas e passando a mostrar a prévia do site já pronta na tela do dono do negócio, a velocidade de fechamento muda por completo.

Veja o caso do Junior na nossa turma: ele entrou no treinamento numa terça-feira e, aplicando o passo a passo de abordagem com a estrutura do MazyOS, na sexta-feira da mesma semana já estava com R$ 6.000 fechados na conta:

Para quem trava justamente na hora de quebrar o gelo com o empresário (não sei vender: consigo mesmo assim?), nós organizamos a prospecção em três camadas muito claras, sem nunca usar disparo automático em massa:

1. 1Comece por quem já conhece você. Liste 20 amigos, parentes, ex-chefes ou comerciantes do seu bairro com quem você já tem liberdade no WhatsApp.
2. 2Avance para o contato frio preparado. Escolha empresas locais que têm um perfil ativo ou investem em anúncios, mas ainda usam uma página amadora ou lenta.
3. 3Chegue com a prévia pronta antes do orçamento. Em vez de perguntar se a pessoa quer fazer um site, monte a página inicial do negócio dela usando as skills do MazyOS e mostre o link funcionando na chamada.

Para destravar ainda mais rápido essa etapa de conversa comercial, dentro do checkout do MazyOS você também pode adicionar o Cofre de Abordagens por R$ 39,90, que entrega 50 mensagens prontas, 5 roteiros de áudio e 100 nichos com o gancho certo para você saber exatamente o que enviar em cada situação.

Perguntas rápidas sobre o OpenCode

O OpenCode é totalmente gratuito? O programa que você instala no terminal é gratuito e de código aberto. O que tem custo é o modelo de inteligência artificial conectado a ele, embora você possa começar usando modelos grátis por tempo limitado dentro do próprio OpenCode, como o DeepSeek V4.1 Flash Free e o GLM-5.3-Flash Free.

Quais modelos não custam nada dentro do OpenCode? Atualmente a documentação lista modelos grátis por tempo limitado dentro do próprio OpenCode, como o DeepSeek V4.1 Flash Free e o GLM-5.3-Flash Free, lembrando que essas ofertas promocionais de modelos abertos mudam periodicamente.

Como instalar o OpenCode no Windows? Basta ter o Node.js instalado na máquina, abrir o PowerShell ou o terminal do Windows e executar o comando npm install -g @opencode/cli. Depois, entre na pasta do projeto e digite opencode.

Qual é melhor para fazer sites de clientes: OpenCode ou Claude Code? Se você quer um ambiente pronto, testado e com acabamento visual superior logo na primeira resposta, o Claude Code (ou o Antigravity, se quiser começar sem pagar assinatura de IA) é o caminho mais direto. Veja mais detalhes sobre custos iniciais em preciso pagar o Claude além do MazyOS? e em como usar o MazyOS de graça no Antigravity.

O OpenCode funciona em português? Sim. Mesmo que os comandos de sistema do terminal sejam em inglês, você pode digitar todas as instruções do seu site em português e pedir para o modelo escrever todo o conteúdo da página no nosso idioma.

Quanto custa o MazyOS para estruturar os projetos e aprender a vender? O acesso completo ao sistema de pastas, skills e às 26 aulas em 7 módulos sai por R$ 97 por um ano ou R$ 197 pra sempre, em pagamento único, no Pix ou em até 12x.