Esta comparação costuma ser apresentada como gratuita versus paga, o que transforma a questão em uma pergunta sobre o limite, não sobre as ferramentas. O Gemini CLI vem com uma franquia incluída real; o Claude Code usa uma assinatura por padrão. Ambos são agentes de terminal de formato amplamente semelhante. Portanto, a pergunta que realmente decide é aquela que nenhuma comparação responde: qual será a cobrança depois da cota gratuita e depois da janela de uso.
O formato de cada um
| Claude Code | Gemini CLI | |
|---|---|---|
| Criado por | Anthropic | |
| Começa em | Uma assinatura Claude, com uma janela de uso | Gratuito, com uma cota diária |
| Modelos padrão | Claude | Gemini |
| Endpoint personalizado | ANTHROPIC_BASE_URL — protocolo da Anthropic | Uma chave e configuração no formato do Google |
| Esgota quando | Você atinge a janela do plano | Você atinge a cota diária |
| E depois? | Cobrança por token em qualquer endpoint compatível | Cobrança por token em uma chave |
As duas últimas linhas chegam ao mesmo ponto, que é o que vale notar: esta é uma comparação de condições iniciais, e todos que usam qualquer uma das ferramentas com seriedade acabam no mesmo regime de cobrança por token.
Por que o trabalho agêntico atinge uma cota rapidamente
Uma mensagem de chat envia uma pergunta. Uma etapa de agente envia a tarefa, os arquivos relevantes, os resultados das ferramentas e o histórico — a cada etapa, porque o modelo não tem estado. Portanto, um loop que edita quatro arquivos e executa os testes duas vezes pode custar mais do que uma tarde de conversa. Isso não é uma falha de nenhuma das ferramentas; é o que o trabalho agêntico é, e é por isso que uma franquia gratuita que parece generosa no chat se esgota rapidamente aqui.
A consequência para esta comparação: faça o orçamento com a tarifa paga e trate o nível gratuito como um ponto de partida, não como o plano.
Como os dois ficam com cobrança por token
# Claude Code — Anthropic-shaped endpoint, two variables plus the model pins.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s. The Opus 5.5
# pin needs Claude Code v2.1.280 or later (run: claude update).
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
# Gemini models past the free quota — OpenAI-compatible endpoint,
# which is what most tools and SDKs expect:
curl https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer sk-kn-..." \
-H "Content-Type: application/json" \
-d '{"model":"gemini-3-8-flash","messages":[{"role":"user","content":"hi"}]}'As tarifas completas de cada família, ao lado dos preços de tabela dos próprios fornecedores, estão em preços da API Gemini e preços da API Claude. A aritmética entre plano e chave para o lado do Claude está em limites do Claude Pro e Max.
Onde esta página termina
Ela não classifica os dois pela qualidade da saída. Não fizemos uma comparação controlada com tarefas idênticas, e os ocupantes desta consulta que os classificam estão relatando impressões do próprio uso — vale a pena ler, mas isso não é uma medição. Se a qualidade for seu fator decisivo, execute a mesma tarefa real nos dois com cobrança por token e compare os diffs e as cobranças; isso leva uma tarde e é a única versão da resposta válida para sua base de código.
Se o nível gratuito trouxe você até aqui, a pesquisa mais ampla está em alternativas ao Claude Code, que separa «a ferramenta está errada» de «a cobrança está errada» antes de recomendar qualquer coisa.
Perguntas frequentes
O Gemini CLI é realmente gratuito?
A franquia incluída é real e generosa para uso leve, mas é uma cota diária, não um nível ilimitado, e o trabalho agêntico a esgota muito mais rapidamente do que o chat — um agente reenvia o contexto a cada etapa de um loop, portanto uma única tarefa longa pode consumir o que um dia de conversa não consumiria. Trate-a como um nível gratuito genuíno com um limite, não como uma resposta permanente à questão do custo. Depois do limite, você compra tokens, como em qualquer outro lugar.
Qual é melhor, Gemini CLI ou Claude Code?
Eles são suficientemente parecidos — ambos são agentes de terminal que leem seu repositório, propõem edições e executam comandos — para que os diferenciais honestos sejam o laboratório por trás do modelo padrão e a forma como cada um é pago. O Gemini CLI começa gratuito e está ligado aos modelos do Google; o Claude Code começa com uma assinatura e está ligado ao formato da API da Anthropic, embora aceite qualquer endpoint que fale esse formato. Não fizemos uma comparação controlada da saída deles e não os classificamos com base nisso.
O que acontece quando a cota gratuita do Gemini CLI acaba?
Você fornece uma chave e paga por token, que é a mesma situação de um usuário do Claude Code depois que termina a janela de uso da assinatura. Nesse ponto, a escolha deixa de ser grátis versus pago e passa a ser uma comparação direta de tarifas. Na Kunavo, Gemini 3.8 Flash custa $0.525 de entrada / $2.625 de saída por 1 milhão de tokens e Gemini 3.1 Pro custa $0.70 / $4.20; Claude Sonnet 5 custa $1.40 / $7.00 e Claude Haiku 4.5 custa $0.70 / $3.50. Esses são os números relevantes para a comparação quando o nível gratuito já ficou para trás.
Posso usar modelos Gemini dentro do Claude Code?
Não diretamente. O Claude Code usa a API Messages da Anthropic, portanto qualquer endpoint fornecido deve responder nesse formato — por isso seu nível barato (ANTHROPIC_DEFAULT_HAIKU_MODEL) também é um modelo Claude. Se você quer executar modelos de vários laboratórios dentro de um único agente, uma ferramenta independente de provedor é a opção estruturalmente adequada; o opencode é a mais próxima do Claude Code em formato.
Posso executar os dois?
Sim, e é uma configuração razoável: Gemini CLI para o trabalho coberto por sua franquia gratuita, Claude Code para as execuções em que você quer um modelo Claude, cada um cobrado à sua maneira. Nenhum custa algo enquanto está ocioso se você estiver na cobrança por token, portanto manter os dois instalados não tem custo fixo — a decisão é por tarefa, não uma escolha única e permanente.
Qual é mais barato depois do nível gratuito?
Por token, o nível flash do Gemini é a opção mais barata nesta comparação, e a diferença diminui à medida que você sobe para os níveis pro. Mas a tarifa é apenas metade da questão: o custo do agente é a tarifa multiplicada pela quantidade de contexto que a ferramenta reenvia a cada etapa, e isso varia mais conforme seu repositório do que conforme a ferramenta. A maneira confiável de decidir é executar a mesma tarefa real nos dois, com cobrança por token, e comparar as cobranças efetivas, não as tabelas de tarifas.