---
title: "Corriger l’erreur Claude overloaded 529 et l’erreur rate limit 429"
description: "Une erreur 529 overloaded_error signifie que l’API Claude est surchargée pour tout le monde. Une erreur 429 rate_limit_error signifie que votre organisation a atteint une limite. Dans les deux cas, réessayez avec un backoff."
canonical: "https://logbrew.co/fr/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Corriger l’erreur Claude overloaded 529 et l’erreur rate limit 429

Une erreur 529 `overloaded_error` signifie que l’API Claude est surchargée pour tout le monde. Une erreur 429 `rate_limit_error` signifie que votre organisation a atteint une limite. Dans les deux cas, réessayez avec un backoff.

Testé le 10 novembre 2026 avec Claude Code 2.1.319 et @anthropic-ai/sdk 1.7.0

Par [Furkan Erday](https://github.com/furkanerday). Furkan Erday est le fondateur de LogBrew. Il développe LogBrew avec Claude Code et Codex tous les jours.

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

## Attente de chaque client avant de réessayer

|  | Secondes avant chaque tentative | Nouvelles tentatives | Durée totale |
| --- | --- | --- | --- |
| Claude Code, toutes les réponses en 529 | 0,6 · 1,1 | 2 | 2,4 s |
| Claude Code, toutes les réponses en 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 avec `maxRetries: 5`, toutes les réponses en 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s |

## Corriger dans Claude Code

### Consulter la page de statut de Claude

Un avis de capacité sur status.claude.com signifie que le problème vient d’Anthropic, et seul le temps le règle.

### Attendre et réessayer

`API Error: Repeated 529 Overloaded errors` signifie que Claude Code a déjà réessayé. Une erreur 529 ne compte pas dans votre limite d’utilisation.

### Passer à un autre modèle

Anthropic suit la capacité modèle par modèle. Choisissez un autre modèle, par exemple Sonnet quand Opus est surchargé.

```bash
/model
```

### Définir un modèle de secours pour les scripts

En mode print, `--fallback-model` bascule vers un second modèle après des erreurs 529 répétées. Dans notre test, il a basculé après 3 requêtes.

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

### Garder les exécutions sans surveillance en marche

En CI et dans les autres exécutions que personne ne surveille, ce paramètre relance les requêtes en erreur 529 et 429 jusqu’au retour de la capacité.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## Corriger dans votre propre app

### Réessayer avec un backoff

Les SDK officiels de Claude réessaient les erreurs 429, 529 et autres 5xx 2 fois par défaut, avec un backoff exponentiel, et respectent l’en-tête `retry-after`. Augmentez `maxRetries` si votre app peut attendre plus longtemps.

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

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

### Logger l’erreur et son ID de requête

Quand les nouvelles tentatives sont épuisées, le SDK lève `OverloadedError` ou `RateLimitError`. Enregistrez `error.requestID` pour que le support d’Anthropic retrouve la requête.

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

### Augmenter le trafic progressivement

Un pic brutal de votre propre trafic peut déclencher les limites d’accélération 429. Augmentez le trafic par paliers et gardez-le stable.

## Ce que nous avons constaté en testant

Personne ne peut forcer une vraie erreur 529, nous avons donc pointé Claude Code et le SDK TypeScript vers un serveur de test local qui répondait à chaque requête par 529 ou 429. Claude Code traite un tel serveur comme une passerelle, une session sur la vraie API peut donc se comporter autrement.

Claude Code a envoyé 3 requêtes en 529, puis s’est arrêté au bout de 2,4 secondes avec `Repeated 529 Overloaded errors`. Avec `--fallback-model sonnet`, il est passé à Sonnet après ces 3 requêtes et a réessayé 10 fois de plus sur environ 3 minutes. Une erreur 429 a eu droit à 10 nouvelles tentatives sur 182 secondes, avec des attentes passées de 0,5 à 40 secondes, avant `Request rejected (429)`. Avec `CLAUDE_CODE_RETRY_WATCHDOG=1`, Claude Code réessayait encore une 529 quand nous avons arrêté l’exécution au bout de 150 secondes.

Avec la configuration par défaut, le SDK a envoyé 3 requêtes, la première plus 2 nouvelles tentatives, et a levé `OverloadedError` au bout de 1,3 seconde. Avec `maxRetries: 5`, il a envoyé 6 requêtes en 14,3 secondes. Quand la 429 portait `retry-after: 3`, le SDK a attendu 3 secondes avant chaque nouvelle tentative, et Claude Code a attendu 3 secondes avant chacune de ses 3 premières nouvelles tentatives.

## 529 et 429 sont des erreurs différentes

Une erreur 529 `overloaded_error` signifie que l’API est surchargée pour tous les utilisateurs. Ce n’est pas votre limite, et elle ne compte pas dans votre quota.

Une erreur 429 `rate_limit_error` concerne votre organisation. Vous avez atteint une rate limit, le plafond de dépenses mensuel de votre niveau d’utilisation ou une limite de dépenses sur l’espace de travail Claude Code. Une 429 due au plafond de dépenses n’a pas d’en-tête `retry-after` et échoue jusqu’au retour de l’accès, réessayer ne sert donc à rien dans ce cas.

## Les limites du forfait Claude Code ne sont pas des erreurs d’API

`You've hit your session limit` et `You've hit your weekly limit` viennent de votre forfait Claude. La limite de session est la fenêtre glissante que l’on appelle la limite de 5 heures. Lancez `/usage` pour voir les deux limites et leur heure de réinitialisation.

`Server is temporarily limiting requests (not your usage limit)` est un bridage court côté serveur, et Claude Code relance la requête à votre place. `Request rejected (429)` signifie qu’une clé API, un projet Amazon Bedrock ou un projet Google Cloud a atteint sa propre rate limit.

Une `ANTHROPIC_API_KEY` dans votre shell passe avant votre forfait, donc Claude Code peut atteindre la limite plus basse de la clé. Lancez `/status` pour voir quelle connexion est active.

Le ticket #16157, avec 1 499 commentaires, rapporte des utilisateurs Max qui atteignent la limite presque tout de suite. En janvier 2026, un ingénieur d’Anthropic a écrit que l’équipe n’avait pas encore de bonne explication. #29579 signale `Rate limit reached` à 16 % d’utilisation, et #6457 la limite de 5 heures atteinte en moins de 90 minutes. Les 3 tickets sont toujours ouverts.

## Questions fréquentes

### Une erreur 529 compte-t-elle dans ma limite d’utilisation Claude ?

Non. La documentation de Claude Code indique qu’une erreur 529 n’est pas votre limite d’utilisation et ne compte pas dans votre quota.

### Combien de temps dure l’erreur overloaded de Claude ?

Selon Anthropic, elle est en général temporaire. Consultez status.claude.com pour voir s’il y a un incident en cours et ses mises à jour.

### Pourquoi Claude Code affiche-t-il rate limit reached ?

La limite de votre forfait est épuisée, le serveur a bridé les requêtes un court moment, ou une clé API a atteint sa rate limit. `/usage` et `/status` indiquent de quel cas il s’agit.

### Quand la limite de Claude Code se réinitialise-t-elle ?

Le message indique l’heure, par exemple `resets 3:45pm`. `/usage` l’affiche aussi.

### Mon app doit-elle réessayer une erreur 529 ?

Oui, avec un backoff exponentiel. Les SDK officiels réessaient 2 fois par défaut, et dans notre test le SDK TypeScript a attendu exactement le délai demandé par `retry-after`.

## Voyez chaque erreur de l’API Claude dans votre app

Si votre app appelle l’API Claude, LogBrew regroupe les erreurs 529 et 429 répétées en 1 problème et montre la fréquence de chacune. Commencez avec le forfait Free généreux, sans carte bancaire.

[Commencer gratuitement](https://logbrew.co/fr)

## Sources

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

## Autres guides pour les agents de code IA

- [Ajouter un serveur MCP à Claude Code et Codex](https://logbrew.co/fr/guides/mcp-server-claude-code-codex)
- [Utiliser AGENTS.md dans Claude Code et Codex](https://logbrew.co/fr/guides/agents-md)
- [Corriger les erreurs dans Claude Code, Codex et le JavaScript du navigateur](https://logbrew.co/fr/guides)