Bateu o limite do Gemini CLI? Como salvar a sessão e continuar a tarefa sem reexplicar o projeto

Fala aí, beleza? Se o limite do Gemini CLI te pegou no meio da tarefa, respira: o CLI salva a sessão sozinho, em segundo plano 🙂

O que falta é saber retomar essa sessão e deixar o estado do projeto fora do chat, pra não ter que reexplicar tudo do zero

Esse post é pra quem estava no meio de uma refatoração, de uma correção chata ou de uma migração e foi cortado pela cota

Só que antes, um aviso importante (e datado): desde 18/06/2026 o login com conta Google pessoal não funciona mais no Gemini CLI

Então, se tu usava a cota gratuita da conta pessoal, o tal "limite" pode ser na verdade o fim do acesso, e eu detalho isso logo abaixo

Ainda dá para usar o Gemini CLI com conta Google pessoal?

Não. Desde 18/06/2026 o Gemini CLI não atende mais contas individuais, e isso vale pro nível gratuito, pro Google AI Pro e pro Google AI Ultra

Formação Recomendada

Formação Claude Code

Domine Claude Code do absoluto zero até o avançado

• 120 aulas
• 4 projetos
• 9h 45min

Conhecer formação

A confirmação está na discussão oficial do repositório, e até 15/10/2026 nenhuma reversão foi encontrada

A mudança foi anunciada em 19/05/2026 no blog oficial do Google para desenvolvedores, junto com a migração do Gemini CLI para o Antigravity CLI

Quem continua usando o Gemini CLI, segundo a discussão de transição no repositório oficial:

• quem autentica com chave de API
• quem tem licença Gemini Code Assist Standard ou Enterprise pela organização
• quem acessa via Google Cloud

Só pra registro histórico: até 18/06/2026 o login pessoal dava 1.000 requisições por dia e 60 por minuto, sem custo

Esse número não vale mais, então desconfia de tutorial que ainda apresenta isso como opção atual

Qual limite do Gemini CLI você estourou (e quando ele volta)

Depende de como tu autentica hoje: chave de API (Gemini API) ou licença Gemini Code Assist

Cada caminho tem uma régua diferente, então vale identificar o teu antes de sair esperando a cota voltar

Chave de API: RPM, TPM ou RPD?

Na Gemini API, os limites são medidos em três dimensões, conforme a página oficial de rate limits:

• RPM: requisições por minuto
• TPM: tokens de entrada por minuto
• RPD: requisições por dia

Estourou qualquer uma delas, vem erro de limite

Se liga num detalhe que pega MUITA gente: os limites valem por projeto, não por chave

Ou seja, criar outra chave no mesmo projeto não resolve nada haha

A cota diária (RPD) zera à meia-noite no horário do Pacífico, então se foi ela que estourou, anota esse horário

Os limites também dependem do nível de uso do projeto, e os valores ativos de cada um aparecem no Google AI Studio

Os requisitos de cada nível (dados consultados em 15/10/2026) são estes:

Os números de RPM, TPM e RPD por modelo não estão nessa página oficial, ela manda conferir no AI Studio

Então confere lá, no teu projeto, em vez de confiar em print antigo de fórum

Gemini Code Assist Standard: 1.500 requisições por usuário por dia

No Gemini Code Assist Standard, o máximo é 1.500 requisições de modelo por usuário por dia

Parece muito, né? Só que um único prompt pode gerar várias requisições

É por isso que a cota some mais rápido que o esperado quando o agente fica lendo arquivo, rodando ferramenta e tentando de novo

Como ver o consumo e evitar o próximo estouro

Dentro do CLI, o /stats mostra o uso de tokens e a duração da sessão

Já o /compress troca todo o contexto do chat por um resumo, o que ajuda a não carregar uma conversa gigante em cada requisição

E se a tarefa é enorme, dividir em etapas menores ajuda bastante, a mesma lógica de fatiar tarefas longas que vale pra outros modelos

Pra quem usa chave de API, acompanha também o uso do projeto no Google AI Studio

O que se perde e o que fica salvo quando o limite corta a sessão

O histórico não se perde 😀

Segundo a documentação de gerenciamento de sessões, o Gemini CLI salva cada sessão automaticamente em segundo plano, com:

• o histórico da conversa
• as execuções de ferramentas (entradas e saídas)
• as estatísticas de tokens
• os resumos de raciocínio, quando existem

Por padrão, essas sessões ficam guardadas por 30 dias

Se a tua pausa vai ser longa, dá pra mudar esse prazo em /settings ou no settings.json, com valores como "24h", "7d" ou "4w"

E os checkpoints salvos com /chat ficam em:

• Linux e macOS: ~/.gemini/tmp/<project_hash>/
• Windows: C:\Users\<Usuario>\.gemini\tmp\<project_hash>\

Agora, o que NÃO está garantido: o estado dos arquivos se a cota caiu no meio de uma edição e o checkpointing estava desligado (que é o padrão)

Tome cuidado com isso! Antes de pedir o próximo passo, revisa os arquivos que estavam sendo alterados

Como retomar a sessão do Gemini CLI depois do limite

Que sessão? Aquela que o CLI salvou sozinho, com conversa e ferramentas, e que tu só precisa reabrir

Bora ver na prática:

1. Abre o terminal na pasta do mesmo projeto. A retomada é restrita ao projeto atual, então pra abrir a conversa de outro projeto tu precisa rodar o CLI na pasta dele. Erro comum deste passo: abrir o CLI em outra pasta e achar que a conversa sumiu

2. Retoma direto ao iniciar. Use o --resume e escolha a sessão pelo índice numérico ou pelo UUID:

gemini --resume

3. Ou retoma de dentro do CLI. O /resume abre o navegador de sessões em ordem cronológica, a tecla / filtra a lista e o Enter restaura o contexto completo

/resume

4. Marca pontos com nome pra achar fácil depois. O /chat continua existindo e é um alias de /resume, com estes subcomandos:

/chat save <tag>
/chat list
/chat resume <tag>
/chat delete <tag>

Erro comum deste passo: esquecer qual tag tu usou. Pra isso existe o /chat list, então roda ele antes de sair chutando nome

5. Checagem final. Depois de restaurar, faz uma pergunta curta tipo "qual era o último passo que a gente fez?" e confere se a resposta vem com o contexto da tarefa. Se vier genérica, provavelmente tu restaurou a sessão errada

Como ligar o checkpointing e usar o /restore

O resultado aqui é poder voltar arquivos E conversa ao ponto anterior de uma edição interrompida

Só que o checkpointing vem desligado, e ele precisa estar ligado ANTES da interrupção, senão não tem o que restaurar

1. Liga o checkpointing no settings.json. Adicione esta chave, conforme a documentação de checkpointing:

{
  "general": {
    "checkpointing": {
      "enabled": true
    }
  }
}

Erro comum deste passo: tentar a flag --checkpointing na linha de comando. Ela foi removida na versão 0.11.0, então o caminho agora é o settings.json

2. Entende o que passa a acontecer. Com isso ligado, o CLI cria um checkpoint antes de cada ferramenta que altera arquivos, como write_file ou replace. Esse checkpoint guarda um snapshot Git num repositório sombra na pasta home, o histórico da conversa e a chamada de ferramenta pendente

3. Usa o /restore quando precisar voltar. Ele devolve os arquivos do projeto ao estado do snapshot, restaura o histórico da conversa e depois propõe de novo a chamada de ferramenta original

/restore

É tipo um ctrl+z do projeto inteiro, com a conversa junto, muito massa pra quando a cota cai no meio de uma edição grande

O que escrever no GEMINI.md antes de parar

Por que GEMINI.md? Porque ele é o arquivo de contexto padrão do CLI

O Gemini CLI junta os GEMINI.md de vários locais, de forma hierárquica, e envia esse conteúdo em todo prompt, segundo a documentação oficial do CLI

Então o estado da tarefa sobrevive mesmo se tu abrir uma sessão nova do zero

Um modelo de bloco pra colar no GEMINI.md do projeto (é um exemplo didático, adapta pro teu caso):

## Estado da tarefa

- Objetivo: <o que a tarefa precisa entregar>
- Já feito: <etapas concluídas>
- Arquivos tocados: <lista de arquivos alterados>
- Próximo passo: <a próxima ação exata>
- Decisões: <escolhas feitas e o motivo>
- Não mexer: <arquivos ou partes que devem ficar como estão>

Os comandos que ajudam aqui:

• /memory show: mostra o contexto concatenado que está sendo carregado
• /memory refresh (ou reload): relê todos os GEMINI.md depois que tu editou
• @arquivo.md: importa outro arquivo, útil se tu prefere deixar as notas de estado separadas

Erro comum: usar /memory add achando que ele grava no GEMINI.md do projeto

Na real ele acrescenta o texto no GEMINI.md global, então o estado de um projeto pode ir parar no contexto de todos haha

Checagem: roda /memory show e confere se o bloco "Estado da tarefa" aparece lá

Checklist de saída quando o limite estiver perto

Quando a cota estiver acabando, roda isso antes de parar:

1. /stats pra ver o consumo da sessão
2. /chat save <tag> com um nome descritivo (tipo refatoracao-auth-etapa2)
3. Atualizar o bloco de estado no GEMINI.md e rodar /memory refresh
4. Confirmar que o checkpointing está ligado antes de pedir edições grandes
5. Anotar qual limite estourou e quando ele zera (o RPD zera à meia-noite no horário do Pacífico)
6. Na volta: abrir a mesma pasta do projeto e usar /resume ou gemini --resume

Vídeo: Gemini 4 Argon no Gemini CLI

No canal tem um vídeo sobre o lançamento do Gemini 4 Argon rodando no Gemini CLI com projetos pesados

E se tua dúvida é como montar o pedido de uma tarefa grande pro modelo, vale entender o que é raciocínio de longo horizonte antes de soltar aquela refatoração gigante

Próximo passo

Antes da próxima tarefa longa, faz duas coisas: liga o checkpointing no settings.json e cria o bloco "Estado da tarefa" no GEMINI.md do projeto

Leva poucos minutos e é exatamente o que te salva quando a cota cai no pior momento

Se tu perdeu o acesso porque usava conta pessoal, confere qual tipo de autenticação tu tem disponível: chave de API, licença Gemini Code Assist ou Google Cloud

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.