--- title: "Napraw błąd Claude 529 overloaded i błąd 429 rate limit" description: "Błąd 529 overloaded_error oznacza, że API Claude jest przeciążone dla wszystkich. Błąd 429 rate_limit_error oznacza, że Twoja organizacja przekroczyła limit. W obu przypadkach ponawiaj żądania z backoffem." canonical: "https://logbrew.co/pl/guides/claude-overloaded-rate-limit-error" last_updated: "2026-11-10" --- # Napraw błąd Claude 529 overloaded i błąd 429 rate limit Błąd 529 `overloaded_error` oznacza, że API Claude jest przeciążone dla wszystkich. Błąd 429 `rate_limit_error` oznacza, że Twoja organizacja przekroczyła limit. W obu przypadkach ponawiaj żądania z backoffem. Przetestowane 10 listopada 2026 z użyciem Claude Code 2.1.319 i @anthropic-ai/sdk 1.7.0 Autor [Furkan Erday](https://github.com/furkanerday). Furkan Erday jest założycielem LogBrew. Codziennie rozwija LogBrew z pomocą Claude Code i Codex. Canonical: https://logbrew.co/pl/guides/claude-overloaded-rate-limit-error ## Ile każdy klient czekał przed ponowieniem | | Sekundy przed każdym ponowieniem | Ponowienia | Łączny czas | | --- | --- | --- | --- | | Claude Code, każda odpowiedź 529 | 0,6 · 1,1 | 2 | 2,4 s | | Claude Code, każda odpowiedź 429 | 0,5 · 1,2 · 2,5 · 4,1 · 8,8 · 18,8 · 34,2 · 35,4 · 36 · 39,9 | 10 | 182 s | | SDK dla TypeScript z `maxRetries: 5`, każda odpowiedź 529 | 0,4 · 1 · 1,9 · 3,5 · 7,4 | 5 | 14,3 s | ## Napraw to w Claude Code ### Sprawdź stronę statusu Claude Komunikat o braku mocy na status.claude.com oznacza, że problem leży po stronie Anthropic i trzeba po prostu poczekać. ### Poczekaj i spróbuj ponownie `API Error: Repeated 529 Overloaded errors` oznacza, że Claude Code już ponawiał żądania. Błąd 529 nie wlicza się do limitu użycia. ### Przełącz się na inny model Anthropic śledzi dostępną moc osobno dla każdego modelu. Wybierz inny model, na przykład Sonnet, gdy Opus jest przeciążony. ```bash /model ``` ### Ustaw model zapasowy dla skryptów W trybie print `--fallback-model` przełącza na drugi model po powtarzających się błędach 529. W naszym teście przełączył po 3 żądaniach. ```bash claude -p "Run the tests" --fallback-model sonnet ``` ### Nie przerywaj przebiegów bez nadzoru W CI i innych przebiegach, których nikt nie obserwuje, to ustawienie ponawia błędy 529 i 429, aż moc wróci. ```bash export CLAUDE_CODE_RETRY_WATCHDOG=1 ``` ## Napraw to we własnej aplikacji ### Ponawiaj z backoffem Oficjalne SDK Claude domyślnie ponawiają błędy 429, 529 i inne 5xx 2 razy, z wykładniczym backoffem, i respektują nagłówek `retry-after`. Zwiększ `maxRetries`, jeśli aplikacja może czekać dłużej. ```bash import Anthropic from "@anthropic-ai/sdk"; const client = new Anthropic({ maxRetries: 5 }); ``` ### Zapisz błąd i jego identyfikator żądania Gdy ponowienia się skończą, SDK rzuca `OverloadedError` albo `RateLimitError`. Zapisz `error.requestID`, aby pomoc techniczna Anthropic mogła znaleźć żądanie. ```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; } ``` ### Zwiększaj ruch stopniowo Gwałtowny skok ruchu z aplikacji może uruchomić limity przyspieszenia 429. Zwiększaj ruch krok po kroku i utrzymuj go na stałym poziomie. ## Co zobaczyliśmy podczas testu Prawdziwego błędu 529 nie da się wymusić, więc skierowaliśmy Claude Code i SDK dla TypeScript na lokalny serwer testowy, który na każde żądanie odpowiadał 529 albo 429. Claude Code traktuje taki serwer jak bramę, więc sesja z prawdziwym API może działać inaczej. Claude Code wysłał 3 żądania, które dostały odpowiedź 529, i po 2,4 sekundy przerwał z komunikatem `Repeated 529 Overloaded errors`. Z `--fallback-model sonnet` po tych 3 żądaniach przełączył się na Sonnet i ponowił żądanie jeszcze 10 razy w ciągu około 3 minut. Błąd 429 dostał 10 ponowień w ciągu 182 sekund, z przerwami rosnącymi od 0,5 do 40 sekund, zanim pojawiło się `Request rejected (429)`. Z `CLAUDE_CODE_RETRY_WATCHDOG=1` Claude Code nadal ponawiał błąd 529, gdy po 150 sekundach zatrzymaliśmy przebieg. Przy ustawieniach domyślnych SDK wysłało 3 żądania, czyli pierwsze i 2 ponowienia, a po 1,3 sekundy rzuciło `OverloadedError`. Z `maxRetries: 5` wysłało 6 żądań w ciągu 14,3 sekundy. Gdy odpowiedź 429 miała `retry-after: 3`, SDK czekało 3 sekundy przed każdym ponowieniem, a Claude Code czekał 3 sekundy przed każdym z pierwszych 3 ponowień. ## 529 i 429 to różne błędy Błąd 529 `overloaded_error` oznacza, że API jest przeciążone dla wszystkich użytkowników. To nie jest Twój limit i nie wlicza się do Twojego limitu użycia. Błąd 429 `rate_limit_error` dotyczy Twojej organizacji. Przekroczono limit żądań, miesięczny limit wydatków dla poziomu użycia albo limit wydatków w obszarze roboczym Claude Code. Błąd 429 z powodu limitu wydatków nie ma nagłówka `retry-after` i powtarza się, dopóki dostęp nie wróci, więc ponowienia tu nie pomagają. ## Limity planu w Claude Code to nie błędy API `You've hit your session limit` i `You've hit your weekly limit` pochodzą z Twojego planu Claude. Limit sesji to przesuwane okno, które wszyscy nazywają limitem 5-godzinnym. Uruchom `/usage`, aby zobaczyć oba limity i czas ich odnowienia. `Server is temporarily limiting requests (not your usage limit)` to krótkie dławienie po stronie serwera, a Claude Code sam ponawia żądania. `Request rejected (429)` oznacza, że klucz API, projekt Amazon Bedrock albo projekt Google Cloud przekroczył własny limit żądań. Zmienna `ANTHROPIC_API_KEY` w powłoce ma pierwszeństwo przed planem, więc Claude Code może trafić na niższy limit klucza. Uruchom `/status`, aby zobaczyć, które logowanie jest aktywne. Zgłoszenie #16157, które ma 1499 komentarzy, opisuje użytkowników planu Max, którzy niemal od razu trafiają na limit. W styczniu 2026 inżynier Anthropic napisał, że zespół nie ma jeszcze dobrego wyjaśnienia. #29579 opisuje `Rate limit reached` przy użyciu 16%, a #6457 opisuje limit 5-godzinny wyczerpany w mniej niż 90 minut. Wszystkie 3 zgłoszenia są nadal otwarte. ## Najczęściej zadawane pytania ### Czy błąd 529 wlicza się do limitu użycia Claude? Nie. Dokumentacja Claude Code mówi, że błąd 529 nie jest Twoim limitem użycia i nie wlicza się do limitu. ### Jak długo trwa błąd Claude overloaded? Według Anthropic zwykle jest chwilowy. Sprawdź na status.claude.com, czy trwa incydent i jakie są aktualizacje. ### Dlaczego Claude Code pokazuje rate limit reached? Skończył się limit planu, serwer na chwilę ograniczył żądania albo klucz API przekroczył swój limit żądań. `/usage` i `/status` pokazują, która to przyczyna. ### Kiedy resetuje się limit Claude Code? Komunikat podaje godzinę, na przykład `resets 3:45pm`. Pokazuje ją też `/usage`. ### Czy aplikacja powinna ponawiać żądanie po błędzie 529? Tak, z wykładniczym backoffem. Oficjalne SDK domyślnie ponawiają 2 razy, a w naszym teście SDK dla TypeScript czekało dokładnie tyle, ile wskazywał `retry-after`. ## Zobacz każdy błąd API Claude w swojej aplikacji Jeśli Twoja aplikacja wywołuje API Claude, LogBrew grupuje powtarzające się błędy 529 i 429 w 1 problem i pokazuje, jak często występuje każdy z nich. Zacznij od hojnego darmowego planu, bez karty. [Zacznij za darmo](https://logbrew.co/pl) ## Źródła - [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) ## Więcej poradników o agentach AI do kodowania - [Dodaj serwer MCP do Claude Code i Codex](https://logbrew.co/pl/guides/mcp-server-claude-code-codex) - [Jak używać AGENTS.md w Claude Code i Codex](https://logbrew.co/pl/guides/agents-md) - [Jak naprawić błędy w Claude Code, Codex i JavaScript w przeglądarce](https://logbrew.co/pl/guides)