Gemini CLI é grátis? Qual é o limite de uso hoje e o que fazer quando a cota acaba

Fala aí, beleza? Se você usava o Gemini CLI logando com a conta Google e de repente parou de funcionar, não é bug do seu terminal haha

Em 18 de junho de 2026 o Google mudou quem pode usar a ferramenta, e hoje a pergunta "é de graça?" depende do jeito que você autentica: conta pessoal, chave do AI Studio, licença do Gemini Code Assist ou Vertex AI

Bora ver o que está liberado em cada caso, qual é o teto e o que fazer quando ele chega 🙂

O que mudou no Gemini CLI em 18 de junho de 2026

O Gemini CLI parou de atender contas individuais do Google: plano gratuito, Google AI Pro e Google AI Ultra

A página oficial de cotas do Gemini CLI diz isso com todas as letras: usuários do plano gratuito e do Google One foram migrados para o Antigravity CLI nessa data

O anúncio também saiu numa discussão no repositório oficial, indicando o Antigravity CLI como substituto para esse público

E quem não foi afetado?

Quem tem licença do Gemini Code Assist (Standard ou Enterprise) e quem autentica com chave de API seguem usando normalmente, conforme o perfil oficial do Gemini CLI

Ou seja: aquelas cotas antigas do login com conta Google que muita gente cita por aí não valem mais para conta pessoal

Se tu caiu num tutorial antigo prometendo isso, já sabe por que não bate com o que aparece hoje

Limites do Gemini CLI por tipo de acesso

A única rota gratuita que sobrou dentro do Gemini CLI é a chave da Gemini API sem pagamento, gerada no Google AI Studio

O resto é pago ou foi migrado, se liga na tabela:

Tipo de acesso	Limite por dia	Limite por minuto	Modelo e custo
Chave Gemini API gratuita (AI Studio)	250 requisições por usuário	10 requisições por usuário	Somente Flash, sem custo
Gemini Code Assist Standard	1.500 requisições por usuário	120 requisições por usuário	Assinatura pela Google Cloud
Gemini Code Assist Enterprise	2.000 requisições por usuário	120 requisições por usuário	Licença Enterprise
Chave Gemini API paga	Varia conforme o tier	Varia conforme o tier	Custo por modelo e tokens
Vertex AI	Cota dinâmica compartilhada ou capacidade provisionada	Cota dinâmica compartilhada ou capacidade provisionada	Custo por modelo e tokens
Conta Google pessoal (grátis, AI Pro, AI Ultra)	Não se aplica	Não se aplica	Migrada para o Antigravity CLI

Os limites por minuto da chave gratuita e do Code Assist também aparecem na documentação de cotas do repositório

Um detalhe importante: preço por token da chave paga e da Vertex AI depende do modelo e do uso, então não dá pra cravar um valor fixo aqui sem olhar a página de preços do Google na hora

Como usar o Gemini CLI de graça com uma chave do Google AI Studio

A ideia é simples: tu instala o CLI pelo npm, gera uma chave no Google AI Studio, joga ela numa variável de ambiente e roda o gemini

O requisito essencial é ter o npm instalado na máquina, nada de PC da Nasa aqui 😛

1. Instale o Gemini CLI globalmente pelo npm:

npm install -g @google/gemini-cli

2. Gere a sua chave da Gemini API no Google AI Studio, sem ativar pagamento

Guarde essa chave bem guardada, ela é o seu acesso, não sai colando em repositório público!

3. Se você já usou outro método antes, limpe as variáveis antigas:

unset GOOGLE_API_KEY
unset GEMINI_API_KEY

O erro comum deste passo: deixar a GOOGLE_API_KEY de uma configuração anterior ativa e achar que está usando a chave nova

A documentação de autenticação pede justamente esse unset ao trocar de método, então não pula essa parte

4. Defina a chave e rode o CLI:

export GEMINI_API_KEY="SUA_CHAVE"
gemini

Pra não precisar repetir o export toda vez que abre o terminal, as variáveis podem ficar salvas no arquivo ~/.gemini/.env

5. Dentro da sessão, confira se está tudo certo:

/stats

O /stats mostra o uso de tokens da sessão atual e a cota e o consumo dos modelos suportados

Se apareceu sua cota ali, beleza, o acesso gratuito está funcionando =)

Como o Gemini CLI escolhe o modelo: modo Auto e fallback

O Gemini CLI tem um roteamento inteligente chamado modo Auto, que vem ligado por padrão

Funciona assim: pedido simples vai para o Flash, tarefa complexa vai para o Pro

Quer mudar esse comportamento na sessão? O comando /model troca o roteamento enquanto você trabalha

E o fallback?

Se o modelo escolhido falhar por cota, rate limit ou erro, o CLI pede sua confirmação para trocar para um modelo reserva

Não é uma troca silenciosa: você vê o aviso e decide se aceita

Agora o ponto que mais confunde: com a chave gratuita, as requisições usam SOMENTE o modelo Flash

Então quem está no plano grátis não deve contar com o Pro, mesmo com o Auto ligado e tal

Cota do Gemini CLI acabou? Como ver o consumo e o que fazer com o erro 429

O sintoma é o erro 429 RESOURCE_EXHAUSTED no meio da tarefa

A causa: você passou de 10 requisições por minuto ou de 250 por dia na chave gratuita

Tome cuidado com uma pegadinha aqui! Segundo a página de rate limits da Gemini API, o limite vale por projeto, não por chave

Traduzindo: criar outra chave no mesmo projeto não resolve nada, o contador é o mesmo

O que fazer quando aparece o 429:

• Se estourou o limite por minuto, é só esperar o minuto passar e tentar de novo
• Se estourou o limite diário, a cota (RPD) zera à meia-noite no horário do Pacífico, o que no Brasil cai de madrugada (a hora exata muda por causa do horário de verão de lá)
• Se isso vira rotina, é sinal de que vale mudar para um acesso pago

E pra não perder o fio da tarefa enquanto espera, tem um passo a passo de como salvar a sessão e continuar sem reexplicar o projeto inteiro

Como prevenir:

• Rode /stats durante a sessão para ver o consumo
• Use /stats model para olhar a cota por modelo
• Consulte os limites ativos do seu projeto direto no Google AI Studio

Assim você enxerga o teto chegando antes de tomar o 429 na cara xD

Quando vale sair do plano gratuito do Gemini CLI

A resposta muda conforme o seu perfil, então bora por partes:

• Quem está testando ou faz projetos pequenos: a chave gratuita com Flash costuma bastar, 250 requisições por dia dá pra brincar bastante
• Dev individual que vive esbarrando no teto: chave da Gemini API paga, com cota definida pelo tier e custo por modelo e tokens
• Times em empresa: Gemini Code Assist Standard (1.500 requisições por dia) ou Enterprise (2.000 por dia), os dois com 120 requisições por minuto e limite diário fixo, o que facilita MUITO o planejamento
• Quem já vive no Google Cloud ou precisa de capacidade garantida: Vertex AI, com cota dinâmica compartilhada ou capacidade provisionada comprada antes

Pra Vertex AI com chave da Google Cloud, a configuração fica assim:

export GOOGLE_API_KEY="SUA_CHAVE"
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini

Também dá pra autenticar via ADC com o gcloud ou com uma conta de serviço, sem usar a chave

E lembra do unset das variáveis antigas ao trocar de método, beleza?

Vídeo do canal com o Gemini CLI

Aqui no canal tem um vídeo com o Gemini CLI rodando em projetos pesados, bom pra sentir a ferramenta em uso real 😀

Próximo passo

Na sua primeira sessão com a chave gratuita, roda o /stats depois de cada tarefa e anota quanto ela consumiu

Com isso na mão, fica fácil saber se 250 requisições por dia seguram o seu ritmo ou se é hora de olhar pra um acesso pago

Até o próximo post!

Quer aprender mais sobre inteligência artificial e programação na prática? Conheça o canal Hora de Codar no YouTube e acompanhe os próximos vídeos.