As mensagens exatas e o significado de cada uma
API Error: 429 {"type":"rate_limit_error", ...}/ "limite de taxa atingido" — você excedeu o limite de requisições, tokens ou concorrência para o intervalo. Aguarderetry-after.rate limit reached for <model>com uma observação específica do modelo — os limites são por modelo; mudar de nível com/modelcostuma funcionar imediatamente.- "Você atingiu seu limite de uso" / "o limite é redefinido às …" — não é um limite de taxa: é o teto de uso em janela móvel da assinatura Pro/Max. Aguarde a redefinição ou use uma chave de API.
529 overloaded_error— é uma questão de capacidade, não de você. Tente novamente com intervalos progressivos; o guia de erros aborda isso.400 … tool use concurrency— chamadas de ferramentas em paralelo demais em um único turno; não é um 429, mas aparece nas mesmas sessões.
Limites de taxa do Claude: os três tetos
A Anthropic aplica limites de requisições por minuto (RPM), tokens de entrada e saída por minuto (ITPM/OTPM) e requisições simultâneas em andamento, por modelo e por organização, ajustados conforme o nível de uso — o nível aumenta automaticamente à medida que seus gastos acumulados crescem. Os gateways aplicam seus próprios limites equivalentes por conta. Os números são publicados na documentação da Anthropic e exibidos no seu console; os que importam para o Claude Code são a concorrência e OTPM, porque uma sessão de agente é uma sequência de requisições longas, paralelas e com grande volume de saída.
Por que o Claude Code atinge o limite quando um cliente de chat não atinge
Um cliente de chat envia uma requisição por vez. O Claude Code usa streaming em cada turno (ocupando uma vaga de concorrência durante toda a sua duração), executa subagentes em paralelo (cada um ocupa outra vaga) e reenvia toda a conversa a cada turno (os tokens por minuto aumentam com a duração da sessão). Dez subagentes em um repositório grande significam dez streams simultâneos e centenas de milhares de tokens por minuto — esse é o 429.
Soluções, em ordem de frequência de sucesso
- 1. Deixe-o tentar novamente. O Claude Code respeita
retry-after; a maioria dos erros 429 se resolve em segundos. - 2. Execute menos subagentes em paralelo; coloque tarefas pesadas em sequência em vez de distribuí-las simultaneamente.
- 3.
/compact— um contexto menor significa menos tokens por turno, o que permite reduzir o TPM. - 4. Mude de nível com
/modelpara a tarefa atual; os limites são por modelo. - 5. Transfira o trabalho em segundo plano para o Haiku; mantenha Sonnet/Opus para o ciclo principal.
- 6. Solicite um limite mais alto: na Anthropic, por meio do nível de gastos ou de uma solicitação à equipe de vendas; neste gateway, envie um e-mail ao suporte com sua conta e a carga de trabalho — novas contas começam com limites conservadores de concorrência justamente para que um agente fora de controle não esgote o pool, e esses limites são aumentados mediante solicitação.
/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20Limites de taxa neste gateway
As requisições são cobradas do seu saldo ou de um plano de preço fixo; os limites de taxa são por conta e independem do preço. O gateway reúne várias contas de provedores upstream, então um 429 por modelo em uma delas é tratado redirecionando a requisição, em vez de exibir o erro, quando outra tem capacidade disponível — uma das razões pelas quais as sessões aqui apresentam menos erros 429 do que com uma única chave do console. A concorrência é o limite que você provavelmente atingirá; escreva ao suporte informando o número de agentes que executa em paralelo, e ele será ajustado.
| Plano | Duração | Preço |
|---|---|---|
| Ilimitado por 1 hora | 1 hora | $1 |
| Ilimitado por 24 horas | 24 horas | $10 |
| Ilimitado por 1 semana | 1 semana | $49 |
| Ilimitado por 15 dias | 15 dias | $89 |
Experimente gratuitamente primeiro
Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyPerguntas frequentes
O que significa 'erro de API: limite de taxa atingido' no Claude Code?
Um HTTP 429: você excedeu o limite de requisições, tokens ou requisições simultâneas por minuto para esse modelo. O Claude Code aguarda o intervalo de retry-after e tenta novamente; se o problema persistir, reduza os subagentes em paralelo e use /compact.
Quais são os limites de taxa do Claude?
Requisições por minuto, tokens de entrada/saída por minuto e requisições simultâneas, por modelo, ajustados conforme o nível de uso na Anthropic e por conta em um gateway. Concorrência e tokens de saída são os limites que as sessões de agentes atingem.
Como obtenho um limite de taxa mais alto para o Claude?
Na Anthropic: gaste mais (os níveis aumentam automaticamente) ou entre em contato com a equipe de vendas. Neste gateway: envie um e-mail ao suporte com sua carga de trabalho; o limite de concorrência é aumentado mediante solicitação.
'Limite de uso atingido' é o mesmo que um limite de taxa?
Não. Esse é o teto em janela móvel da assinatura Pro/Max. Um limite de taxa é por minuto e deixa de ser aplicado automaticamente; um teto de uso é redefinido conforme seu cronograma.
Execute o Claude Code no gateway
Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.
Obter uma chave de API Ver planos ilimitadosA AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.