Modelos Gratuitos do OpenCode (2026) e Como Resolver o Erro Free Usage Limit Reached

Sim, o OpenCode é gratuito. O agente é de código aberto sob a licença MIT, sua página inicial afirma que “o OpenCode é 100% gratuito para usar” e ele já vem com modelos gratuitos que você pode executar “sem criar uma conta”. O detalhe está nos modelos, e não no aplicativo: todas as opções gratuitas são oferecidas por tempo limitado, respondem apenas dentro do OpenCode e estão sujeitas a um limite de uso que o OpenCode não divulga.

O OpenCode é um agente de codificação de código aberto para terminal, desktop e IDE capaz de operar qualquer modelo de mais de 75 provedores, incluindo um conjunto de modelos gratuitos disponibilizados pelo próprio Console do OpenCode (o provedor que o site também chama de Zen).

O que é gratuito e o que você paga

A lista atual de modelos gratuitos

A página de modelos do OpenCode (a antiga URL da documentação do Zen agora redireciona para lá) listava estas opções a $0 para entrada, saída e leitura em cache em 23 de outubro de 2026. Os termos de uso de dados vêm da mesma página e têm uma importância maior do que a maioria dos leitores imagina.

O Jev 1.13 Free também aparece na lista, mas é um modelo voltado para decisões estruturadas e não para geração de código; por isso, não foi incluído neste ranking.

Há dois detalhes importantes que a documentação não menciona. Primeiro, o catálogo interno da própria CLI diverge da página. O comando opencode models opencode na versão 1.19.4 listava minimax-m3.1-flash-free, que já não aparece na documentação, e não listava Exo, LongCat nem MiMo-V2.5. Tentar selecionar esses três modelos, bem como a opção listada da MiniMax, resultou imediatamente em UnknownError. Segundo, a página declara que cada modelo é “gratuito no OpenCode por tempo limitado”, sem informar data final. Trate essa lista como um retrato temporário.

O que executamos em 23 de outubro de 2026

Instalamos o OpenCode 1.19.4 com o comando npx -y opencode-ai@latest (sem conta, sem chave de API e sem arquivo auth.json) e atribuímos a mesma tarefa a cada modelo gratuito em um diretório vazio dedicado:

npx -y opencode-ai@latest run --auto --model opencode/deepseek-v4.1-flash-free \
  "Write fizzbuzz.py with a function fizzbuzz(n) ... Write test_fizzbuzz.py with unittest tests for it. Then run: python3 -m unittest test_fizzbuzz -v and report the result."

Cada execução contou com um teto de quatro minutos e, após o término, nós mesmos rodamos os testes novamente para verificar os arquivos criados.

O resultado foi inesperado. A primeiríssima requisição de todos os modelos retornou exatamente a mesma mensagem de erro:

Free usage limit reached. Subscribe to OpenCode Go to keep going: https://opencode.ai/go

Esse comportamento ocorreu com o DeepSeek V4.1 Flash Free, GLM-5.3-Flash Free, Beam Free, Big Pickle, Flint 40B Free, MiMo-V2.6-Flash Free e com os três modelos Nemotron. Uma segunda tentativa sequencial cerca de dez minutos depois resultou no mesmo erro. Nenhum arquivo chegou a ser gravado e nenhum teste foi executado. O OpenCode fez três tentativas automáticas e depois ficou em silêncio até o nosso tempo limite interromper o processo — portanto, dentro de um script, a falha se parece com um travamento, a menos que você informe o parâmetro --print-logs.

Esse limite é compartilhado entre todos os modelos: trocar de um modelo gratuito para outro não resolveu o problema. Ele foi disparado logo na nossa primeira requisição da sessão, o que significa que nenhuma das nossas execuções chegou a esgotá-lo. Não foi possível determinar se a contagem é feita por rede, por dispositivo ou em escala global, e a documentação do OpenCode não informa o tamanho dessa cota nem quando ela é reiniciada.

Trata-se de uma tarefa pequena, em um único dia e a partir de uma única rede. Não é um benchmark completo e não reflete a qualidade intrínseca dos modelos. No entanto, diz muito sobre o plano gratuito: ele pode ficar indisponível de surpresa bem no momento em que você precisa.

Em contrapartida, em um teste anterior realizado em 16 de outubro de 2026, o OpenCode 1.19.2 com o modelo opencode/deepseek-v4.1-flash-free concluiu uma tarefa completa de escrita e execução em apenas 32 segundos, sem necessidade de login.

O ranking

Como nenhum modelo conseguiu concluir a tarefa nos testes de hoje, não é viável ranqueá-los por velocidade ou taxa de sucesso com base nessas execuções. O que podemos avaliar de forma concreta e verificável é: se o modelo chegou à etapa de inferência na CLI atual, se já o vimos concluir uma tarefa antes e o que acontece com a privacidade do seu código.

1. DeepSeek V4.1 Flash Free. Zero retenção, sem treinamento, disponível no catálogo da versão 1.19.4 e o único modelo gratuito que registramos concluindo com sucesso uma tarefa de escrita e execução (32 segundos em 16 de outubro). Bloqueado hoje pelo limite compartilhado.
2. GLM-5.3-Flash Free. Zero retenção, sem treinamento, presente no catálogo. Bloqueado hoje pelo limite compartilhado; não temos registro de execuções finalizadas por ele até o momento.
3. Beam Free. Sem treinamento, mas retém dados por 30 dias e possui restrições de região. Bloqueado hoje.
4. Big Pickle, Flint 40B Free, MiMo-V2.6-Flash Free. Constam no catálogo, mas a documentação alerta que seus dados podem ser utilizados para o aprimoramento dos modelos. Utilize-os somente em códigos que você não se importaria de publicar publicamente.
5. Endpoints gratuitos do Nemotron. Os próprios termos de teste da NVIDIA recomendam não enviar dados pessoais ou confidenciais. Adequados apenas para experimentos simples.
6. LongCat 2.5 Preview Free, Exo Free, MiMo-V2.5 Free, MiniMax M3.1 Flash Free. Todos falharam com UnknownError antes do envio de qualquer requisição: os três primeiros estão ausentes do catálogo da versão 1.19.4, e o MiniMax não consta na documentação. A política de zero retenção do LongCat o colocaria em ótima posição assim que o catálogo da CLI for atualizado.

Se você precisar memorizar apenas uma regra: para códigos privados, escolha sempre um modelo com classificação explícita de zero retenção na documentação.

Onde o plano gratuito encontra seus limites

Funciona apenas dentro do OpenCode. Testamos esse ponto novamente hoje. Uma chamada direta para https://opencode.ai/inference/openai/v1/chat/completions utilizando deepseek-v4.1-flash-free retornou HTTP 403 e FreeTierError: “OpenCode’s free tier can only be used from within OpenCode.” Os modelos gratuitos não funcionam como uma API aberta. Para encontrar credenciais que você possa chamar a partir de suas próprias aplicações, veja nosso artigo sobre chaves de API de IA gratuitas.

Tempo limitado. Todos os modelos gratuitos trazem essa ressalva. As opções entram e saem de circulação continuamente.

Um limite de uso não divulgado. Como vimos, a mensagem de erro orienta a migrar para o OpenCode Go.

Desativação completa. Se a sua equipe precisa garantir que modelos gratuitos nunca sejam utilizados, a documentação orienta configurar OPENCODE_DISABLE_FREE_MODELS=1; com isso, as opções gratuitas desaparecem e qualquer tentativa de selecioná-las falha com a mensagem “Model unavailable”.

A opção paga mais acessível

A própria mensagem de erro já aponta o caminho: o OpenCode Go por $10 ao mês, ou o Go Plus por $40 para limites mais elevados. O plano Go oferece acesso a uma lista selecionada que inclui GLM-5.3-Flash, DeepSeek V4.1 Flash e MiniMax M3.1 Flash, é restrito a workspaces individuais e é inteiramente opcional.

A modalidade pay-as-you-go (pague pelo que usar) é a alternativa flexível. Na tabela de preços do Console, o DeepSeek V4.1 Flash custa $0,30 por milhão de tokens de entrada e $1,20 por milhão de saída, enquanto o GLM 5.3 Flash custa $0,15 e $0,50, respectivamente. Vale lembrar que ter um preço baixo por token não garante um custo final menor por tarefa; nosso guia sobre quando modelos baratos custam mais analisa esse mecanismo a fundo.

Como configurar um modelo gratuito no opencode.json

Defina o modelo de uma vez só no arquivo opencode.json (ou opencode.jsonc) dentro do seu projeto ou em ~/.config/opencode/, adotando o formato opencode/<model-id> indicado pela documentação:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "opencode/deepseek-v4.1-flash-free"
}

Execute primeiro o comando opencode models opencode para ter certeza de que o ID está presente na versão instalada. Para uma rodada isolada, opencode run --model opencode/glm-5.3-flash-free "..." sobrescreve a configuração padrão. Se você procura uma solução 100% gratuita a $0 e sem limites compartilhados, aponte esse mesmo campo para um modelo local, como "model": "ollama/gemma3:4b"; o OpenCode reconhece instâncias do Ollama, LM Studio e vLLM em seus endereços locais padrão automaticamente.

Se você está comparando o OpenCode com ferramentas pagas, o artigo o Claude Code é gratuito? aborda o outro lado dessa equação.

O papel do Sharkly

Você já conta com agentes de codificação. O Sharkly conecta essas ferramentas em uma equipe organizada. Ele executa as instâncias de OpenCode, Claude Code ou Codex que você já utiliza como Agentes atribuíveis em seus próprios Computadores, mantendo cada Tarefa em uma worktree isolada e consolidando os resultados diretamente na Tarefa correspondente.

O Sharkly não torna nenhum modelo gratuito nem altera as restrições de uso do OpenCode. Cada Agente adota o modelo padrão configurado em seu Runtime; logo, um Agente OpenCode utilizará o model definido no opencode.json daquela máquina, mantendo as cotas do plano gratuito inalteradas. Conforme a página de preços do Sharkly, o plano Free atende organizações de até 5 pessoas e o plano Team custa $7 por pessoa na cobrança anual a partir desse limite; além disso, “Guests, Agentes e Computadores não ocupam assentos” e “o Sharkly não comercializa tokens”. Nosso guia do DeepSeek V4.1 Flash detalha essa configuração no OpenCode passo a passo.

Se você opera mais de um agente no dia a dia, conecte-os ao Sharkly e mantenha cada um operando com o modelo que já utiliza.

Perguntas frequentes

O OpenCode é gratuito? Sim. O aplicativo possui licença MIT e é “100% gratuito para usar”, incluindo o acesso a modelos gratuitos sem exigir criação de conta. Os custos só existem se você conectar provedores pagos, assinar o plano Go ou comprar créditos pelo Console.

Quais são os modelos gratuitos do OpenCode? Em 23 de outubro de 2026, a documentação listava DeepSeek V4.1 Flash Free, GLM-5.3-Flash Free, LongCat 2.5 Preview Free, Beam Free, Big Pickle, Flint 40B Free, Exo Free, dois modelos MiMo e três modelos Nemotron, todos disponíveis “por tempo limitado”. Use o comando opencode models opencode para verificar quais deles estão de fato operacionais na sua versão instalada.

Qual modelo gratuito do OpenCode é o melhor para programar? Para projetos de código privado, as melhores escolhas são o DeepSeek V4.1 Flash Free ou o GLM-5.3-Flash Free, já que ambos possuem política de zero retenção. O DeepSeek é o único modelo gratuito que registramos concluindo com sucesso uma tarefa de ponta a ponta. No entanto, nenhum modelo concluiu tarefas em 23 de outubro em razão do limite de uso do plano gratuito.

O que significa o erro “Free usage limit reached”? Esse aviso indica que você atingiu a cota máxima do plano gratuito do OpenCode, a qual é compartilhada entre todos os modelos dessa categoria. O OpenCode não divulga qual é essa capacidade nem o intervalo de reinicialização. As soluções são aguardar, apontar para um modelo local ou assinar o OpenCode Go.

Posso fazer chamadas diretas aos modelos gratuitos do OpenCode no meu próprio código? Não. Requisições diretas de API retornam HTTP 403 acompanhado do erro FreeTierError; a camada gratuita responde unicamente por meio do próprio aplicativo OpenCode.

Os modelos gratuitos do OpenCode usam meu código para treinamento? Alguns deles sim. Segundo a documentação, DeepSeek, GLM-5.3-Flash e LongCat possuem termos de zero retenção; em contrapartida, Big Pickle, Flint, Exo e MiMo “podem ser usados para melhorar o modelo”, enquanto os endpoints do Nemotron mantêm registro de utilização.