Limity użycia Claude: jak ominąć blokadę i błąd 429

Jakie są limity użycia Claude?

Limity użycia Claude opierają się na dwóch odrębnych systemach. Pierwszym krokiem jest ustalenie, który z nich spowodował ograniczenie. Subskrypcja Claude (Pro, Max, Team lub Enterprise) zapewnia kroczący limit użycia, który jest współdzielony między modelami oraz czatem Claude. W takim przypadku wyświetlany jest komunikat typu You've hit your session limit · resets 3:45pm. API Claude mierzy inny parametr: szybkość wysyłania żądań i tokenów, obliczaną na minutę. Ograniczenie to objawia się błędem HTTP 429 typu rate_limit_error wraz z nagłówkiem retry-after, który informuje, ile sekund należy odczekać.

Sposoby rozwiązania tych problemów nie mają ze sobą nic wspólnego. Limit subskrypcji dotyczy całkowitego zużycia w określonym oknie czasowym, dlatego należy poczekać na reset lub dokupić dodatkowe użycie. Limit szybkości API dotyczy aktualnej prędkości przesyłania danych i znika w ciągu kilku sekund po zmniejszeniu intensywności zapytań.

Dopuszczalne limity planów oraz poziomy limitów szybkości często ulegają zmianie. Podawanie konkretnych wartości byłoby ryzykowne, dlatego nie zostały one tutaj zamieszczone. Własne limity można sprawdzić za pomocą poleceń przedstawionych poniżej.

Który limit został przekroczony? Przeczytaj dokładny komunikat

Claude Code wskazuje system w wyświetlanym tekście. Zidentyfikuj swój przypadek przed wprowadzeniem jakichkolwiek zmian.

• You've hit your session limit · resets 3:45pm to limit subskrypcji. Wykorzystano bieżący przydział dla tego okna czasowego.
• You've hit your weekly limit · resets Mon 12:00am to ten sam system w dłuższym oknie czasowym.
• You've hit your Opus limit · resets 3:45pm to limit subskrypcji dotyczący wyłącznie zapytań modelu Opus. Jest to jedyny przypadek, w którym zmiana modelu przynosi korzyść.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. to limit szybkości API (rate limit). Osiągnięto limit skonfigurowany dla klucza API lub projektu w Amazon Bedrock bądź Google Cloud. To, który z nich ma zastosowanie, zależy od sposobu uwierzytelniania klienta, ponieważ klient Bedrock lub Vertex jest rozliczany według limitów projektu w chmurze, a nie organizacji Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) to krótkotrwałe ograniczenie (throttle) niezwiązane z limitem planu. Claude Code automatycznie ponawia próbę z użyciem mechanizmu backoff, zanim wyświetli ten komunikat.

Limity subskrypcji: sesja, tydzień i okno Opus

Plan subskrypcyjny obejmuje kroczący limit wykorzystania. Po jego wyczerpaniu Claude Code blokuje kolejne żądania do czasu resetu wskazanego w komunikacie. Dwie właściwości tego limitu są najczęstszym źródłem nieporozumień.

• Limit jest współdzielony z czatem Claude. Praca w serwisie claude.ai korzysta z tego samego limitu co praca w terminalu, więc intensywne popołudnie na czacie skraca wieczór programowania. Każda platforma, na której użytkownik jest zalogowany przy użyciu tego samego konta, korzysta z tej samej puli, dlatego w systemie Linux wersja beta aplikacji desktopowej oraz Claude Code CLI zużywają jeden wspólny limit, a nie osobny dla każdej z nich.
• Limit jest współdzielony między modelami. Limity sesyjne i tygodniowe nie posiadają budżetu przypisanego do konkretnego modelu, z jednym wyjątkiem: limitu modelu Opus.

W planach Claude for Teams oraz Enterprise obowiązuje limit na użytkownika, który resetuje się w kroczącym oknie pięciogodzinnym oraz tygodniowym. Jest on współdzielony z czatem Claude oraz Cowork, a jego wielkość zależy od poziomu subskrypcji (Standard lub Premium). W przypadku planów Pro i Max wiarygodnymi danymi są czas resetu podany w komunikacie oraz własne paski /usage, a nie wartości skopiowane z wpisów na blogach. Jeśli użytkownik jest w trakcie wyboru planu, porównanie planów Claude wskazuje, jakie ograniczenia nakłada każdy z nich.

Dlaczego przełączenie modelu za pomocą /model nie przywraca dostępu

Jest to najczęstszy błąd, a dokumentacja jasno wskazuje przyczynę: limity sesji i limity tygodniowe są współdzielone między wszystkimi modelami, więc zmiana modelu nie przywraca dostępu. Wybór mniejszego modelu po wyczerpaniu limitu sesji zmienia jedynie to, który model udzieliłby odpowiedzi. Nie zmienia to dostępnego limitu, ponieważ nie jest on przypisany do konkretnego modelu, więc przełączenie nie zwalnia żadnych zasobów.

Wyjątkiem jest limit dla Opus, który jest ograniczeniem przypisanym wyłącznie do tego modelu. Jeśli komunikat wskazuje You've hit your Opus limit, to /model jest właściwym rozwiązaniem. Należy przełączyć się na inny model i kontynuować pracę, ponieważ zablokowane zostały jedynie żądania do modelu Opus.

Traktowanie limitu jako błędu oprogramowania jest drugim najczęstszym błędem. Reinstalacja lub ponowne uwierzytelnienie nie przynoszą żadnych zmian. Dostępny limit zostanie przywrócony po zresetowaniu okna czasowego lub po zakupie dodatkowych kredytów na wykorzystanie.

Co zrobić po osiągnięciu limitu subskrypcji

1. Sprawdź czas resetowania. Okno sesji jest krótkie. Tygodniowego limitu nie warto wyczekiwać przy biurku.
2. Jeśli osiągnięto limit modelu Opus, uruchom /model i wybierz inny model.
3. Uruchom /usage, aby wyświetlić limity planu, wskaźniki zużycia oraz czas ich resetowania. /cost to alias prowadzący do tego samego ekranu.
4. Uruchom /usage-credits, aby kontynuować pracę po osiągnięciu limitu. W planach Pro i Max otwiera to ustawienia płatności. W planach Team i Enterprise otwiera to ustawienia zużycia organizacji lub wysyła prośbę do administratorów, jeśli użytkownik nie posiada uprawnień do zarządzania płatnościami.
5. Jeśli ten sam limit jest osiągany co tydzień, wybrany plan nie odpowiada stylowi pracy i warto rozważyć sposoby na obejście limitów zużycia raz, zamiast mierzyć się z nimi przy każdym resecie.

/usage-credits wymaga aktywnej subskrypcji claude.ai zalogowanej przez /login. Funkcja ta jest niedostępna przy uwierzytelnianiu kluczem API, ponieważ klucz API nie posiada limitów planu, które można rozszerzyć.

Kredyty zużycia mają jeden efekt uboczny, o którym warto wiedzieć. Czas życia pamięci podręcznej promptów (prompt cache) wynosi godzinę w ramach subskrypcji i skraca się do pięciu minut po przejściu na kredyty. W rezultacie więcej tur konwersacji zaczyna się od zera, a zużycie tokenów w Claude Code rośnie przy tym samym zakresie pracy.

Komunikaty przypominające limity użycia, które nimi nie są

Cztery błędy Claude Code są zgłaszane jako limity użycia, choć żadnym z nich nie są.

• Ostrzeżenie o kontekście lub automatycznej kompresji nie jest limitem użycia. /context wyświetla wiersz taki jak Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue., gdy konwersacja przekroczy okno kontekstowe modelu. Starsza historia jest podsumowywana w celu zwolnienia miejsca, a limit planu pozostaje nienaruszony.
• Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again. oznacza, że samo /compact zawiodło, ponieważ pozostało zbyt mało wolnego kontekstu, aby pomieścić podsumowanie, które miałoby zostać wygenerowane.
• Credit balance is too low oznacza, że organizacja w Console wyczerpała przedpłacone środki. Należy dodać środki pod adresem platform.claude.com/settings/billing, gdzie dostępna jest również opcja automatycznego doładowania.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context to sprawdzenie uprawnień, a nie wyczerpany limit. Należy wybrać wariant modelu bez przyrostka [1m] lub ustawić CLAUDE_CODE_DISABLE_1M_CONTEXT=1.

Jeden dodatkowy komunikat pochodzi z API. Błąd 413 request_too_large to limit rozmiaru pojedynczego żądania, a nie limit częstotliwości (rate limit).

Limity szybkości API: co faktycznie zlicza kod 429

Messages API mierzy trzy parametry, oddzielnie dla każdej klasy modelu.

• żądania na minutę (RPM)
• tokeny wejściowe na minutę (ITPM)
• tokeny wyjściowe na minutę (OTPM)

Twoja organizacja posiada również limit wydatków, który jest odrębną kwestią: maksymalnym miesięcznym kosztem korzystania z API. Po osiągnięciu limitu wydatków dla danego poziomu, korzystanie z API zostaje wstrzymane do następnego miesiąca, chyba że wystąpisz o podniesienie limitu. Żadna pętla ponawiania żądań tego nie rozwiąże.

Cztery mechanizmy decydują o tym, kiedy wystąpi błąd 429.

• Limity dotyczą klas modeli. Stosują się oddzielnie do każdego modelu, dzięki czemu można korzystać z różnych modeli jednocześnie, aż do osiągnięcia ich indywidualnych limitów. Niektóre rodziny współdzielą pulę: limit szybkości dla Opus jest sumą dla Claude Opus 4.8, Opus 4.7, Opus 4.6 oraz Opus 4.5, podczas gdy Claude Sonnet 5 posiada własny limit.
• Pojemność odnawia się w sposób ciągły. API wykorzystuje algorytm token bucket, więc pojemność uzupełnia się w sposób ciągły, zamiast resetować się w określonym momencie. Limit 60 żądań na minutę może być egzekwowany jako jedno żądanie na sekundę, więc wysłanie 60 żądań jednocześnie nadal zakończy się błędem.
• W większości modeli do ITPM wliczają się tylko tokeny wejściowe nieobjęte cache'owaniem. input_tokens oraz cache_creation_input_tokens wliczają się do limitu. cache_read_input_tokens w większości modeli Claude nie wlicza się, z udokumentowanym wyjątkiem dla Claude Haiku 3.5. Cache'owanie zapewnia zatem zarówno przestrzeń w limitach szybkości, jak i zniżkę. Po stronie wyjściowej, wysoki max_tokens nie wlicza się do OTPM, ponieważ OTPM zlicza tylko tokeny faktycznie wygenerowane.
• Limity obowiązują na poziomie organizacji. Obszarowi roboczemu (workspace) można nadać niższy limit, a limity ogólnorganizacyjne mają zawsze zastosowanie, nawet jeśli suma limitów obszarów roboczych jest wyższa. Limit, którego nie nadpisano w obszarze roboczym, jest dziedziczony z organizacji, a nie pozostaje nieograniczony.

Poziomy o nazwach Start, Build, Scale oraz Custom określają rzeczywiste wartości, przypisywane automatycznie na podstawie historii użycia i statusu konta. Nowe organizacje mogą zaczynać poniżej standardowych, publikowanych limitów, dlatego pierwszy błąd 429 może pojawić się wcześniej, niż przewiduje tabela. Gwałtowny wzrost użycia uruchamia limity akceleracji, które zwracają 429 nawet wewnątrz limitów danego poziomu, dlatego ruch należy zwiększać stopniowo. Każda opublikowana liczba jest sufitem: udokumentowane limity to maksymalne dozwolone użycie, a nie gwarantowane minima. Aby wnioskować o wyższe wartości, należy użyć opcji "Request rate limit increase" na stronie Limits w Claude Console.

Odczytywanie błędu 429: retry-after, nagłówki i ponawianie w SDK

Każdy błąd API zwraca tę samą strukturę: zagnieżdżony obiekt error zawierający typ i komunikat, oraz pole najwyższego poziomu request_id.

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "<names the rate limit you exceeded>"
  },
  "request_id": "req_011CSHoEeqs5C35K2UUqR7Fy"
}

Pozostałe informacje znajdują się w nagłówkach.

• retry-after to liczba sekund, po których można ponowić żądanie. Wcześniejsze próby zakończą się niepowodzeniem.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining oraz anthropic-ratelimit-requests-reset opisują budżet żądań.
• anthropic-ratelimit-input-tokens-* oraz anthropic-ratelimit-output-tokens-* pełnią tę samą funkcję dla ITPM i OTPM, używając analogicznych przyrostków limitu, pozostałej liczby i czasu resetu.
• anthropic-ratelimit-tokens-* wyświetla wartości dla najbardziej restrykcyjnego limitu obowiązującego w danej chwili.

Nagłówki resetu zawierają znaczniki czasu w formacie RFC 3339. Nagłówki pozostałych tokenów są zaokrąglane do tysięcy, należy je więc traktować jako wskaźnik przybliżony. Tryb fast mode posiada własną pulę oraz nagłówki anthropic-fast-*. Należy je odczytywać z każdego udanego wywołania:

curl -s -D - -o /dev/null https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}' \
  | grep -i 'ratelimit\|retry-after\|request-id'

Każda odpowiedź zawiera również unikalny nagłówek request-id, na przykład req_018EeWyXxfu5pfWkrYcMdjWG. W treści błędów występuje on jako request_id, a w odpowiedziach SDK dla Python i TypeScript jako _request_id. Należy go podawać w kontakcie z działem wsparcia.

Przed zaimplementowaniem pętli ponawiania (backoff) należy sprawdzić, czy jest ona konieczna. Oficjalne SDK automatycznie ponawiają próby w przypadku błędów przejściowych, w tym błędów połączenia, limitów szybkości (rate limits) oraz błędów serwera 5xx, stosując wykładniczy czas oczekiwania (exponential backoff). Domyślnie wykonywane są dwie próby, z uwzględnieniem nagłówka retry-after, jeśli jest obecny. Każdy klient akceptuje opcję maximum-retries, która pozwala zmienić lub wyłączyć to zachowanie.

import anthropic

client = anthropic.Anthropic(max_retries=5)  # the SDK default is 2

try:
    msg = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "hello"}],
    )
except anthropic.RateLimitError as err:
    headers = err.response.headers
    print("still limited after retries; wait", headers.get("retry-after"), "seconds")
    print("request id:", headers.get("request-id"))

Błąd 529 overloaded_error nie wynika z Twojej winy

Kod 429 oznacza zbyt szybkie wysyłanie zapytań. Kod 529 overloaded_error informuje, że API jest tymczasowo przeciążone; sytuacja ta może wystąpić, gdy API obsługuje bardzo duży ruch od wszystkich użytkowników. Przyczyną nie jest ani Twój klucz, ani Twój kod. Ponów próbę, stosując mechanizm exponential backoff, który w przypadku odpowiedzi 5xx jest już zaimplementowany w SDK. Jeśli problem nie ustępuje, sprawdź status.claude.com. Kod 500 api_error oznacza błąd wewnętrzny, który należy ponawiać w ten sam sposób; żaden z tych błędów nie jest limitem szybkości (rate limit).

Odczytywanie własnych limitów zamiast korzystania z tabeli

W ramach subskrypcji najważniejszym ekranem jest /usage. Wyświetla on paski zużycia planu oraz szczegółowe zestawienie wykorzystanych zasobów, a d lub w umożliwia przełączanie między danymi z ostatnich 24 godzin a ostatnich 7 dni. Należy pamiętać o dwóch zastrzeżeniach. Blok Session pokazuje zużycie tokenów API i jest przeznaczony dla użytkowników API, dlatego subskrybenci mogą zignorować widniejącą tam kwotę w dolarach. Liczby pochodzą z lokalnej historii sesji na danym urządzeniu, więc zużycie z innego urządzenia lub z serwisu claude.ai nie jest uwzględniane.

Po stronie API strona Usage w konsoli Claude generuje dwa wykresy: "Rate Limit - Input Tokens" oraz "Rate Limit - Output Tokens". Wykres wejściowy przedstawia godzinne maksimum niebuforowanych tokenów wejściowych na minutę w odniesieniu do aktualnego limitu ITPM, wraz z obok widocznym wskaźnikiem buforowania. Pozwala to monitorować zbliżanie się do limitu, zamiast napotykać go w środowisku produkcyjnym.

Aby odczytać skonfigurowane limity programowo:

curl -s https://api.anthropic.com/v1/organizations/rate_limits \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  -H "anthropic-version: 2023-06-01"

Wymaga to klucza Admin API, a GET /v1/organizations/workspaces/{workspace_id}/rate_limits wykonuje to samo dla każdego obszaru roboczego. Oba narzędzia działają w trybie tylko do odczytu: aby zmienić limit, należy skorzystać z karty Limits w konsoli.

Wykorzystanie less w celu ograniczenia limitów

Oba systemy mierzą to samo w warstwie bazowej, więc poniższe metody działają w obu przypadkach.

• Zużywaj mniej tokenów na turę. Ciągłe sesje utrzymują pamięć podręczną w stanie gotowości, a /clear między niezwiązanymi zadaniami nie generuje kosztów. Zużycie tokenów w Claude Code szczegółowo omawia te mechanizmy.
• Zmniejsz wysiłek. Dostępne poziomy to low, medium, high, xhigh oraz max. Menu /effort oferuje również ultracode, co zwiększa zużycie zamiast je ograniczać. Głębokie wnioskowanie przy mechanicznej zmianie nazw nie przynosi korzyści.
• Ogranicz współbieżność po wystąpieniu błędu 429. Zmniejsz CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY i unikaj wielu równoległych subagentów. Uruchom również /status: błędny ANTHROPIC_API_KEY kieruje żądania przez klucz o niższym priorytecie zamiast przez subskrypcję.
• Przenieś zadania nieinteraktywne do Message Batches API. Umożliwia ono asynchroniczne przetwarzanie dużych wolumenów danych z 50% zniżką na tokeny wejściowe i wyjściowe, w ramach własnych limitów, dzięki czemu zadania nocne nie konkurują z bieżącą sesją.

Najbardziej odczuwalne jest to w zadaniach wymagających wprowadzania dużej ilości danych do kontekstu: jeśli analizujesz akcje i opcje w oparciu o dane rynkowe na żywo, pobieranie tylko wąskiego wycinka potrzebnego do konkretnego pytania kosztuje ułamek tego, co wklejanie całych tabel notowań i łańcuchów. Zadania o charakterze skokowym, inicjowane przez program, a nie przez użytkownika, powinny od początku korzystać z klucza API. Przejście na ten model zmienia sposób rozliczeń oraz sposób naliczania limitów, ponieważ Claude API nie posiada darmowego planu poza niewielkim kredytem przyznawanym przy rejestracji. Twoja pierwsza aplikacja Claude API na VPS omawia obsługę kluczy i ponawianie prób, a długotrwałe działanie agenta jest odporne na zerwanie połączenia, jeśli Claude Code działa na VPS wewnątrz tmux.

FAQ

Dlaczego zmiana modelu nie usuwa limitu użycia Claude?

Limity sesyjne i tygodniowe są współdzielone przez wszystkie modele. Przydział jest przypisany do planu, a nie do konkretnego modelu, więc /model zmienia jedynie model, który udzieli odpowiedzi, a nie pozostałą ilość dostępnego limitu. Wyjątkiem jest You've hit your Opus limit, który dotyczy wyłącznie żądań modelu Opus. W tym przypadku zmiana modelu jest udokumentowanym rozwiązaniem.

Co oznacza błąd 429 rate_limit_error i jak długo należy czekać?

Oznacza on, że konto osiągnęło limit szybkości dla danej klasy modelu: żądań na minutę, wejściowych tokenów na minutę lub wyjściowych tokenów na minutę. Odpowiedź zawiera nagłówek retry-after z liczbą sekund oczekiwania, a wcześniejsze ponowienie próby zakończy się niepowodzeniem. Oficjalne biblioteki SDK automatycznie ponawiają żądania w przypadku limitów szybkości i błędów 5xx przy użyciu mechanizmu exponential backoff (domyślnie dwukrotnie), uwzględniając ten nagłówek. Błąd 429 występujący mimo nieprzekroczenia limitów planu wskazuje na ograniczenie przyspieszenia wynikające z nagłego wzrostu natężenia ruchu.

Jak sprawdzić limity użycia Claude oraz czas ich resetowania?

W Claude Code należy uruchomić /usage, aby wyświetlić paski stanu planu, czasy resetowania oraz szczegółowe zestawienie użycia; /cost jest aliasem, a d lub w przełącza widok między ostatnimi 24 godzinami a ostatnimi 7 dniami. Dane te pochodzą z lokalnej historii sesji, więc nie uwzględniają użycia z innych urządzeń ani z serwisu claude.ai. W przypadku API, konsola prezentuje wykresy limitów szybkości, a GET /v1/organizations/rate_limits zwraca skonfigurowane limity przy użyciu klucza Admin API.

Czy można kontynuować pracę po osiągnięciu limitu planu Claude?

Czasami jest to możliwe. Należy uruchomić /usage-credits, aby dokupić użycie powyżej limitu w planach Pro i Max lub poprosić o nie administratora w planach Team i Enterprise; wymaga to zalogowania do claude.ai przez /login i jest niedostępne przy uwierzytelnianiu kluczem API. W przeciwnym razie należy poczekać na czas resetowania, zmienić model, jeśli przyczyną był limit Opus, lub przenieść pracę na klucz API, który rozlicza użycie na minutę, a nie w oknie czasowym.