---
title: "Corrija o erro 529 overloaded e o erro 429 de rate limit do Claude"
description: "Um 529 overloaded_error significa que a API do Claude está sobrecarregada para todo mundo. Um 429 rate_limit_error significa que a sua organização atingiu um limite. Nos 2 casos, tente de novo com backoff."
canonical: "https://logbrew.co/pt-BR/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Corrija o erro 529 overloaded e o erro 429 de rate limit do Claude

Um 529 `overloaded_error` significa que a API do Claude está sobrecarregada para todo mundo. Um 429 `rate_limit_error` significa que a sua organização atingiu um limite. Nos 2 casos, tente de novo com backoff.

Testado em 10 de novembro de 2026 com Claude Code 2.1.319 e @anthropic-ai/sdk 1.7.0

Por [Furkan Erday](https://github.com/furkanerday). Furkan Erday é o fundador do LogBrew. Ele desenvolve o LogBrew com Claude Code e Codex todos os dias.

Canonical: https://logbrew.co/pt-BR/guides/claude-overloaded-rate-limit-error

## Quanto cada cliente esperou antes de tentar de novo

|  | Segundos antes de cada nova tentativa | Novas tentativas | Tempo total |
| --- | --- | --- | --- |
| Claude Code, todas as respostas 529 | 0,6 · 1,1 | 2 | 2,4 s |
| Claude Code, todas as respostas 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 s |
| SDK de TypeScript com `maxRetries: 5`, todas as respostas 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s |

## Corrija no Claude Code

### Veja a página de status do Claude

Um aviso de capacidade em status.claude.com significa que o problema está do lado da Anthropic, e só o tempo resolve.

### Espere e tente de novo

`API Error: Repeated 529 Overloaded errors` significa que o Claude Code já tentou de novo. Um 529 não conta no seu limite de uso.

### Mude para outro modelo

A Anthropic controla a capacidade por modelo. Escolha outro modelo, por exemplo o Sonnet quando o Opus estiver sobrecarregado.

```bash
/model
```

### Defina um modelo reserva para scripts

No modo print, `--fallback-model` muda para um segundo modelo depois de erros 529 repetidos. No nosso teste, a troca veio depois de 3 requisições.

```bash
claude -p "Run the tests" --fallback-model sonnet
```

### Mantenha execuções sem supervisão rodando

No CI e em outras execuções sem ninguém olhando, esta configuração tenta de novo os erros 529 e 429 até a capacidade voltar.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## Corrija no seu próprio app

### Tente de novo com backoff

Os SDKs oficiais do Claude tentam de novo erros 429, 529 e outros 5xx 2 vezes por padrão, com backoff exponencial, e respeitam o cabeçalho `retry-after`. Aumente `maxRetries` quando o seu app puder esperar mais.

```bash
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({ maxRetries: 5 });
```

### Registre o erro e o ID da requisição

Quando as tentativas acabam, o SDK lança `OverloadedError` ou `RateLimitError`. Guarde `error.requestID` para o suporte da Anthropic encontrar a requisição.

```bash
try {
  await client.messages.create(request);
} catch (error) {
  if (
    error instanceof Anthropic.OverloadedError ||
    error instanceof Anthropic.RateLimitError
  ) {
    console.warn("Claude API busy", error.status, error.requestID);
  }
  throw error;
}
```

### Aumente o tráfego aos poucos

Um salto brusco no seu próprio tráfego pode disparar os limites de aceleração do 429. Aumente o tráfego passo a passo e mantenha ele estável.

## O que vimos no teste

Ninguém consegue forçar um 529 real, então apontamos o Claude Code e o SDK de TypeScript para um servidor de teste local que respondia a toda requisição com 529 ou 429. O Claude Code trata um servidor assim como gateway, então uma sessão na API real pode ser diferente.

O Claude Code enviou 3 requisições que receberam 529 e parou depois de 2,4 segundos com `Repeated 529 Overloaded errors`. Com `--fallback-model sonnet`, ele passou para o Sonnet depois dessas 3 requisições e tentou mais 10 vezes ao longo de cerca de 3 minutos. Um 429 recebeu 10 novas tentativas em 182 segundos, com esperas que cresceram de 0,5 para 40 segundos, antes de `Request rejected (429)`. Com `CLAUDE_CODE_RETRY_WATCHDOG=1`, o Claude Code ainda tentava de novo um 529 quando paramos a execução depois de 150 segundos.

Com as configurações padrão, o SDK enviou 3 requisições, a primeira mais 2 novas tentativas, e lançou `OverloadedError` depois de 1,3 segundo. Com `maxRetries: 5`, ele enviou 6 requisições em 14,3 segundos. Quando o 429 trazia `retry-after: 3`, o SDK esperou 3 segundos antes de cada nova tentativa, e o Claude Code esperou 3 segundos antes de cada uma das suas 3 primeiras novas tentativas.

## 529 e 429 são erros diferentes

Um 529 `overloaded_error` significa que a API está sobrecarregada para todos os usuários. Não é o seu limite e não conta na sua cota.

Um 429 `rate_limit_error` é da sua organização. Você atingiu um rate limit, o teto de gasto mensal do seu nível de uso ou um limite de gasto no espaço de trabalho do Claude Code. Um 429 de teto de gasto não tem cabeçalho `retry-after` e continua falhando até o acesso voltar, então tentar de novo não ajuda nesse caso.

## Limites do plano no Claude Code não são erros da API

`You've hit your session limit` e `You've hit your weekly limit` vêm do seu plano do Claude. O limite de sessão é a janela móvel que todo mundo chama de limite de 5 horas. Execute `/usage` para ver os 2 limites e quando eles reiniciam.

`Server is temporarily limiting requests (not your usage limit)` é uma limitação curta no servidor, e o Claude Code tenta de novo por você. `Request rejected (429)` significa que uma chave de API, um projeto do Amazon Bedrock ou um projeto do Google Cloud atingiu o próprio rate limit.

Uma `ANTHROPIC_API_KEY` no seu shell tem prioridade sobre o seu plano, então o Claude Code pode bater no limite menor da chave. Execute `/status` para ver qual login está ativo.

O #16157, com 1.499 comentários, relata usuários do Max que atingem o limite quase na hora. Em janeiro de 2026, um engenheiro da Anthropic escreveu que a equipe ainda não tinha uma boa explicação. O #29579 relata `Rate limit reached` com 16% de uso, e o #6457 relata o limite de 5 horas em menos de 90 minutos. Os 3 relatos continuam abertos.

## Perguntas frequentes

### Um erro 529 conta no meu limite de uso do Claude?

Não. A documentação do Claude Code diz que um 529 não é o seu limite de uso e não conta na sua cota.

### Quanto tempo dura o erro overloaded do Claude?

A Anthropic diz que ele costuma ser temporário. Veja em status.claude.com se há um incidente aberto e as atualizações dele.

### Por que o Claude Code diz que o rate limit foi atingido?

O limite do seu plano acabou, o servidor limitou as requisições por pouco tempo ou uma chave de API atingiu o rate limit dela. `/usage` e `/status` mostram qual é o caso.

### Quando o limite do Claude Code reinicia?

A mensagem informa o horário, por exemplo `resets 3:45pm`. `/usage` também mostra.

### O meu app deve tentar de novo um erro 529?

Sim, com backoff exponencial. Os SDKs oficiais tentam de novo 2 vezes por padrão, e no nosso teste o SDK de TypeScript esperou exatamente o tempo que `retry-after` pediu.

## Veja cada erro da API do Claude no seu app

Se o seu app chama a API do Claude, o LogBrew agrupa os erros 529 e 429 repetidos em 1 problema e mostra com que frequência cada um acontece. Comece no plano gratuito generoso, sem cartão.

[Comece grátis](https://logbrew.co/pt-BR)

## Fontes

- [Claude API docs, Errors](https://platform.claude.com/docs/en/api/errors)
- [Claude API docs, Rate limits](https://platform.claude.com/docs/en/api/rate-limits)
- [Claude Code docs, Error reference](https://code.claude.com/docs/en/errors)
- [anthropics/claude-code#16157](https://github.com/anthropics/claude-code/issues/16157)
- [anthropics/claude-code#29579](https://github.com/anthropics/claude-code/issues/29579)
- [anthropics/claude-code#6457](https://github.com/anthropics/claude-code/issues/6457)

## Mais guias para agentes de programação com IA

- [Adicione um servidor MCP ao Claude Code e ao Codex](https://logbrew.co/pt-BR/guides/mcp-server-claude-code-codex)
- [Use AGENTS.md no Claude Code e no Codex](https://logbrew.co/pt-BR/guides/agents-md)
- [Como corrigir erros no Claude Code, no Codex e no JavaScript do navegador](https://logbrew.co/pt-BR/guides)