---
title: "Claude-Fehler 529 overloaded und 429 Rate Limit beheben"
description: "Ein 529 overloaded_error heißt, dass die Claude API für alle ausgelastet ist. Ein 429 rate_limit_error heißt, dass deine Organisation ein Limit erreicht hat. Wiederhole beide mit Backoff."
canonical: "https://logbrew.co/de/guides/claude-overloaded-rate-limit-error"
last_updated: "2026-11-10"
---

# Claude-Fehler 529 overloaded und 429 Rate Limit beheben

Ein 529 `overloaded_error` heißt, dass die Claude API für alle ausgelastet ist. Ein 429 `rate_limit_error` heißt, dass deine Organisation ein Limit erreicht hat. Wiederhole beide mit Backoff.

Getestet am 10. November 2026 mit Claude Code 2.1.319 und @anthropic-ai/sdk 1.7.0

Von [Furkan Erday](https://github.com/furkanerday). Furkan Erday hat LogBrew gegründet. Er entwickelt LogBrew jeden Tag mit Claude Code und Codex.

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

## Wartezeit jedes Clients vor einer Wiederholung

|  | Sekunden vor jeder Wiederholung | Wiederholungen | Gesamtzeit |
| --- | --- | --- | --- |
| Claude Code, jede Antwort 529 | 0,6 · 1,1 | 2 | 2,4 s |
| Claude Code, jede Antwort 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 s |
| TypeScript-SDK mit `maxRetries: 5`, jede Antwort 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s |

## In Claude Code beheben

### Claude-Statusseite prüfen

Steht auf status.claude.com ein Hinweis zur Kapazität, liegt das Problem bei Anthropic, und nur Warten hilft.

### Warten und erneut versuchen

`API Error: Repeated 529 Overloaded errors` heißt, dass Claude Code es schon mehrmals versucht hat. Ein 529 zählt nicht gegen dein Nutzungslimit.

### Zu einem anderen Modell wechseln

Anthropic verwaltet die Kapazität pro Modell. Wähle ein anderes Modell, zum Beispiel Sonnet, wenn Opus ausgelastet ist.

```bash
/model
```

### Fallback-Modell für Skripte setzen

Im Print-Modus wechselt `--fallback-model` nach wiederholten 529-Fehlern zu einem zweiten Modell. In unserem Test wechselte es nach 3 Anfragen.

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

### Unbeaufsichtigte Läufe am Laufen halten

In CI und anderen Läufen, die niemand beobachtet, wiederholt diese Einstellung 529- und 429-Fehler, bis wieder Kapazität da ist.

```bash
export CLAUDE_CODE_RETRY_WATCHDOG=1
```

## In deiner eigenen App beheben

### Mit Backoff wiederholen

Die offiziellen Claude-SDKs wiederholen 429, 529 und andere 5xx-Fehler standardmäßig 2-mal mit exponentiellem Backoff und beachten den Header `retry-after`. Erhöhe `maxRetries`, wenn deine App länger warten kann.

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

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

### Fehler und Anfrage-ID loggen

Wenn alle Versuche aufgebraucht sind, wirft das SDK `OverloadedError` oder `RateLimitError`. Speichere `error.requestID`, damit der Anthropic-Support die Anfrage findet.

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

### Traffic langsam steigern

Ein plötzlicher Sprung in deinem eigenen Traffic kann 429-Limits für zu schnellen Anstieg auslösen. Steigere den Traffic schrittweise und halte ihn gleichmäßig.

## Was wir beim Testen gesehen haben

Einen echten 529 kann niemand erzwingen. Deshalb haben wir Claude Code und das TypeScript-SDK auf einen lokalen Testserver gerichtet, der jede Anfrage mit 529 oder 429 beantwortet hat. Claude Code behandelt so einen Server als Gateway, eine Sitzung mit der echten API kann sich also anders verhalten.

Claude Code schickte 3 Anfragen, die einen 529 bekamen, und hörte nach 2,4 Sekunden mit `Repeated 529 Overloaded errors` auf. Mit `--fallback-model sonnet` wechselte es nach diesen 3 Anfragen zu Sonnet und versuchte es in etwa 3 Minuten noch 10-mal. Bei einem 429 gab es in 182 Sekunden 10 Wiederholungen mit Wartezeiten von 0,5 bis 40 Sekunden, dann kam `Request rejected (429)`. Mit `CLAUDE_CODE_RETRY_WATCHDOG=1` wiederholte Claude Code einen 529 immer noch, als wir den Lauf nach 150 Sekunden stoppten.

Mit Standardeinstellungen schickte das SDK 3 Anfragen, die erste plus 2 Wiederholungen, und warf nach 1,3 Sekunden `OverloadedError`. Mit `maxRetries: 5` schickte es 6 Anfragen in 14,3 Sekunden. Enthielt der 429 `retry-after: 3`, wartete das SDK vor jeder Wiederholung 3 Sekunden, und Claude Code wartete vor jeder seiner ersten 3 Wiederholungen 3 Sekunden.

## 529 und 429 sind verschiedene Fehler

Ein 529 `overloaded_error` heißt, dass die API für alle Nutzer ausgelastet ist. Das ist nicht dein Limit, und er zählt nicht gegen dein Kontingent.

Ein 429 `rate_limit_error` gehört zu deiner Organisation. Du hast ein Rate Limit erreicht, das monatliche Ausgabenlimit deiner Nutzungsstufe oder ein Ausgabenlimit im Claude-Code-Workspace. Ein 429 wegen des Ausgabenlimits hat keinen Header `retry-after` und schlägt weiter fehl, bis der Zugang zurück ist. Wiederholen hilft dort also nicht.

## Claude-Code-Planlimits sind keine API-Fehler

`You've hit your session limit` und `You've hit your weekly limit` kommen von deinem Claude-Plan. Das Sitzungslimit ist das rollierende Zeitfenster, das alle das 5-Stunden-Limit nennen. Führe `/usage` aus, um beide Limits und ihren Reset-Zeitpunkt zu sehen.

`Server is temporarily limiting requests (not your usage limit)` ist eine kurze Drosselung auf dem Server, und Claude Code wiederholt die Anfrage für dich. `Request rejected (429)` heißt, dass ein API-Schlüssel, ein Amazon-Bedrock-Projekt oder ein Google-Cloud-Projekt sein eigenes Rate Limit erreicht hat.

Ein `ANTHROPIC_API_KEY` in deiner Shell hat Vorrang vor deinem Plan, sodass Claude Code an das niedrigere Limit des Schlüssels stoßen kann. Führe `/status` aus, um zu sehen, welche Anmeldung aktiv ist.

#16157 mit 1.499 Kommentaren berichtet von Max-Nutzern, die das Limit fast sofort erreichen. Im Januar 2026 schrieb ein Anthropic-Engineer, das Team habe noch keine gute Erklärung. #29579 meldet `Rate limit reached` bei 16 % Nutzung, und #6457 meldet das 5-Stunden-Limit nach weniger als 90 Minuten. Alle 3 Issues sind noch offen.

## Häufige Fragen

### Zählt ein 529-Fehler gegen mein Claude-Nutzungslimit?

Nein. Laut der Claude-Code-Doku ist ein 529 nicht dein Nutzungslimit und zählt nicht gegen dein Kontingent.

### Wie lange dauert der Claude-Overloaded-Fehler?

Laut Anthropic ist er meist vorübergehend. Auf status.claude.com siehst du, ob es einen offenen Vorfall gibt und was der neueste Stand ist.

### Warum meldet Claude Code rate limit reached?

Dein Planlimit ist aufgebraucht, der Server hat Anfragen kurz gedrosselt, oder ein API-Schlüssel hat sein Rate Limit erreicht. `/usage` und `/status` zeigen, was davon zutrifft.

### Wann wird das Claude-Code-Limit zurückgesetzt?

Die Meldung nennt die Uhrzeit, zum Beispiel `resets 3:45pm`. `/usage` zeigt sie ebenfalls.

### Soll meine App einen 529-Fehler wiederholen?

Ja, mit exponentiellem Backoff. Die offiziellen SDKs wiederholen standardmäßig 2-mal, und in unserem Test wartete das TypeScript-SDK genau so lange, wie `retry-after` vorgab.

## Sieh jeden Claude-API-Fehler in deiner App

Wenn deine App die Claude API aufruft, fasst LogBrew wiederholte 529- und 429-Fehler zu 1 Issue zusammen und zeigt, wie oft jeder auftritt. Starte mit dem großzügigen kostenlosen Plan, ohne Kreditkarte.

[Kostenlos starten](https://logbrew.co/de)

## Quellen

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

## Weitere Anleitungen für KI-Coding-Agenten

- [MCP-Server in Claude Code und Codex hinzufügen](https://logbrew.co/de/guides/mcp-server-claude-code-codex)
- [AGENTS.md in Claude Code und Codex nutzen](https://logbrew.co/de/guides/agents-md)
- [Fehler beheben in Claude Code, Codex und Browser-JavaScript](https://logbrew.co/de/guides)