Cota do Gemini CLI: de onde ela vem agora e o que fazer ao atingir o limite

A cota do Gemini CLI agora vem de uma relação paga: uma licença Gemini Code Assist, que o Google limita a 1.500 solicitações por usuário por dia no Standard e 2.000 no Enterprise, ou uma chave com cobrança por uso — uma chave da Gemini API ou uma chave do Gemini Enterprise Agent Platform — para a qual a página de limites de taxa do Google não publica nenhuma contagem diária de solicitações, apenas limites por modelo que você consulta no AI Studio. A fonte que a maioria das respostas ainda cita — entrar com uma conta pessoal do Google no nível gratuito, Google AI Pro ou Google AI Ultra — deixou de atender o Gemini CLI em 18 de junho de 2026.

Essa data explica por que essa pergunta é mais difícil do que parece. O README do próprio repositório do Google, obtido da branch main em 21 de setembro de 2026, ainda anuncia "Nível gratuito: 60 solicitações/min e 1.000 solicitações/dia com uma conta pessoal do Google". Não é um erro que alguém tenha corrigido, e é o número que a maioria dos artigos de terceiros está copiando.

De onde vem sua cota do Gemini CLI hoje

Duas fontes oficiais do Google estabelecem o corte. O anúncio do Google de 19 de maio de 2026: "Em 18 de junho de 2026, o Gemini CLI e as extensões do IDE do Gemini Code Assist deixarão de atender solicitações do Google AI Pro e Ultra, bem como daqueles que o utilizam gratuitamente por meio do Gemini Code Assist para indivíduos." E a página de descontinuação, cujo rodapé informa como última atualização 2026-09-02: "Isso também se aplica ao uso do Gemini CLI. Como parte da descontinuação, você não pode mais usar a opção Login with Google para acessar as extensões do IDE ou o Gemini CLI." A FAQ responde diretamente à questão Standard/Enterprise — essas assinaturas não são afetadas.

Os números ativos vêm da página de cotas do Code Assist do Google (atualizada pela última vez em 2026-09-18), e o mecanismo nela importa mais do que os números. As cotas para o modo de agente e o Gemini CLI são combinadas; um prompt pode produzir várias solicitações de modelo; os limites diários são "agregados em todas as interações com qualquer versão ou família de modelos"; e, quando o máximo é atingido, "nenhuma solicitação adicional pode ser feita por essas interfaces para qualquer modelo até que a cota seja redefinida". Portanto, mudar para um modelo menor não oferece espaço adicional nessa rota, e uma cifra de 1.500 não significa 1.500 prompts. O Google não informa quando essa redefinição ocorre — a regra da meia-noite do Pacífico que você talvez tenha lido é documentada para a Gemini API, não para a rota de licença, e transferi-la para cá seria um palpite.

Há outra armadilha nessa mesma página: as linhas de "2 solicitações por segundo", 6.000 por dia e 960 por dia são cotas do Gemini para o Google Cloud, destinadas à conclusão de código e ao chat do painel Cloud Assist. Elas não são o orçamento do modo de agente do CLI, e aplicar um número de um sistema ao outro está errado, embora ambos os números sejam reais.

Quatro páginas oficiais do Google que fornecerão o número errado

geminicli.com não é um site de alguém que se apropriou do domínio — é a própria página inicial declarada pelo repositório, exatamente por isso é perigoso. Descarte-o por estar desatualizado, não por ser não oficial. Atualmente, seu banner contradiz o próprio texto principal: "Usuários do nível gratuito e do Google One: o Gemini CLI foi substituído pelo Antigravity CLI em 18 de junho de 2026." Quando o banner e a tabela discordam, o banner e a página de descontinuação datada são a informação mais recente.

Uma pergunta que nenhuma página oficial responde. Na rota de chave de API, o blog do Google de 19 de maio diz que o CLI continua acessível por meio de chaves de API pagas. A publicação de encerramento de 18 de junho dos mantenedores acrescenta apenas que "usuários Enterprise com licenças Gemini Code Assist e autenticação por chave de API permanecem completamente inalterados" — uma frase cujo sujeito são os usuários Enterprise, portanto não é uma declaração de que uma chave não paga ainda funciona. Nada datado após 18 de junho aborda chaves não pagas, e a cifra de 250 solicitações por dia para chaves não pagas sobrevive apenas no documento de cotas congelado. Trate uma chave não paga como não verificada, não como um orçamento.

Em qual rota estou e como é o limite?

Antes de mudar qualquer coisa, confirme a relação de cobrança. O Gemini CLI documenta /auth como "uma caixa de diálogo que permite alterar o método de autenticação" e /stats model como exibindo "estatísticas de uso específicas do modelo, incluindo contagens de tokens e informações de cota"; a documentação de cotas acrescenta que um resumo do uso também aparece ao sair, no final de uma sessão. Ambos são comportamentos documentados, consultados em 21 de setembro de 2026, não comportamentos testados aqui.

Duas falhas diferentes produzem interrupções de aparência semelhante, e têm soluções diferentes. Um atingimento de cota é documentado como oferecendo uma opção nomeada: "Quando você atingir esse limite, receberá a opção de mudar para o Gemini 2.5 Pro, fazer upgrade para limites maiores ou parar. Você também será informado quando seu limite de uso for redefinido", com um prompt adicional para fazer fallback para o Gemini 2.5 Flash quando o limite do 2.5 Pro for atingido. Um erro de capacidade é, em vez disso, uma sobrecarga do modelo: a documentação diz que o CLI pergunta se você quer continuar tentando o Gemini 3 Pro ou fazer fallback para o Gemini 2.5 Pro, e que "Continuar tentando" usa backoff exponencial. Esperar resolve o segundo; somente uma redefinição, uma licença ou uma rota de cobrança diferente resolve o primeiro.

Há também um fallback que ocorre sem perguntar. A documentação afirma que, quando o CLI detecta limitação de taxa no modelo "pro" padrão, ele "muda automaticamente para o modelo 'flash' na sessão atual", e que chamadas internas de utilitários que usam gemini-2.5-flash-lite fazem "fallback silencioso" para outros modelos quando a cota se esgota, sem alterar o modelo configurado. Em uma chave com cobrança por uso, isso importa tanto para a fatura quanto para a saída: o modelo que respondeu nem sempre é o modelo que você selecionou.

As quatro opções ao atingir o limite, com o custo de cada uma

O próprio cabeçalho da tabela de preços do Google Cloud diz "Tipo de licença Gemini / Taxas da licença (compromisso mensal) / Taxas da licença (compromisso de 12 meses)" e não imprime as palavras "por usuário" ao lado da cifra — a cota é explicitamente por usuário por dia, portanto interprete a taxa como sendo por licença até confirmar os termos de assento no seu próprio pedido.

Opção um, espere. Gratuita e correta quando a interrupção é um erro de capacidade, e não um atingimento de cota. Opção dois, compre uma licença. Esta é a única opção que aumenta a franquia diária de solicitações na rota de login, e é a que o Google documenta para o Gemini CLI. Opção três, migre para uma chave com cobrança por uso. Isso remove o teto diário de solicitações e o substitui por cobrança por token mais um limite de gastos: a página de limites de taxa do Google publica limites baseados em gastos de $10, $50 e $200 por dez minutos consecutivos para os níveis 1 a 3, retornando 429 RESOURCE_EXHAUSTED quando excedidos, e observa que os limites "não são garantidos" e que os números por modelo só ficam visíveis no AI Studio. A página de cobrança (atualizada pela última vez em 2026-09-20) também registra uma mudança de Postpay para Prepay no uso da Gemini API, com uma compra mínima de créditos de $5. A variante Agent Platform dessa mesma opção tem sua própria janela gratuita: o modo express (atualizado pela última vez em 2026-09-18) permite que novos usuários do Google Cloud a experimentem por até 90 dias sem fornecer informações de cobrança e declara que o nível gratuito de 90 dias é removido para usuários existentes do Cloud ou assim que a cobrança é ativada.

Mude os quatro, troque o cliente. A própria recomendação do Google é o Antigravity CLI, e vale saber o que isso custa em flexibilidade antes de adotá-la: a documentação dos planos do Antigravity afirma que "atualmente não há suporte para: trazer sua própria chave ou seu próprio endpoint para limites de taxa adicionais"; usuários que não estão no AI Pro ou Ultra têm apenas "Cota significativa, renovada semanalmente" e um "Limite de taxa semanal", sem nenhum número publicado nessa página; e a cota paga é "renovada a cada cinco horas" — no Pro, "até o limite semanal ser atingido" — com limites que o Google diz serem "correlacionados à quantidade de trabalho realizado pelo agente", e não à contagem de prompts. Nenhum binário do Antigravity CLI foi instalado para esta página, e nenhuma comparação de velocidade ou compatibilidade é declarada.

O que não aumenta a cota do Gemini CLI: uma assinatura do Google AI Plus por US$ 4.99/mês ou uma assinatura do Google AI Pro por US$ 19.99/mês (gemini.google/subscriptions, verificado em 21 de setembro de 2026). Desde 18 de junho de 2026, elas compram limites do app Gemini e do Antigravity. Os níveis AI Ultra de US$ 100 e US$ 200 vêm do anúncio de 19 de maio de 2026 do Google, e não da página de assinaturas, e têm a mesma ressalva.

O que um endpoint personalizado pode e não pode fazer

O Gemini CLI documenta uma substituição da URL base, e ela é mais limitada do que parece. GOOGLE_GEMINI_BASE_URL substitui a URL base para solicitações da Gemini API "ao usar a autenticação gemini-api-key", deve ser HTTPS, a menos que aponte para localhost, e tem um equivalente separado, GOOGLE_VERTEX_BASE_URL, para o caminho do Vertex — que o Google renomeou desde então para Gemini Enterprise Agent Platform, enquanto o CLI manteve os nomes antigos das variáveis. No código-fonte lançado da v0.60.0, definir apenas essa variável seleciona um tipo de autenticação que não aparece em nenhuma documentação publicada (GATEWAY = 'gateway'), cuja chave assume como padrão uma string vazia. Interprete isso como código, não como um recurso compatível; ele pode mudar sem uma entrada no changelog.

Seguem três limites, e eles determinam se esta é uma resposta sobre cota. A URL base é passada como httpOptions.baseUrl para o SDK GoogleGenAI, portanto toda solicitação ainda usa o protocolo nativo do Google, autenticada por padrão com um cabeçalho x-goog-api-key; o enum de autenticação não contém nenhum provedor compatível com OpenAI ou Anthropic. A API da Kunavo é compatível apenas com OpenAI e com Anthropic Messages — o inventário de rotas neste commit contém /v1/chat/completions, /v1/responses e /v1/messages, e não tem um caminho Gemini nativo generateContent — portanto ela não é um destino compatível diretamente com essa variável, e nenhuma página aqui deve afirmar o contrário. Isso é uma inferência baseada no formato do protocolo e no inventário de rotas, não um teste em tempo de execução. Além disso, a substituição existe apenas no caminho da chave de API, portanto apontar para qualquer gateway nunca aumenta, estende nem redefine uma cota diária do lado do Google; isso muda você para uma relação de cobrança diferente, cuja cota será então a que essa conta tiver.

A versão honesta da opção da Kunavo é, portanto: troque o cliente, não o endpoint. Gemini CLI vs Claude Code compara os dois agentes, e a documentação da chave da Gemini API explica como acessar modelos Gemini por um caminho compatível com OpenAI. A Kunavo não testou nenhum desses clientes em tempo de execução contra seu endpoint; um guia de configuração publicado é uma referência de configuração, não um teste de compatibilidade.

Uma estimativa prática se você trocar o cliente

Estes são cálculos ilustrativos de tokens, não custos de tarefas medidos nem um teto de cobrança. Suponha uma sessão de agente que envie 300,000 tokens de entrada não armazenados em cache e receba 20,000 tokens de saída. As tarifas são preços atuais do catálogo da Kunavo por milhão de tokens; compare-as com os preços de tabela do Google na tabela acima.

Evite converter entre os dois mundos. Uma licença do Code Assist mede solicitações por usuário por dia, uma chave de tokens mede tokens, e o próprio Google afirma que um prompt pode produzir várias solicitações ao modelo — portanto não existe uma taxa de conversão entre US$ 22.80 por mês e um valor por sessão. A única comparação honesta é executar a mesma tarefa delimitada nos dois e consultar o registro da própria conta de cada um. O valor do catálogo da Kunavo é um piso de cobrança, não um limite: quando o upstream informa sua cobrança, a fatura é o maior valor entre o custo do catálogo e o custo do upstream multiplicado pela margem aplicável. As cobranças de cache e as ferramentas externas ficam fora deste exemplo, e o recarregamento mínimo é de US$ 10 em crédito pré-pago — um mínimo de financiamento, não uma tarifa de tarefa nem uma assinatura. Consulte detalhes de cobrança.

Qual rota vence quando

Se você está transferindo o trabalho para um agente diferente, e não para um plano diferente do Google, comece pela integração do OpenCode ou pela configuração do Cline, compare as tarifas no catálogo de modelos e crie uma conta Kunavo quando estiver pronto para financiar uma chave. Para uma visão mais ampla dos preços do Gemini, consulte preços da Gemini API; e, para a mesma questão do nível gratuito que desapareceu em outro agente, consulte limites de uso do Codex.

Perguntas frequentes

Verificado em 21 de setembro de 2026: o aviso de descontinuação do Google, a página de cotas do Code Assist, a tabela de preços do Google Cloud, as páginas de preços, cobrança e limites de taxa da Gemini API, o conjunto de documentação de geminicli.com e sua página de cotas, a página de planos do Antigravity, o README do repositório, a API do repositório no GitHub e o registro do npm (estável 0.60.0, publicado em 15/09/2026). Não verificado: nenhum binário do Gemini CLI ou do Antigravity CLI foi instalado, nenhuma conta do Google foi conectada e nenhum proxy foi apontado para o CLI — o limite de protocolo foi lido do código-fonte lançado da v0.60.0 e do próprio inventário de rotas da Kunavo. As tarifas de tokens da Kunavo vêm do catálogo atual, e todos os valores em dólares aqui são cálculos ilustrativos de tokens.