Bati no limite do Claude Code: o que fazer agora

Antes de qualquer coisa, descubra qual limite você bateu — são três, e a saída é diferente em cada um:

• Janela curta. A mensagem traz um horário de retomada, normalmente poucas horas à frente. É a mais comum.
• Teto semanal. Aparece em planos com cota semanal e não volta antes da virada da semana.
• Capacidade momentânea. Não é sua cota: é fila do outro lado. Costuma passar em minutos.

A diferença importa: na primeira e na terceira, esperar resolve. Na segunda, esperar custa dias.

O limite tem horário — e isso é medido

Medimos 145.013 tentativas do nosso gateway ao longo de 7 dias e separamos por hora do dia. O resultado é mais útil que qualquer conselho genérico:

O limite é um fenômeno de horário de pico. Às 17h, mais de uma tentativa em cada oito esbarra em limite. De madrugada, praticamente nenhuma — e não é amostra pequena: são milhares de tentativas em cada faixa.

A consequência prática é direta: tarefa longa e pesada rende muito mais fora do fim da tarde. Refatoração grande, migração, varredura de repositório — se puder escolher a hora, escolha a madrugada ou o começo da manhã.

O que fazer agora, em ordem

1. Leia a mensagem inteira. Se ela traz horário, ele é literal e a cota volta de uma vez, não aos poucos.
2. Não repita na hora. Tentar de novo dentro da janela fechada não devolve acesso.
3. Corte o contexto antes de voltar. É o que mais economiza. A requisição típica do Claude Code sobe dezenas de milhares de tokens — veja quantos tokens ele consome de verdade. Feche arquivos que não são da tarefa e comece sessão nova quando o assunto mudar.
4. Baixe o modelo para a tarefa certa. Renomear variável e escrever teste simples não precisam do modelo mais caro.
5. Se for urgente, mude a hora. A tabela acima é a razão: o mesmo trabalho às 3h da manhã encontra um sistema quase vazio.
6. Confirme que é limite mesmo. Código 429 é limite. Código 401 é acesso ou endereço base errado — problema diferente, veja a página de configuração. Se for 429, o detalhe está em erro 429 no Claude Code.

Erros comuns

• Trocar de chave. Limite não é problema de chave. Chave ruim devolve 401, não 429.
• Assinar um plano maior no susto. Sem antes olhar o consumo, é chute caro. Meça primeiro.
• Continuar a mesma sessão depois de destravar. O histórico inteiro sobe de novo a cada mensagem, e você volta a bater no limite mais rápido.
• Rodar tarefa pesada no fim da tarde. É o pior horário, com folga.

Como medimos

Fonte: o histórico de uso do nosso próprio gateway, janela de 7 dias encerrada em 9 de setembro de 2026, 145.013 tentativas de roteamento agrupadas por hora. Horários convertidos de UTC para o horário de Brasília. Cada linha é uma tentativa de rota, não uma requisição do usuário — parte delas é absorvida por nova tentativa e nunca chega à sua tela. As faixas com percentual mais alto são também as de maior volume, então não são efeito de amostra pequena. Números agregados, sem nenhum dado identificável de cliente.

O que não medimos: quanto tempo, em média, leva até a cota voltar depois de um bloqueio. A consulta necessária é pesada e rodaria sobre o banco que atende clientes; preferimos não medir a medir mal.

Perguntas frequentes

Quanto tempo até liberar?
Se a mensagem trouxe horário, até ele. Sem horário, a janela costuma ser de poucas horas. Limite semanal é a exceção: só volta na virada da semana.

Usar menos o modelo grande resolve?
Ajuda, mas menos do que controlar o contexto. O que pesa é o tamanho do que sobe a cada mensagem, não qual modelo responde.

Vale a pena esperar ou vale mudar de plano?
Depende de bater todo dia ou uma vez por mês. Se é todo dia no mesmo horário, o problema é o horário e o tamanho do contexto antes de ser o plano.

Por que às vezes trava sem mensagem nenhuma?
Porque a requisição pode ficar em fila esperando a janela virar em vez de falhar na hora. Parece travamento e é espera.

No CodeJato é diferente?
A mensalidade é fixa em reais e não há cobrança por token, então não existe susto na fatura. Limite de capacidade existe em qualquer serviço, e por isso publicamos a frequência real acima em vez de prometer que nunca acontece. Ver os planos.