Claude Code: błąd 429 Too Many Requests - jak naprawić

Claude Code

Claude Code: błąd 429 Too Many Requests - jak naprawić

W skrócie

Błąd 429 w Claude Code oznacza, że w danym oknie czasowym wysłałeś za dużo zapytań lub tokenów. To limit tempa, a nie awaria serwera. Pokazujemy, skąd się bierze i jak go rozbroić.

Jak to wygląda w praktyce

W trakcie pracy Claude Code nagle przerywa odpowiedź i wypisuje API Error: 429 Too Many Requests (rate_limit_error). Zwykle dzieje się to w środku dłuższej sesji, przy szybkim ciągu poleceń albo gdy w tle chodzi kilka zadań naraz.

Charakterystyczne jest to, że po chwili narzędzie samo próbuje ponowić zapytanie i czasem kolejna próba przechodzi bez zmian z Twojej strony. To pierwszy sygnał, że nie chodzi o zepsuty klucz ani błędną konfigurację, tylko o zbyt duże tempo.

Dlaczego tak się dzieje

Kod 429 to klasyczny rate limit. Anthropic pilnuje, ile zapytań na minutę (requests-per-minute) i ile tokenów na minutę (tokens-per-minute) możesz wysłać. Wartości zależą od tieru na API albo od puli Twojego planu Pro czy Max. Gdy w krótkim czasie przekroczysz którykolwiek z tych progów, dostajesz 429.

Tempo szybko rośnie, gdy uruchamiasz zadania równoległe: subagenci, workflow i wiele jednoczesnych narzędzi sumują się do wspólnego limitu. Limit potrafi też dotyczyć całej organizacji, więc kolega korzystający z tego samego konta również zjada Twoją pulę.

Jak to rozwiązać krok po kroku

1. Poczekaj kilkadziesiąt sekund - Claude Code sam ponawia zapytanie z rosnącym opóźnieniem (backoff), więc często wystarczy dać mu chwilę.
2. Ogranicz równoległość: nie odpalaj wielu subagentów ani równoległych workflow naraz, rób zadania po kolei.
3. Odchudź kontekst i uruchom kompakcję albo nową sesję przez /clear, żeby każde zapytanie zużywało mniej tokenów.
4. Przełącz się na lżejszy model przez /model - mniejszy model zużywa mniej tokenów na minutę i rzadziej wpada w limit.
5. Przy rozliczeniu kluczem API sprawdź swój tier limitów oraz limity organizacji w konsoli Anthropic.
6. Jeśli limit blokuje Cię regularnie, rozważ wyższy tier albo wyższy plan, który daje większe okno requests-per-minute i tokens-per-minute.

Jak sprawdzić, że zadziałało

Po odczekaniu i ograniczeniu tempa uruchom pojedyncze, krótkie zapytanie. Jeśli przejdzie bez komunikatu 429, limit się zresetował i możesz wracać do pracy, tym razem bez lawiny równoległych zadań.

Gdy pracujesz na kluczu API, w konsoli Anthropic zajrzyj w statystyki zużycia - spadające wartości requests-per-minute i tokens-per-minute potwierdzą, że jesteś już poniżej progu. Sprawdź też /status, aby upewnić się, skąd Claude Code bierze uwierzytelnienie i jaki limit Cię obowiązuje.

Wróć do listy problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5