Início › Claude Code › Erros › Sobrecarga / 529
Visão geralInstalaçãoreferência da CLIPreços e limitesAgent SDKSkills e pluginsGitHubWeb, desktop e IDEModelosErrosCódigo aberto?TutorialPara estudantesAutomação de QAvs Cursorvs Codex e OpenCodeSubagentesHooksMCPEcossistemaVS CodeOpenRouterLimites de requisiçõesGuia em chinês
Última atualização: 11 de outubro de 2026

Erro "Sobrecarregado" no Claude (erro 529 de API): o que significa e o que fazer

API Error: 529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}} significa que o modelo está funcionando, mas não tem capacidade para sua solicitação neste momento. Não é um limite da sua conta — todos que usam esse modelo veem isso ao mesmo tempo. As correções envolvem aguardar de forma inteligente e evitar uma enxurrada de solicitações.

TLDR

  • 529 = o modelo está saturado para todos. Não é sua chave nem seu plano.
  • O Claude Code tenta novamente por conta própria ("Nova tentativa em N segundos… tentativa x/10"); deixe-o continuar.
  • Trocar de nível com /model costuma funcionar imediatamente — a capacidade é específica de cada modelo.
  • Iniciar muitos subagentes ao mesmo tempo faz com que os erros 529 ocorram de forma correlacionada; execute menos em paralelo.

O que você vê

API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 1 seconds… (attempt 1/10)
API Error (529 {"type":"error","error":{"type":"overloaded_error","message":"Overloaded"}}) · Retrying in 2 seconds… (attempt 3/10)

Essas linhas vêm de #3572, a onda de julho de 2025 que reuniu 274 comentários — muitos de pessoas no plano Max de $200, o que reforça o ponto: 529 é uma questão de capacidade, e uma assinatura mais cara não reserva capacidade alguma. O erro continua sendo relatado: #91817 ("tentativas excessivas de repetição"), #91849 e #91825 foram todos registrados em 3 de setembro de 2026.

Por que isso acontece

  • Picos de demanda em um modelo. Novos lançamentos e manhãs de dias úteis nos EUA são os picos clássicos; o modelo principal mais recente é o mais disputado.
  • Sua própria execução em paralelo. #90043 analisou 60 dias de transcrições e descobriu que a maioria dos erros 529 ocorreu em rajadas: um orquestrador inicia N agentes ao mesmo tempo, eles acessam a API juntos, e a maior parte do lote falha no mesmo minuto.
  • Trabalho perdido. #89267 e um relato relacionado observam que um 529 pode encerrar um subagente em segundo plano em vez de tentar novamente — portanto, uma rajada não apenas atrasa o trabalho, mas também descarta tarefas.

Soluções

  • 1. Deixe o mecanismo integrado de novas tentativas funcionar. A maioria dos erros 529 desaparece dentro das 10 tentativas.
  • 2. Mude de categoria de modelo: /model para Sonnet (ou Opus) na etapa atual; volte mais tarde.
  • 3. Execute menos subagentes ao mesmo tempo e escalone as execuções em paralelo; uma rajada de primeiras solicitações simultâneas é o que transforma um 529 em dez.
  • 4. Execute novamente os subagentes descartados explicitamente — verifique se cada unidade da execução em paralelo realmente terminou.
  • 5. Fora dos horários de pico para tarefas grandes: execuções autônomas longas têm muito menos chance de atingir o limite de capacidade fora do horário de trabalho dos EUA.

529 vs 500 vs 429

  • 529 Sobrecarregado — capacidade, afeta todos, temporário. Aguarde ou troque de modelo.
  • 500 — falha do servidor. Consulte Erro de API 500.
  • 429 — seu próprio limite (solicitações, tokens, concorrência). Consulte limites de taxa.

Neste gateway

O gateway distribui o tráfego entre várias contas do provedor e, ao receber um 529, tenta novamente em outra antes de desistir, para que uma única conta saturada não interrompa sua sessão. Quando um modelo está saturado em todas as contas, você ainda verá o erro — escolha outra categoria de modelo com /model. A mesma configuração de sempre: ANTHROPIC_BASE_URL=https://aiprimetech.io e uma chave do gateway.

Cansado de lidar com esse problema?

Execute o Claude Code pelo gateway da AI Prime Tech: os mesmos modelos Claude nas contas upstream do próprio gateway, duas variáveis de ambiente para fazer a mudança, e novas contas recebem $5 em crédito gratuito para a API com o código FIXIT — sem cartão.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Crie uma conta com o código FIXIT

Perguntas frequentes

O que significa o erro de sobrecarga do Claude?

O modelo não tem capacidade disponível naquele momento (HTTP 529, overloaded_error). Isso afeta todos que usam esse modelo e se resolve por conta própria.

Como corrigir o erro 529 da API do Claude?

Deixe o Claude Code tentar novamente, mude de categoria de modelo com /model e execute menos subagentes em paralelo. Para tarefas grandes, escolha horários fora do pico.

Uma assinatura Max evita erros de sobrecarga?

Não. 529 é uma questão de capacidade, não de limites do plano — usuários Max relatam o erro com a mesma frequência que os demais.

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 FIXIT.

Obter uma chave de API Ver planos ilimitados

A 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.

Mais guias do Claude Code

Erros do Claude Code e como corrigi-los"Erro de API: 500" no Claude Code: o que significa e o que realmente resolveErro 400 da API do Claude Code: prompt longo demais, concorrência no uso de ferramentas e os demaisErros de OAuth no Claude Code: tempo limite de 15000ms excedido e código de status 500"O processo do Claude Code foi encerrado com o código 1": como encontrar o erro real e corrigi-lo"O prompt é longo demais", "A entrada é longa demais para o modelo solicitado" e "Limite de contexto atingido" no Claude: o que preenche a janela e como liberar espaçoLimite de uso do Claude atingido: limites de sessão, semanais e do Opus, "limites especificados de uso da API", "o saldo de créditos é insuficiente" — e o que fazerErros 401 e 403 no Claude Code: credenciais de autenticação inválidas, chave de API inválida, "Você não está conectado", host_not_allowedErros de conexão no Claude Code: ECONNRESET, conexão perdida durante a resposta, "Aguardando resposta da API", "Não foi possível conectar à API", erros de certificado SSLO Claude Code trava, fica preso ou para de responder: como descobrir onde travou e sair dessa situaçãoClaude.ai não funciona: "Algo deu errado", restrições de capacidade, "limite de 5 horas atingido", "erro ao fazer login" e os demais