Limity użycia Claude: jak ominąć błąd i co oznaczają

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ł blokadę. Subskrypcja Claude (Pro, Max, Team lub Enterprise z licencjami na użytkownika) zapewnia kroczący limit użycia, który jest współdzielony między modelami (z wyłączeniem kilku ograniczeń dla rodzin modeli) oraz z czatem Claude. W takim przypadku wyświetlany jest komunikat typu You've hit your session limit · resets 3:45pm. Wyjątek stanowią bieżące plany Enterprise rozliczane według użycia: nie posiadają one wliczonego limitu, a całe użycie jest rozliczane według stawek API od pierwszego tokena. Claude API mierzy inny parametr: szybkość wysyłania żądań i tokenów, obliczaną na minutę. W przypadku przekroczenia limitu zwracany jest błąd HTTP 429 typu rate_limit_error, zazwyczaj z nagłówkiem retry-after określającym liczbę sekund, po których można ponowić próbę.

Sposoby rozwiązania tych problemów są odmienne. Limit subskrypcji dotyczy całkowitej ilości użycia w danym oknie czasowym, więc należy zaczekać na reset, dokupić dodatkowe użycie lub wykorzystać darmowy reset limitu, jeśli plan go przewiduje. Limit szybkości API dotyczy bieżącej prędkości wysyłania żądań i znika w ciągu kilku sekund po zmniejszeniu intensywności zapytań.

Limity planów oraz poziomy limitów szybkości często ulegają zmianie, a podanie błędnych wartości jest niepożądane, dlatego nie zostały one tutaj zamieszczone. Własne limity można sprawdzić za pomocą poleceń opisanych poniżej.

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

Claude Code podaje nazwę systemu 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. Bieżący przydział dla Twojego planu w tym oknie czasowym został wyczerpany.
• 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 żądań modelu Opus. Przełączenie na model spoza rodziny Opus pozwoli na dalszą pracę.
• You've hit your Sonnet limit · resets 3:45pm to ten sam rodzaj limitu dla rodziny modeli, dotyczący wyłącznie żądań modelu Sonnet. Przełączenie na model spoza rodziny Sonnet pozwoli na dalszą pracę.
• Komunikat rozpoczynający się od Fable limit reached oznacza, że wykorzystano część tygodniowego przydziału przeznaczoną dla modeli Fable. Dalsze korzystanie z nich obciąża kredyty użycia, dlatego Claude Code prosi o wcześniejsze potwierdzenie. Wybierz inny model za pomocą /model, aby pozostać w ramach swojego planu.
• 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. Osiągnięto limit skonfigurowany dla klucza API lub projektu w Amazon Bedrock albo Google Cloud. To, który z nich ma zastosowanie, zależy od sposobu uwierzytelniania klienta, ponieważ klient Bedrock lub Vertex jest rozliczany zgodnie z kwotą 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 kwotą planu. Claude Code automatycznie ponawia próbę z użyciem mechanizmu backoff, zanim wyświetli ten wiersz.

Limity subskrypcji: sesja, tydzień i okno czasowe Opus

Plany Pro, Max, Team oraz plany Enterprise oparte na liczbie stanowisk obejmują kroczący limit wykorzystania. Po jego wyczerpaniu Claude Code blokuje kolejne żądania do czasu resetu wskazanego w komunikacie. Dwie cechy tego limitu są najczęstszym źródłem nieporozumień.

• Limit jest współdzielony z czatem Claude. Praca na claude.ai korzysta z tej samej puli co praca w terminalu, więc intensywne popołudnie na czacie skraca czas dostępny na kodowanie wieczorem. Każda platforma, na której użytkownik jest zalogowany przy użyciu tego samego konta, korzysta z tej samej puli, więc w systemie Linux wersja beta aplikacji desktopowej oraz Claude Code CLI zużywają jeden wspólny limit, a nie osobne limity dla każdego narzędzia.
• Limit jest współdzielony między modelami. Limity sesyjne i tygodniowe stanowią jedną pulę dla wszystkich modeli. Wyjątkiem są limity dla poszczególnych rodzin modeli wewnątrz tej puli: limity dla Opus i Sonnet, a w przypadku planów Max i Premium – przydział Fable wynoszący do 50% limitów tygodniowych. W planach Pro i Standard model Fable nie jest w ogóle objęty limitami planu i jest rozliczany według kredytów zużycia od pierwszego żądania.

W przypadku Claude for Teams oraz planów Enterprise opartych na stanowiskach, obowiązuje limit na stanowisko, 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 stanowiska (Standard lub Premium). Obecne plany Enterprise oparte na zużyciu działają inaczej: nie ma w nich wliczonego limitu, który mógłby się wyczerpać, zużycie jest rozliczane według stawek API, a górny pułap wyznaczają limity wydatków ustawione przez administratorów na poziomie organizacji oraz dla poszczególnych użytkowników. W planach wspieranych przez dział sprzedaży, zużycie wstrzymane przez limit wydatków zostaje wznowione na początku kolejnego okresu rozliczeniowego, chyba że właściciel wcześniej podniesie limit. W planach samoobsługowych zużycie zatrzymuje się również po wyczerpaniu przedpłaconego salda kredytów, aż do momentu zakupu kolejnych przez właściciela. W planach 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 blogu. Jeśli wybór planu nadal trwa, porównanie planów Claude wskazuje, jakie funkcje są ograniczone w poszczególnych wariantach.

Dlaczego zmiana modelu za pomocą /model nie przywraca sesji ani limitu tygodniowego

Jest to najczęstszy błąd, a dokumentacja jasno wskazuje: limity sesji i limity tygodniowe są współdzielone przez wszystkie modele, więc zmiana modelu nie przywraca dostępu. Wybór mniejszego modelu po wyczerpaniu okna sesji zmienia jedynie to, który model udzieli odpowiedzi. Nie zmienia to pozostałego limitu, ponieważ limit sesji i limit tygodniowy nie są przypisane do konkretnego modelu, więc przełączenie nie zwalnia żadnych zasobów.

Wyjątkiem są limity dla rodzin modeli. Jeśli komunikat brzmi You've hit your Opus limit lub You've hit your Sonnet limit, to /model jest właściwym rozwiązaniem. Należy przełączyć się na model spoza tej rodziny i kontynuować pracę, ponieważ zablokowane zostały jedynie zapytania dla tej konkretnej rodziny. Limit Fable dla licencji Max i Premium działa w ten sam sposób: należy przełączyć się na inny model, aby kontynuować pracę w ramach planu, lub korzystać z Fable w ramach kredytów zużycia. Fable szybciej wyczerpuje współdzieloną pulę tygodniową niż inne modele, jednak przełączenie po osiągnięciu limitu Fable nigdy nie pozwala przekroczyć ogólnego limitu tygodniowego.

Traktowanie limitu jako błędu jest drugim najczęstszym błędem. Reinstalacja lub ponowne uwierzytelnienie niczego nie zmienia. Limit odnawia się po zresetowaniu okna czasowego, po wykorzystaniu darmowego resetu limitu lub po zakupie kredytów zużycia.

Co zrobić po osiągnięciu limitu subskrypcji

1. Sprawdź czas resetu. Okno sesji jest krótkie. Okno tygodniowe nie jest czymś, na co czeka się przy biurku. W wersji Claude Code v2.1.234 lub nowszej, /rate-limit-options może poczekać na reset i automatycznie kontynuować przerwane zadanie.
2. Jeśli osiągnięto limit dla modeli Opus, Sonnet lub Fable, uruchom /model i wybierz model spoza tej rodziny.
3. Uruchom /usage, aby wyświetlić limity swojego planu, paski zużycia oraz czas ich resetu. /cost to alias prowadzący do tego samego ekranu.
4. Sprawdź sekcję Resets w Settings > Usage na stronie claude.ai lub w aplikacji Claude Desktop. Uprawnione plany okazjonalnie otrzymują ofertę darmowego resetu limitu. Kliknięcie "Reset for free" natychmiast przywraca pełny limit pięciogodzinnej sesji lub limit tygodniowy, w zależności od tego, co obejmuje oferta. Przycisk ten nie jest dostępny w Claude Code w terminalu lub IDE, ani w aplikacji Claude Mobile, a każda oferta wygasa.
5. Uruchom /usage-credits, aby kontynuować pracę po osiągnięciu limitu. W planach Pro i Max otwiera to ustawienia rozliczeń. 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 rozliczeń.
6. Jeśli ten sam limit jest osiągany co tydzień, wybrany plan nie jest odpowiedni dla przyjętego trybu pracy, a sposoby na obejście limitu zużycia warto rozważyć jednorazowo, zamiast przy każdym resecie.

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

Kredyty zużycia mają jeden efekt uboczny, o którym warto wiedzieć wcześniej. Domyślnie Claude Code zapewnia głównej konwersacji godzinny prompt cache, gdy mieścisz się w limicie subskrypcji, i skraca go do pięciu minut po rozpoczęciu korzystania z kredytów. W rezultacie więcej tur konwersacji zaczyna się od zera, a zużycie tokenów przez Claude Code rośnie przy tym samym nakładzie pracy. Podagenci znajdują się poza pulą głównej konwersacji, więc otrzymują pięć minut nawet w ramach limitu planu. Samodzielne wybranie wartości TTL za pomocą ustawienia promptCacheTtl lub CLAUDE_CODE_PROMPT_CACHE_TTL w wersji Claude Code v2.1.242 lub nowszej pozwala zachować godzinny czas życia cache'u podczas korzystania z kredytów.

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, a po nim polecenie zwalniające miejsce, gdy konwersacja przekroczy okno kontekstowe modelu. Kompresja podsumowuje starszą historię w celu zwolnienia miejsca, ale nie jest darmowa: /compact odczytuje konwersację, którą podsumowuje, więc kompresja dużego kontekstu sama w sobie stanowi duże żądanie w ramach planu. Jeśli zamiast ciągłości wymagany jest nowy początek, /clear nie generuje kosztów.
• Prompt is too long · automatic compaction failed: <the underlying error> oznacza, że sama automatyczna kompresja zakończyła się niepowodzeniem z powodu błędu, który wskazuje. /compact będzie nadal kończyć się niepowodzeniem z tym samym błędem, dopóki nie zostanie on rozwiązany.
• Credit balance is too low oznacza, że organizacja w Console wyczerpała przedpłacone środki lub Claude Code wysyła żądania subskrybenta za pomocą klucza API Console; /status pokazuje, które poświadczenie jest aktywne. Środki można dodać na stronie platform.claude.com/settings/billing, która oferuje również automatyczne doładowanie.
• API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context to sprawdzenie uprawnień, a nie wyczerpany limit. Jeśli wybrano wariant [1m] modelu Opus 4.6 lub Sonnet 4.6, należy wybrać wariant bez przyrostka [1m] lub ustawić CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Jeśli komunikat pojawia się w trakcie konwersacji, ponieważ kontekst przekroczył 200K tokenów, Claude Code samodzielnie skompresuje go poniżej standardowego limitu. Modele Sonnet 5 i nowsze, Opus 4.7 i nowsze, Haiku 5.5 oraz modele Fable działają z natywnym oknem 1M i nie posiadają przyrostka do usunięcia; wspomniana zmienna ogranicza je do 200K.

Jeszcze jeden błąd pochodzi z API. Kod 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)

Organizacja posiada również limit wydatków, który jest odrębnym mechanizmem: 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 zostanie złożony wniosek o wyższy limit. Taka sytuacja również skutkuje kodem 429 rate_limit_error, jednak bez nagłówka retry-after oraz z wartością enforced_spend_limit_reached w error.details.error_code. Żadna pętla ponawiania nie rozwiąże tego problemu. Niższy limit wydatków ustawiony samodzielnie w Console jest sygnalizowany inaczej: żądania zwracają kod HTTP 400 invalid_request_error z komunikatem zaczynającym się od You have reached your specified API usage limits, a zwiększenie lub usunięcie limitu przywraca dostęp.

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

• Limity dotyczą klasy modelu. Stosują się oddzielnie do każdego modelu, co pozwala na jednoczesne korzystanie z różnych modeli w ramach 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ć 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ę niepowodzeniem.
• Większość modeli wlicza do ITPM tylko dane wejściowe bez cache'owania. input_tokens oraz cache_creation_input_tokens są wliczane. cache_read_input_tokens w większości modeli Claude nie jest wliczane, z udokumentowanym wyjątkiem dla Claude Haiku 3.5. Cache'owanie zapewnia zatem zarówno zapas w limicie szybkości, jak i zniżkę. Po stronie wyjściowej wysoki parametr max_tokens nie obciąża OTPM, ponieważ OTPM zlicza tylko tokeny faktycznie wygenerowane.
• Limity obowiązują na poziomie organizacji. Obszar roboczy może otrzymać niższy limit, a limity ogólnorganizacyjne mają zastosowanie zawsze, nawet jeśli suma limitów obszarów roboczych jest wyższa. Limit, który nie został nadpisany 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 oraz te z niewielką historią użycia mogą rozpocząć pracę na poziomie Evaluation, poniżej standardowych opublikowanych limitów, dlatego pierwszy błąd 429 może wystąpić wcześniej, niż przewiduje tabela. Gwałtowny wzrost użycia uruchamia limity akceleracji, które zwracają 429 nawet wewnątrz posiadanego poziomu, dlatego należy zwiększać natężenie ruchu stopniowo. Każda opublikowana wartość jest sufitem: udokumentowane limity to maksymalne dozwolone użycie, a nie gwarantowane minima. Aby wnioskować o wyższe limity, należy użyć opcji "Request tier increase" na stronie Rate 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. Nie każdy błąd 429 zawiera ten nagłówek; błąd 429 wynikający z osiągnięcia limitu wydatków (spend-cap) nigdy go nie zawiera.
• 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ą analogiczną funkcję dla ITPM i OTPM, używając tych samych przyrostków limitu, pozostałej liczby (remaining) oraz czasu resetu (reset).
• anthropic-ratelimit-tokens-* wyświetla wartości dla najbardziej restrykcyjnego limitu obowiązującego w danym momencie.

Nagłówki resetu zawierają znaczniki czasu w formacie RFC 3339. Nagłówki pozostałych tokenów są zaokrąglane do tysiąca, należy więc traktować je jako wskaźnik orientacyjny. Tryb szybki (fast mode) posiada własną pulę oraz nagłówki anthropic-fast-*. Należy odczytywać je przy każdym udanym wywołaniu:

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ć podczas kontaktu z działem wsparcia.

Przed zaimplementowaniem pętli ponawiania (backoff loop) należy zweryfikować, czy jest ona faktycznie potrzebna. Oficjalne SDK automatycznie ponawiają żądania w przypadku błędów przejściowych, w tym błędów połączenia, limitów szybkości 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ę maksymalnej liczby ponowień, co pozwala na zmianę lub wyłączenie tego zachowania.

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 ekranem, który ma znaczenie, jest /usage. Wyświetla on paski zużycia planu oraz zestawienie elementów, które je wygenerowały, a d lub w pozwala przełączać się 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, więc 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 claude.ai nie jest uwzględnione.

W przypadku API strona Usage w konsoli Claude generuje dwa wykresy: "Rate Limit - Input Tokens" oraz "Rate Limit - Output Tokens". Wykres wejściowy przedstawia godzinowe maksimum tokenów wejściowych bez cache'owania na minutę w odniesieniu do bieżącego limitu ITPM, wraz z wskaźnikiem cache'owania. 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 poświadczeń Admin API: klucza Admin API, tokena OAuth z zakresem org:admin lub klucza konta osobistego bądź serwisowego, który nie jest ograniczony do obszaru roboczego (workspace). Klucze API obszaru roboczego nie działają. GET /v1/organizations/workspaces/{workspace_id}/rate_limits wykonuje to samo dla każdego obszaru roboczego. Oba narzędzia działają tylko w trybie odczytu: aby zmienić limit, należy użyć strony Rate limits w konsoli.

Używanie less, aby napotykać mniej limitów

Oba systemy mierzą to samo w warstwie bazowej, więc te mechanizmy 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 niepowiązanymi zadaniami nie generuje żadnych kosztów. Zużycie tokenów w Claude Code szczegółowo omawia te dźwignie.
• 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 rozumowanie przy mechanicznej zmianie nazwy nie przynosi korzyści.
• Ogranicz współbieżność po błędzie 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 niższego poziomu zamiast przez subskrypcję.
• Przenieś pracę nieinteraktywną do Message Batches API. Uruchamia ona duże wolumeny asynchronicznie z 50% zniżką na tokeny wejściowe i wyjściowe, w ramach własnych limitów szybkości, dzięki czemu zadanie nocne nie konkuruje z bieżącą sesją.

Praca polegająca na wprowadzaniu dużej ilości danych do kontekstu odczuwa to najbardziej: 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. Praca o charakterze skokowym, sterowana przez program, a nie przez użytkownika, powinna od początku korzystać z klucza API. Przeniesienie tam zmienia sposób płatności oraz sposób naliczania limitów, ponieważ Claude API nie posiada darmowego planu. Plany Max i Team obejmują miesięczne kredyty API na uruchamianie własnych aplikacji i agentów po powiązaniu organizacji w Console. Kredyty te nie obejmują Claude Code i nie zmieniają limitów użycia Twojego planu. Twoja pierwsza aplikacja Claude API na VPS omawia obsługę kluczy i ponawianie prób, a długotrwałe działanie agenta przetrwa zerwanie połączenia, jeśli utrzymasz Claude Code działający na VPS wewnątrz tmux.

FAQ

Dlaczego zmiana modelu nie rozwiązuje problemu limitu użycia Claude?

Ponieważ limity sesyjne i tygodniowe są współdzielone między wszystkimi modelami. Ten przydział przypisany jest do planu, a nie do konkretnego modelu, więc /model zmienia jedynie model, który udzieli odpowiedzi, a nie ilość pozostałego limitu. Wyjątkiem są limity dla rodzin modeli: You've hit your Opus limit oraz You've hit your Sonnet limit dotyczą wyłącznie danej rodziny, a limit Fable w planach Max i Premium ogranicza tylko ten model. W takim 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: liczby zapytań na minutę, liczby tokenów wejściowych na minutę lub liczby tokenów wyjściowych na minutę. Odpowiedź zazwyczaj zawiera nagłówek retry-after z liczbą sekund oczekiwania, a wcześniejsze ponowne próby zakończą się niepowodzeniem. Oficjalne biblioteki SDK automatycznie ponawiają zapytania w przypadku limitów szybkości i błędów 5xx, stosując wykładnicze wycofywanie (exponential backoff) – domyślnie dwukrotnie – i uwzględniając ten nagłówek, jeśli jest obecny. Błąd 429 występujący w ramach limitów Twojego planu wskazuje na limit przyspieszenia wynikający z nagłego wzrostu aktywności. Błąd 429 z enforced_spend_limit_reached w error.details.error_code, który nigdy nie zawiera nagłówka retry-after, oznacza miesięczny limit wydatków i oczekiwanie nie rozwiąże tego problemu.

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

W Claude Code uruchom /usage, aby wyświetlić paski 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 poświadczeń Admin API, takich jak klucz Admin API.

Czy mogę kontynuować pracę po osiągnięciu limitu planu Claude?

Czasami. Uruchom /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, skorzystać z darmowego resetu limitu, jeśli opcja ta jest dostępna w Settings > Usage w serwisie claude.ai lub aplikacji Claude Desktop, zmienić model, jeśli osiągnięto limit dla Opus, Sonnet lub Fable, albo przenieść pracę na klucz API, który rozlicza użycie na minutę, a nie w ramach okna czasowego.