Claude Code overloaded (529): conserte o erro de capacidade rápido
O que o erro 529 Overloaded realmente é — capacidade do lado da Anthropic, não a sua conta — além da checagem de status, a troca via /model, a variável de ambiente de backoff do Claude Code 2.1.296 e a diferença entre 529, 429 e 500 — tudo em capturas reais.
O 529 num relance
- 529 Overloaded significa que a API da Anthropic está temporariamente em capacidade máxima para todos os usuários — a documentação oficial diz literalmente que "não é o seu limite de uso e não entra na sua cota". Nunca é um ban.
- O primeiro passo nunca muda: consulte status.claude.com (ou dê um curl -I) para ver se o próprio Claude está degradado — nosso guia de status ao vivo ensina a ler a página.
- Soluções imediatas, em ordem: deixe o retry automático do Claude Code terminar, rode /model e troque para um modelo mais leve (a capacidade é contada por modelo), baixe a concorrência de ferramentas.
- Desde o Claude Code 2.1.296 você pode definir CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS para esticar o teto de backoff dos retries de 529 em sessões longas.
- 529 ≠ 429: um 429 é a sua chave batendo no próprio rate limit (lado seu), um 529 é a capacidade cheia para todo mundo (lado da Anthropic), um 500 é uma falha interna inesperada da API (espere um minuto e reenvie).
How to Fix Claude API "Overloaded" Error (529 Status Code)
CanalNexustech4:32
Claude errors reference — 529, 429, 500 & retry tuning
Docscode.claude.com/docs
Os quadros vêm de uma única gravação limpa — o banner de capacidade "currently unavailable", a checagem de status com curl no VS Code, o seletor de modelos com o modelo sobrecarregado esmaecido, o layout de failover 529 e o chat de suporte dentro do app (Nexustech, JGlrcRDtdls). Outros três vídeos — a demo de CLI do Extreme Guides (_oEU-6xbcWs, comandos que não existem no Claude Code), o artigo narrado do Izoate (fHlvs5evSi0, botões queimados e logo do canal) e o conserto do 400 do Last Error Fixer (vHEi32hIh1I, legendas queimadas) — forneceram fatos, mas foram descartados como fonte de quadros. A redação dos erros segue a documentação oficial de erros e o changelog do Claude Code 2.1.296 (2026-10-09). Cada passo aponta para o segundo exato do vídeo de origem.
Os quadros do vídeo permanecem propriedade de seus criadores e são incorporados aqui como documentação passo a passo, com atribuição e links diretos.
Conserte o Claude Code overloaded (529) passo a passo
Passo 1 — Confirme que é a Anthropic, não você
- 1
Reconheça como fica o estado de sobrecarga
Um 529 é pressão de capacidade no Claude inteiro, então os sinais aparecem ao mesmo tempo em todas as superfícies: o app Claude exibe um banner "currently unavailable" sobre a caixa de texto, chamadas diretas à API voltam com HTTP 529 e corpo overloaded_error, e o spinner do Claude Code passa para "Retrying… attempt x/y". Se só o seu terminal falha enquanto o app funciona, desconfie do seu ambiente local — nosso guia de sessões travadas cuida desse caminho.
A home do app Claude com o banner "Claude Fable 5 is currently unavailable" — a mesma pressão de capacidade que um 529 reporta ao seu terminal.Assistir em 0:02 - 2
Consulte primeiro a página de status oficial
Abra status.claude.com antes de mexer em qualquer configuração — é a única fonte oficial para degradações e quedas. No terminal, curl -I https://status.anthropic.com/ leva direto à página de status. Painel todo verde com 529 significa que a sobrecarga é de um modelo específico e as soluções abaixo valem do mesmo jeito; painel vermelho significa seguir o incidente, não o seu runbook. Nosso guia de status ao vivo explica como ler a página e quais seções anunciam erros de terminal.
curl -I contra status.anthropic.com no terminal do VS Code — o redirect 307 aterrissa com o location em status.claude.com: vê-se na hora se o 529 é oficial.Assistir em 1:00 - 3
Elimine os suspeitos locais
Rode /status dentro do Claude Code: ele mostra o modelo ativo, sua conta e a conectividade. Um 529 não custa nada — a documentação é explícita que ele "não entra na sua cota" — então aqui não há barra de uso a vigiar. Se o /status mostra a conta certa e uma conexão saudável, o erro é mesmo do lado do servidor; todo o resto (401, 403, erros de cobrança) pertence a outros guias.
Passo 2 — Soluções imediatas para destravar
- 4
Deixe o retry integrado terminar o serviço
O Claude Code já repete falhas transitórias até 10 vezes com backoff exponencial antes de mostrar um erro, e o spinner faz a contagem ("Retrying in 8s · attempt 2/7"). No meio de uma rajada de 529, o mais esperto costuma ser esperar esses tentativas terminarem em vez de martelar Enter — cada pedido extra entra na mesma fila de capacidade. Se as tentativas se esgotarem e o erro continuar, siga para o próximo passo.
- 5
Troque para um modelo mais leve com /model
A capacidade é contada por modelo, e é por isso que a primeira sugestão da documentação diante da sobrecarga é: "Run /model and switch to a different model to keep working." Digite /model no prompt do Claude Code e escolha uma faixa abaixo — modelos da classe Sonnet e Haiku seguem respondendo enquanto o carro-chefe está sufocado. O mesmo seletor no app Claude marca o modelo sobrecarregado como "Currently unavailable": você vê quais faixas estão fechadas antes de escolher.
O seletor de modelos com Fable 5 marcada como "Currently unavailable", a marcação ficando em Sonnet 4.6 e Haiku 4.5 ainda selecionável.Assistir em 1:36 - 6
Baixe a concorrência do seu lado
Chamadas de ferramentas em paralelo e jobs em segundo plano multiplicam a sua parte do aperto de capacidade. Desça o CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY para 2-3, pause outras sessões ou equipes de agentes em execução e evite abrir uma segunda instância do Claude Code no mesmo repo em pleno incidente. Menos pedidos concorrentes também significam fila de retry esvaziando mais rápido quando a capacidade volta.
- 7
Se durar mais que o incidente, fale com o suporte
Se os 529 continuam depois que a página de status limpou, leve o caso para a Anthropic: no app Claude, abra o menu de perfil no canto inferior esquerdo e escolha Get help. O assistente dentro do app aceita um relato de erro direto — cole o código de status e o horário, sem caçar e-mail de suporte.
O menu de perfil com Get help logo abaixo de Settings e Language — a entrada para reportar um 529 teimoso.Assistir em 2:20 - 8
Descreva o 529 ao assistente de suporte
No chat de suporte, informe o código, o modelo e a janela de tempo: "I've received a 529 status code on claude-opus-4-8 since 14:00". O assistente emite um ID de conversa para seus registros — guarde-o caso precise retomar. O suporte consegue dizer se a sua conta pegou um aglomerado persistente raro ou se toda a faixa do modelo estava afundada para todo mundo.
O chat de suporte com "I've received a 529 status code can you help…" digitado e um ID de conversa já atribuído.Assistir em 3:06
Passo 3 — Ajuste o backoff do 529 (Claude Code 2.1.296+)
- 9
Estique o teto de backoff (2.1.296+)
O Claude Code 2.1.296 adicionou CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS — palavras exatas do changelog: "Added CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS environment variable to set a longer maximum delay for the backoff when retrying an overloaded (529) request." Exporte antes de iniciar, por exemplo CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS=30000 para até 30 s entre tentativas. A Anthropic não publicou o valor padrão embutido: qualquer número específico citado por aí, trate como não verificado — o que a variável garante é que séries longas de retries esperam mais tempo em vez de desistir cedo.
- 10
Combine com os outros botões de retry
Duas variáveis vizinhas completam o ajuste: CLAUDE_CODE_MAX_RETRIES (padrão 10) eleva as tentativas por falha transitória, e CLAUDE_CODE_RETRY_WATCHDOG=1 repete 429/529 indefinidamente — a documentação recomenda para sessões não assistidas, onde abortar cedo joga a execução inteira fora. Watchdog mais um atraso máximo generoso transforma uma rajada de 529 em pausa em vez de crash.
Passo 4 — Previna o próximo engarrafamento
- 11
Previna o próximo travamento: fora do pico, tarefas partidas, failover
Três hábitos reduzem a exposição ao 529: rode trabalhos pesados fora do horário de pico dos EUA (aprox. 11:00-20:00 PT em dias úteis), parta prompts monolíticos em tarefas menores — um worktree git por tarefa mantém as sessões independentes — e, se chama a API de Messages direto, programe um failover: capture o 529, troque a quente para um modelo mais leve e repita com backoff exponencial. Para os tetos do plano, veja nosso guia de limites de uso; o 529 em si nunca toca a sua cota.
Um layout de failover de requisições em bruto: o alvo principal é claude-sonnet-4-5, e uma resposta 529 troca a quente para a rota reserva claude-haiku-4-5.Assistir em 2:08
529 vs 429 vs 500: qual erro é qual
Os erros do Claude viajam com números, e o número decide de quem é o problema. A referência oficial os separa com clareza — percorra esta lista antes de começar a apagar arquivos de configuração.
- 1429 rate limit — sua chave, projeto ou plano bateu num limite configurado do seu lado. Confirme a credencial ativa com /status, olhe o console do provedor e baixe o CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY. Estrangulamentos curtos são repetidos automaticamente; um 429 de teto de gastos no gateway não.
- 2529 Overloaded — a API está temporariamente em capacidade máxima para todos os usuários. Server-side por definição: nada no seu código, chave ou config causa isso, e nunca entra na sua cota. Espere, troque de modelo ou estique o backoff.
- 3500 Internal server error — uma falha inesperada dentro da API, normalmente temporária. Espere um minuto e reenvie a mesma mensagem; em um prompt longo, digitar "try again" retoma de onde parou.
- 4"Server is temporarily limiting requests" — um estrangulamento curto sem relação com a cota do seu plano. Espere um pouco e tente de novo; nenhuma mudança de config o levanta mais rápido.
- 5A triagem de 60 segundos: página de status verde + 529 significa esperar; verde + 429 significa conferir seus próprios limites com /status; painel vermelho significa que qualquer erro pode aparecer — siga o incidente em vez de repetir às cegas.
- 6Quando se preocupar de verdade: 529 concentrados por horas em um só modelo com a página de status verde merecem um relato ao suporte com carimbos de tempo (passo 8). Todo o resto é transitório por desenho — a documentação oficial trata os três códigos como "vale a pena repetir", não como problema de conta.
A mesma divisão de trabalho neste site: nosso guia de sessões travadas cuida de congelamentos e travadas, esta página dos erros de capacidade 529/500, e o guia de limites de uso dos tetos tipo 429. Se a sua sessão congelou em vez de dar erro, troque de guia — as soluções não se sobrepõem.