Erro Claude too many requests (429): é o limitador da Anthropic, não o limite do seu plano, e as seis correções em ordem

Como corrigir o erro too many requests do Claude?

Siga estes seis passos em ordem. Nenhum deles mexe nos seus chats nem no seu plano.

1. Espere um minuto e tente de novo uma vez. A referência de erros do Claude Code da Anthropic diz "Wait briefly and try again". Apertar tentar de novo sem parar só manda mais requisições.
2. Atualize o Claude Code com claude update. A versão 2.1.199 e as posteriores repetem esses limitadores com backoff antes de você vê-los. A versão atual é a 2.1.316, de 31 de outubro de 2026.
3. Rode /status e confira a credencial ativa. A Anthropic avisa que "A stray ANTHROPIC_API_KEY in your environment can route requests through a low-tier key instead of your subscription."
4. Feche sessões e subagentes extras. Para 429 em uma chave de API, a documentação diz para "avoid running many parallel subagents". No registro de um assinante Max, 114 de 122 minutos com 429 tinham seis ou mais sessões de desktop abertas.
5. Troque o modelo com /model. Na API, cada linha de modelo tem seus próprios pedidos e tokens por minuto, então um modelo menor pode manter um script rodando.
6. Confira status.claude.com e depois relate. Se nada estiver publicado e o erro durar horas, envie a mensagem exata e o request ID.

Este é o texto que o Claude Code mostra: "API Error: Server is temporarily limiting requests (not your usage limit)". A explicação da Anthropic cabe em uma linha: "The API applied a short-lived throttle that is unrelated to your plan quota." O Claude Code o distingue de um limite real "by the absence of the unified quota headers a real limit response carries". Na aba Code do app Claude para desktop, um relato de bug de 30 de maio de 2026 mostra o mesmo limitador como "Server is temporarily limiting requests" sobre uma linha que diz "Too many requests right now". É essa a busca "claude too many requests right now" que as pessoas fazem.

Em 2 de novembro de 2026, pesquisamos no rastreador de issues do Claude Code público da Anthropic todas as issues de 2026 cujo título ou corpo contém "temporarily limiting requests". Voltaram 410. Uma conta abriu 275 delas, e seus relatos do fim de julho citavam todos o Claude Code 2.1.114, uma versão de abril. Deixamos essa conta de fora. As outras 135 vieram de 125 pessoas diferentes, e 129 delas foram abertas antes de julho. A entrada do changelog para a 2.1.199 diz: "Transient server rate-limit errors (429s unrelated to your usage limit) are now retried automatically with backoff for subscribers instead of failing the turn". O limitador não sumiu. Um relato de setembro contou 195 429 repetidos em um único dia. Leia a queda como menos turnos com falha, não menos 429.

Qual mensagem Claude too many requests você está vendo?

O texto da mensagem diz de quem é o limite que você atingiu. Esta tabela cobre o Claude Code, o app Claude para desktop e a API do Claude, conforme lido em 2 de novembro de 2026.

O guia de mensagens de erro da Anthropic para os apps do Claude não lista nenhuma mensagem "too many requests". Suas mensagens de limite atingido citam sempre um horário de reinício; só os avisos de "approaching" não citam. Então, se a sua mensagem cita um horário, você atingiu o limite do plano, e Claude usage limit reached traz as correções. Se diz overloaded ou 529, é capacidade, tema de Claude overloaded.

Por que o Claude diz too many requests quando seu uso é baixo?

O Claude diz too many requests com pouco uso porque o limitador conta a velocidade com que as requisições chegam, não quanto do plano você gastou. A página de limites da Anthropic diz que os limites podem pesar em intervalos curtos: "a rate of 60 requests per minute (RPM) might be enforced as 1 request per second." Assim, uma rajada de chamadas pode falhar mesmo com a sua média do minuto parecendo boa.

Os relatos de bug mostram isso com clareza. Um assinante Max em 30 de maio de 2026 recebeu o limitador no dia em que seus limites tinham sido reiniciados. Um relato de 18 de agosto viu 429 persistentes com 1% de uso. Um relato de 24 de setembro, com 26 a 27% de uso do plano, teve um 429 em 14% dos minutos de sessão com seis ou mais sessões de desktop abertas. Com cinco ou menos, ficou abaixo de 1%.

Um crescimento repentino também o aciona. A página de erros da API da Anthropic diz "if your organization has a sharp increase in usage, you might see 429 errors because of acceleration limits on the API." O conselho é "increase your traffic gradually and maintain consistent usage patterns." Um fluxo do Claude Code que abre muitos subagentes ao mesmo tempo gera exatamente esse pico. A Anthropic não publica os números por trás do limitador para quem usa um plano do claude.ai.

Quanto tempo dura o erro too many requests do Claude?

O limitador do Claude costuma passar em segundos ou minutos. O Claude Code repete 429 transitórios até 10 vezes com backoff exponencial e mostra Retrying in Ns · attempt x/y enquanto espera. Você só vê o erro quando essas tentativas acabam.

Alguns relatos duraram bem mais. Quem relatou em 30 de maio disse que durou "two days" e que uma nova sessão o deixou trabalhar por "3 hours at least" antes de voltar. Um relato de 15 de junho disse que o limitador durava "for the last 24 hours" no Opus 4.8. No tópico de maio, uma nova sessão e outro modelo fizeram as pessoas voltar a trabalhar. Se ainda estiver lá depois de uma hora com uma só sessão aberta, não é você que pode resolver.

Para tarefas que rodam enquanto você está fora, o Claude Code tem um interruptor. Defina CLAUDE_CODE_RETRY_WATCHDOG=1 e ele repete erros 429 e 529 sem parar. Limite a espera com CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS, por exemplo 3600000 para uma hora. Defina CLAUDE_CODE_MAX_RETRIES=2 se, em vez disso, um script deve falhar rápido.

Pagar pelo Claude Max acaba com o too many requests?

Não. O limitador é "unrelated to your plan quota", e os relatos acima vieram de assinantes Pro e Max. Em novembro de 2026, o Claude custa $20 por mês no Pro, $100 no Max e $200 no Ultra, segundo a página de preços da Anthropic. O Max lista "Priority access at high traffic times". A Anthropic não diz se isso cobre o limitador ou não.

O Whizi, que publica esta página, tem o mesmo tipo de proteção e mostra os números: 10 mensagens de chat por minuto e 60 por hora por usuário, iguais em todos os planos. O erro por minuto diz "Too many requests. Please wait and try again." e uma requisição recusada não gasta nada da sua cota (limites do Whizi). Onde o Whizi perde: 60 por hora é um teto rígido, e o Claude Max não mostra nenhum número por hora.

Como corrigir um 429 rate_limit_error da API do Claude?

Leia o corpo do erro antes de tentar de novo, porque a API do Claude envia 429 rate_limit_error para mais de um problema. A página de erros da Anthropic diz que sua organização "has hit a rate limit, reached its usage tier's monthly spend cap, or reached a spend limit on the Claude Code workspace." Só alguns desses casos passam com o tempo.

Dois detalhes pegam as pessoas. Primeiro, um limite de gasto que você mesmo definiu não é um 429. É um 400 invalid_request_error que começa com "You have reached your specified API usage limits". Segundo, os tetos de gasto são $500 por mês no Start, $1,000 no Build e $200,000 no Scale. No teto, "API usage pauses until 00:00 UTC on the first day of the next month", e até as novas tentativas automáticas do SDK falham até lá.

Os limites pertencem à sua organização como um todo, não a uma chave. No nível Start, o Claude Opus 5.5, o Sonnet 5.5 e o Haiku 5.5 recebem cada um 4,000 pedidos por minuto e 2,000,000 tokens de entrada por minuto, em novembro de 2026. Organizações novas podem começar com menos, em um nível Evaluation. Na maioria dos modelos, os tokens lidos do cache não contam para os tokens de entrada por minuto, então o cache de prompt eleva o teto real que você tem. O SDK oficial repete 429 duas vezes por padrão e respeita retry-after. Acompanhe o cabeçalho anthropic-ratelimit-requests-remaining em cada resposta e reduza o ritmo antes de chegar a zero.