---
title: "Risolvi l’errore overloaded 529 e l’errore di rate limit 429 di Claude"
description: "Un 529 overloaded_error significa che l’API di Claude è sovraccarica per tutti. Un 429 rate_limit_error significa che la tua organizzazione ha raggiunto un limite. Riprova in entrambi i casi con il backoff."
canonical: "https://logbrew.co/it/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Risolvi l’errore overloaded 529 e l’errore di rate limit 429 di Claude

Un 529 `overloaded_error` significa che l’API di Claude è sovraccarica per tutti. Un 429 `rate_limit_error` significa che la tua organizzazione ha raggiunto un limite. Riprova in entrambi i casi con il backoff.

Testato il 10 novembre 2026 con Claude Code 2.1.319 e @anthropic-ai/sdk 1.7.0

Di [Furkan Erday](https://github.com/furkanerday). Furkan Erday è il fondatore di LogBrew. Sviluppa LogBrew ogni giorno con Claude Code e Codex.

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

## Quanto ha aspettato ogni client prima di riprovare

|  | Secondi prima di ogni tentativo | Tentativi | Tempo totale |
| --- | --- | --- | --- |
| Claude Code, tutte le risposte 529 | 0,6 · 1,1 | 2 | 2,4 s |
| Claude Code, tutte le risposte 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 s |
| SDK TypeScript con `maxRetries: 5`, tutte le risposte 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s |

## Risolvi in Claude Code

### Controlla la pagina di stato di Claude

Un avviso sulla capacità su status.claude.com significa che il problema è dal lato di Anthropic, e si risolve solo aspettando.

### Aspetta e riprova

`API Error: Repeated 529 Overloaded errors` significa che Claude Code ha già riprovato. Un 529 non conta nel tuo limite di utilizzo.

### Passa a un altro modello

Anthropic gestisce la capacità per modello. Scegli un altro modello, per esempio Sonnet quando Opus è sovraccarico.

```bash
/model
```

### Imposta un modello di riserva per gli script

In modalità print, `--fallback-model` passa a un secondo modello dopo ripetuti errori 529. Nel nostro test è passato dopo 3 richieste.

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

### Fai continuare le esecuzioni non presidiate

In CI e nelle altre esecuzioni senza nessuno a guardare, questa impostazione riprova gli errori 529 e 429 finché la capacità non torna.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## Risolvi nella tua app

### Riprova con il backoff

Gli SDK ufficiali di Claude riprovano gli errori 429, 529 e gli altri 5xx 2 volte di default, con backoff esponenziale, e rispettano l’header `retry-after`. Alza `maxRetries` se la tua app può aspettare di più.

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

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

### Registra l’errore e il suo request ID

Quando i tentativi finiscono, l’SDK lancia `OverloadedError` o `RateLimitError`. Salva `error.requestID` così il supporto di Anthropic può trovare la richiesta.

```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;
}
```

### Aumenta il traffico gradualmente

Un salto brusco nel tuo traffico può far scattare i limiti di accelerazione 429. Aumenta il traffico un passo alla volta e mantienilo costante.

## Cosa abbiamo visto nei test

Nessuno può provocare un vero 529, quindi abbiamo collegato Claude Code e l’SDK TypeScript a un server di test locale che rispondeva a ogni richiesta con 529 o 429. Claude Code tratta un server del genere come un gateway, quindi una sessione sull’API reale può comportarsi diversamente.

Claude Code ha inviato 3 richieste che hanno ricevuto 529, poi si è fermato dopo 2,4 secondi con `Repeated 529 Overloaded errors`. Con `--fallback-model sonnet` è passato a Sonnet dopo quelle 3 richieste e ha riprovato altre 10 volte in circa 3 minuti. Un 429 ha avuto 10 tentativi in 182 secondi, con attese cresciute da 0,5 a 40 secondi, prima di `Request rejected (429)`. Con `CLAUDE_CODE_RETRY_WATCHDOG=1`, Claude Code stava ancora riprovando un 529 quando abbiamo fermato l’esecuzione dopo 150 secondi.

Con le impostazioni di default, l’SDK ha inviato 3 richieste, la prima più 2 tentativi, e ha lanciato `OverloadedError` dopo 1,3 secondi. Con `maxRetries: 5` ha inviato 6 richieste in 14,3 secondi. Quando il 429 conteneva `retry-after: 3`, l’SDK ha aspettato 3 secondi prima di ogni tentativo, e Claude Code ha aspettato 3 secondi prima di ognuno dei suoi primi 3 tentativi.

## 529 e 429 sono errori diversi

Un 529 `overloaded_error` significa che l’API è sovraccarica per tutti gli utenti. Non è un tuo limite e non conta nella tua quota.

Un 429 `rate_limit_error` riguarda la tua organizzazione. Hai raggiunto un rate limit, il tetto di spesa mensile del tuo livello di utilizzo o un limite di spesa sullo spazio di lavoro di Claude Code. Un 429 da tetto di spesa non ha l’header `retry-after` e continua a fallire finché l’accesso non torna, quindi lì i tentativi non servono.

## I limiti del piano di Claude Code non sono errori dell’API

`You've hit your session limit` e `You've hit your weekly limit` vengono dal tuo piano Claude. Il limite di sessione è la finestra mobile che tutti chiamano limite delle 5 ore. Esegui `/usage` per vedere entrambi i limiti e quando si azzerano.

`Server is temporarily limiting requests (not your usage limit)` è un breve rallentamento lato server, e Claude Code riprova da solo. `Request rejected (429)` significa che una chiave API, un progetto Amazon Bedrock o un progetto Google Cloud ha raggiunto il proprio rate limit.

Una `ANTHROPIC_API_KEY` nella shell ha la precedenza sul tuo piano, quindi Claude Code può raggiungere il limite più basso della chiave. Esegui `/status` per vedere quale accesso è attivo.

La #16157, con 1.499 commenti, raccoglie utenti Max che raggiungono il limite quasi subito. A gennaio 2026 un ingegnere di Anthropic ha scritto che il team non aveva ancora una buona spiegazione. La #29579 segnala `Rate limit reached` al 16% di utilizzo, e la #6457 segnala il limite delle 5 ore in meno di 90 minuti. Tutte e 3 le segnalazioni sono ancora aperte.

## Domande frequenti

### Un errore 529 conta nel mio limite di utilizzo di Claude?

No. La documentazione di Claude Code dice che un 529 non è il tuo limite di utilizzo e non conta nella tua quota.

### Quanto dura l’errore overloaded di Claude?

Anthropic dice che di solito è temporaneo. Controlla su status.claude.com se c’è un incidente aperto e i suoi aggiornamenti.

### Perché Claude Code dice rate limit reached?

Il limite del tuo piano è esaurito, il server ha rallentato le richieste per poco tempo, oppure una chiave API ha raggiunto il suo rate limit. `/usage` e `/status` mostrano quale dei tre.

### Quando si azzera il limite di Claude Code?

Il messaggio indica l’orario, per esempio `resets 3:45pm`. Lo mostra anche `/usage`.

### La mia app deve riprovare dopo un errore 529?

Sì, con backoff esponenziale. Gli SDK ufficiali riprovano 2 volte di default, e nel nostro test l’SDK TypeScript ha aspettato esattamente quanto chiedeva `retry-after`.

## Tieni d’occhio ogni errore dell’API di Claude nella tua app

Se la tua app chiama l’API di Claude, LogBrew raggruppa gli errori 529 e 429 ripetuti in 1 problema e mostra quanto spesso si verifica ciascuno. Inizia con il generoso piano gratuito, senza carta.

[Inizia gratis](https://logbrew.co/it)

## Fonti

- [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)

## Altre guide per gli agenti di coding IA

- [Aggiungi un server MCP a Claude Code e Codex](https://logbrew.co/it/guides/mcp-server-claude-code-codex)
- [Usa AGENTS.md in Claude Code e Codex](https://logbrew.co/it/guides/agents-md)
- [Come risolvere gli errori in Claude Code, Codex e nel JavaScript del browser](https://logbrew.co/it/guides)