Ліміти Claude: що робити після їх вичерпання

Які ліміти використання має Claude?

Ліміти використання Claude складаються з двох окремих систем, і спочатку потрібно визначити, яка саме з них вас зупинила. Передплата Claude (Pro, Max, Team або Enterprise із тарифікацією за місцями) надає спільний для моделей динамічний ліміт використання, за винятком кількох обмежень для сімейств моделей. Цей ліміт також спільний із чатом Claude, тому після його вичерпання з’являється повідомлення на кшталт You've hit your session limit · resets 3:45pm. Поточні Enterprise-плани з оплатою за використання є винятком: вони не мають включеного ліміту, а все використання тарифікується за ставками API вже з першого токена. Claude API вимірює інший показник: швидкість надсилання запитів і токенів, яку обчислюють за хвилину. У разі перевищення API повертає помилку HTTP 429 типу rate_limit_error, зазвичай із заголовком retry-after, у якому зазначено, скільки секунд потрібно зачекати.

Ці проблеми вирішуються зовсім по-різному. Ліміт передплати залежить від обсягу використання у певному часовому вікні, тому потрібно дочекатися скидання, придбати додатковий обсяг або використати безкоштовне скидання ліміту, якщо воно передбачене вашим планом. Ліміт швидкості API залежить від вашої поточної швидкості, і після її зменшення зазвичай знімається за кілька секунд.

Доступні обсяги за планом і номери рівнів лімітів швидкості часто змінюються, тому неправильне число гірше, ніж його відсутність. Тут їх не наведено. Перевірте власні значення за допомогою команд нижче.

Яке обмеження спрацювало? Прочитайте точне повідомлення

Claude Code називає систему в тексті, який виводить. Визначте свою систему, перш ніж щось змінювати.

• You've hit your session limit · resets 3:45pm — це обмеження підписки. Доступний для вашого плану ковзний ліміт на цей період вичерпано.
• You've hit your weekly limit · resets Mon 12:00am — це те саме обмеження для довшого періоду.
• You've hit your Opus limit · resets 3:45pm — це обмеження підписки, яке застосовується лише до запитів Opus. Перехід на модель поза сімейством Opus дасть змогу продовжити роботу.
• You've hit your Sonnet limit · resets 3:45pm — це такий самий ліміт для сімейства моделей, але лише для запитів Sonnet. Перехід на модель поза сімейством Sonnet дасть змогу продовжити роботу.
• Повідомлення, яке починається з Fable limit reached, означає, що ви використали дозволену частку тижневого ліміту для моделей Fable. Подальше використання Fable списуватиме кредити за використання, тому Claude Code спочатку просить підтвердження. Виберіть іншу модель за допомогою /model, щоб залишатися в межах свого плану.
• API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com. — це обмеження швидкості API. Ви досягли ліміту, налаштованого для вашого API key, або для проєкту Amazon Bedrock чи Google Cloud. Застосовне обмеження залежить від способу автентифікації клієнта, оскільки клієнт Bedrock або Vertex обліковується в квоті вашого cloud-проєкту, а не в межах організації Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) — це короткочасне обмеження швидкості, не пов’язане з квотою вашого плану. Claude Code автоматично повторює запит із поступовим збільшенням інтервалу перед тим, як показати цей рядок.

Ліміти підписки: сесійний, тижневий і ліміт вікна Opus

План Pro, Max, Team або Enterprise із оплатою за місце включає ковзний ліміт використання. Коли його вичерпано, Claude Code блокує наступні запити до часу скидання, зазначеного в повідомленні. Найбільше плутанини спричиняють дві властивості цього ліміту.

• Він спільний із Claude chat. Робота на claude.ai використовує той самий ліміт, що й робота в терміналі, тому активне використання чату вдень скорочує доступний час для програмування ввечері. Усі інтерфейси, у яких ви ввійшли за допомогою цього облікового запису, використовують один спільний пул. Тому в Linux бета-версія desktop app і Claude Code CLI витрачають один спільний ліміт, а не окремий ліміт кожен.
• Він спільний між моделями. Сесійні та тижневі ліміти утворюють один пул для всіх моделей. Винятки — обмеження всередині сімейств моделей: ліміти Opus і Sonnet, а для місць Max і Premium — виділення Fable обсягом до 50% тижневих лімітів. Для місць Pro і Standard Fable взагалі не входить до лімітів плану та оплачується за рахунок usage credits із першого запиту.

У Claude for Teams і Enterprise із оплатою за місце документована схема передбачає ліміт на кожне місце, який скидається у ковзному п’ятигодинному вікні та щотижневому вікні, є спільним із Claude chat і Cowork та залежить від рівня місця (Standard або Premium). Поточні Enterprise-плани з оплатою за використання працюють інакше: включеного ліміту, який можна вичерпати, немає; використання оплачується за тарифами API, а граничний обсяг визначається лімітами витрат, які адміністратори встановлюють на рівні організації та для окремих користувачів. У плані з оформленням за участю відділу продажів використання, зупинене через ліміт витрат, поновлюється на початку наступного розрахункового періоду, якщо власник не збільшить ліміт раніше. У плані self-serve використання також зупиняється, коли вичерпується передплачений кредитний баланс, і залишається зупиненим, доки власник не придбає додаткові кредити. Для Pro і Max надійними значеннями є час скидання, надрукований у повідомленні, і ваші власні /usage індикатори, а не цифра, скопійована з допису в блозі. Якщо ви ще обираєте рівень, порівняння потрібного вам плану Claude показує, які обмеження встановлює кожен із них.

Чому перемикання моделі через /model не відновлює сесію або тижневий ліміт

Це найпоширеніша помилка, і в документації про це сказано прямо: ліміти сесії та тижневий ліміт є спільними для всіх моделей, тому перемикання моделі не відновлює доступ. Вибір меншої моделі після вичерпання вікна сесії змінює лише модель, яка відповідатиме. Обсяг доступного ліміту не змінюється, оскільки ліміти сесії та тижневий ліміт не зберігаються окремо для кожної моделі. Тому перемикання нічого не вивільняє.

Винятком є ліміти для сімей моделей. Якщо повідомлення містить You've hit your Opus limit або You've hit your Sonnet limit, правильне рішення — /model. Перейдіть на модель з іншого сімейства й продовжуйте роботу, оскільки заблоковано лише запити до цього сімейства. Ліміт Fable для тарифів Max і Premium працює так само: перейдіть на іншу модель, щоб продовжити роботу в межах свого плану, або продовжуйте використовувати Fable за рахунок usage credits. Водночас Fable швидше витрачає спільний тижневий пул, ніж інші моделі, тому перемикання після досягнення ліміту Fable не дасть змоги перевищити загальний тижневий ліміт.

Вважати ліміт помилкою — друга поширена помилка. Повторне встановлення або повторна автентифікація нічого не змінюють. Доступний ліміт відновлюється після скидання вікна, використання безкоштовного скидання ліміту або придбання usage credits.

Що робити, якщо ви досягли ліміту підписки

1. Перевірте час скидання. Вікно сеансу коротке. Тижневий ліміт не варто просто перечікувати за робочим столом. У Claude Code v2.1.234 або новішої версії /rate-limit-options може дочекатися скидання й автоматично продовжити перерване завдання.
2. Якщо це ліміт Opus, Sonnet або Fable, виконайте /model і виберіть модель поза цим сімейством.
3. Виконайте /usage, щоб переглянути ліміти свого плану, використані обсяги та час їх скидання. /cost — псевдонім для того самого екрана.
4. Перевірте Settings > Usage на claude.ai або в Claude Desktop і знайдіть розділ Resets. Для відповідних планів іноді пропонується безкоштовне скидання ліміту. Натискання "Reset for free" одразу повертає до повного значення п’ятигодинний ліміт сеансу або тижневий ліміт — залежно від того, який ліміт охоплює пропозиція. Ця кнопка недоступна в Claude Code у терміналі або IDE, а також у Claude Mobile; кожна пропозиція має строк дії.
5. Виконайте /usage-credits, щоб продовжити роботу після досягнення ліміту. У Pro і Max ця команда відкриває налаштування оплати. У Team і Enterprise вона відкриває налаштування використання вашої організації або надсилає запит адміністраторам, якщо у вас немає доступу до оплати.
6. Якщо щотижня ви досягаєте того самого ліміту, план не відповідає вашому способу роботи. Варто один раз розглянути варіанти подолання ліміту використання, а не повертатися до цього питання під час кожного скидання. Якщо ви оплачуєте підписку гривневою карткою, перед переходом на вищий план перевірте, скільки насправді коштують Pro і Max у гривнях з ПДВ, адже до доларової ціни додаються 20% ПДВ і курсовий спред банку.

Для /usage-credits потрібна активна підписка claude.ai, виконаний вхід через /login. Ця можливість недоступна за автентифікації за API key, оскільки API key не має ліміту плану, який можна розширити.

Кредити на використання мають один важливий побічний ефект. За замовчуванням Claude Code зберігає кеш підказок для основної розмови протягом однієї години, поки ви використовуєте включений у підписку обсяг. Коли ви починаєте використовувати кредити, час кешування скорочується до п’яти хвилин. Через це більше запитів починаються без кешу, а використання токенів Claude Code зростає для тієї самої роботи. Subagents не входять до обсягу основної розмови, тому навіть у межах використання плану для них діє п’ятихвилинний час кешування. Якщо задати TTL самостійно за допомогою параметра promptCacheTtl або CLAUDE_CODE_PROMPT_CACHE_TTL у Claude Code v2.1.242 або новішої версії, одногодинний час кешування зберігається навіть під час використання кредитів.

Повідомлення, які схожі на обмеження використання, але ними не є

Чотири помилки Claude Code помилково вважають обмеженнями використання. Насправді жодна з них такою не є.

• Попередження про контекст або auto-compact не є обмеженням використання. /context виводить рядок на кшталт Context exceeds the 200k-token limit by 94k tokens, а потім команду, яка звільняє місце, коли розмір розмови перевищує контекстне вікно моделі. Compacting узагальнює старішу історію, щоб звільнити місце, але це не безкоштовно: /compact читає розмову, яку узагальнює, тому compacting великого контексту сам є великим запитом у межах вашого плану. Якщо замість продовження розмови потрібен чистий початок, /clear не коштує нічого.
• Prompt is too long · automatic compaction failed: <the underlying error> означає, що автоматичне compacting завершилося помилкою, яку воно вказує. /compact продовжує повертати цю саму помилку, доки ви її не усунете.
• Credit balance is too low означає, що у вашої Console organization закінчилися передплачені кредити або Claude Code надсилає запити підписника через Console API key; /status показує, які облікові дані активні. Додайте кредити на platform.claude.com/settings/billing. Там також можна ввімкнути auto-reload.
• 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 є перевіркою права доступу, а не вичерпаною квотою. Якщо ви вибрали варіант Opus 4.6 або Sonnet 4.6 з [1m], виберіть варіант без суфікса [1m] або задайте CLAUDE_CODE_DISABLE_1M_CONTEXT=1. Якщо це повідомлення з’являється під час розмови, оскільки контекст перевищив 200K tokens, Claude Code сам виконує compacting до стандартного ліміту. Sonnet 5 і пізніші версії, Opus 4.7 і пізніші версії, Haiku 5.5 та моделі Fable працюють із native 1M window і не мають суфікса, який потрібно прибирати; саме ця змінна обмежує їх до 200K.

Ще одна помилка надходить від API. Помилка 413 request_too_large є обмеженням розміру одного запиту, а не обмеженням частоти запитів.

Обмеження частоти API: що насправді підраховує код 429

Messages API окремо для кожного класу моделей вимірює три показники.

• запити за хвилину (RPM)
• вхідні токени за хвилину (ITPM)
• вихідні токени за хвилину (OTPM)

Ваша організація також має ліміт витрат. Це інший показник: максимальна щомісячна вартість використання API. Коли ви досягаєте ліміту витрат свого рівня, використання API призупиняється до початку наступного місяця, якщо ви не запросите вищий ліміт. У такому разі також повертається 429 rate_limit_error, але без заголовка retry-after і з enforced_spend_limit_reached у error.details.error_code. Цикл повторних спроб цього не виправить. Нижчий ліміт витрат, який ви самостійно встановили в Console, проявляється інакше: запити повертають HTTP 400 invalid_request_error із повідомленням, що починається з You have reached your specified API usage limits, а збільшення або видалення ліміту відновлює доступ.

Чотири механізми визначають, коли надходить 429.

• Ліміти діють для кожного класу моделей. Вони застосовуються окремо до кожної моделі, тому ви можете одночасно використовувати різні моделі в межах відповідних лімітів. Деякі сімейства використовують спільний bucket: ліміт частоти Opus є загальним для Claude Opus 4.8, Opus 4.7, Opus 4.6 і Opus 4.5, тоді як Claude Sonnet 5 має власний ліміт.
• Ємність поповнюється безперервно. API використовує алгоритм token bucket, тому ємність поповнюється безперервно, а не скидається у фіксований момент. Ліміт 60 запитів за хвилину може фактично застосовуватися як один запит за секунду, тому 60 запитів, надісланих одночасно, усе одно завершаться помилкою.
• На більшості моделей до ITPM зараховуються лише некешовані вхідні дані. input_tokens і cache_creation_input_tokens зараховуються. cache_read_input_tokens не зараховується на більшості моделей Claude; документований виняток — Claude Haiku 3.5. Тому кешування збільшує доступний запас для обмеження частоти й одночасно зменшує вартість. Для вихідних даних високий max_tokens не зараховується до OTPM, оскільки OTPM враховує лише фактично згенеровані токени.
• Ліміти діють на рівні організації. Для workspace можна встановити нижчий ліміт, а загальноорганізаційні ліміти застосовуються завжди, навіть якщо сума лімітів workspace є більшою. Якщо для workspace не встановлено власний ліміт, він успадковує ліміт організації, а не залишається необмеженим.

Рівні Start, Build, Scale і Custom визначають фактичні значення. Вони призначаються автоматично на основі історії використання та стану облікового запису. Нові організації та організації з малою історією використання можуть почати з рівня Evaluation, нижчого за стандартні опубліковані ліміти, тому перший 429 може надійти раніше, ніж передбачає таблиця. Різке збільшення використання активує acceleration limits, які повертають 429, навіть якщо ви ще не вийшли за межі свого рівня, тому збільшуйте навантаження поступово. Кожне опубліковане значення є верхньою межею: задокументовані ліміти визначають максимально дозволене використання, а не гарантований мінімум. Щоб запросити вищий ліміт, скористайтеся пунктом "Request tier increase" на сторінці Rate limits у Claude Console.

Опрацювання помилки 429: retry-after, заголовки та повторні спроби в SDK

Кожна помилка API повертає однакову оболонку: вкладений об’єкт error, що містить тип і повідомлення, а також кореневе поле request_id.

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

Решта інформації міститься в заголовках.

• retry-after — кількість секунд, яку потрібно зачекати перед повторною спробою виконати запит. Раніші повторні спроби завершаться помилкою. Він є не в кожній відповіді 429, а у відповіді 429 через ліміт витрат його ніколи немає.
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining і anthropic-ratelimit-requests-reset описують бюджет вашого запиту.
• anthropic-ratelimit-input-tokens-* і anthropic-ratelimit-output-tokens-* містять такі самі дані для ITPM і OTPM, із суфіксами для ліміту, залишку та скидання.
• anthropic-ratelimit-tokens-* показує значення для найсуворішого ліміту, який наразі діє.

Заголовки скидання містять часові мітки RFC 3339. Заголовки залишку токенів округлюються до найближчої тисячі, тому сприймайте їх як індикатор. Fast mode має власний пул і власні заголовки anthropic-fast-*. Зчитуйте всі ці заголовки з будь-якого успішного виклику:

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'

Кожна відповідь також містить унікальний заголовок request-id, наприклад req_018EeWyXxfu5pfWkrYcMdjWG. У тілах помилок він має назву request_id, а у відповідях Python і TypeScript SDK — _request_id. Наводьте його значення, звертаючись до служби підтримки.

Перш ніж писати власний цикл із затримкою, перевірте, чи потрібен він узагалі. Офіційні SDK автоматично повторюють тимчасово невдалі запити, зокрема після помилок з’єднання, перевищення ліміту та помилок сервера 5xx, використовуючи експоненційну затримку. За замовчуванням вони виконують дві повторні спроби та враховують заголовок retry-after, якщо він присутній. Кожен клієнт приймає параметр максимальної кількості повторних спроб, за допомогою якого цю поведінку можна змінити або вимкнути.

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

529 overloaded_error — це не ваша помилка

Код 429 означає, що ви надсилали запити надто швидко. Код 529 overloaded_error означає, що API тимчасово перевантажений. Це може статися через високий рівень трафіку для всіх користувачів. Причина не у вашому ключі та не у вашому коді. Повторіть запит із експоненційною затримкою. SDK уже роблять це для відповідей 5xx. Якщо проблема не зникає, перевірте status.claude.com. Код 500 api_error означає внутрішню помилку. Повторюйте запит у такий самий спосіб. Жоден із цих кодів не означає перевищення ліміту запитів.

Перевіряйте власні ліміти, а не таблицю

Для підписки важливим є екран /usage. На ньому показано індикатори використання плану та розподіл витрат за ними, а d або w перемикає період між останніми 24 годинами та останніми 7 днями. Є два нюанси. Блок Session показує використання API-токенів і призначений для користувачів API, тому підписники можуть не враховувати в ньому суму в доларах. Дані надходять із локальної історії сеансів на цьому комп’ютері, тому використання з іншого пристрою або з claude.ai не враховується.

На стороні API сторінка Usage у Claude Console містить два графіки: "Rate Limit - Input Tokens" і "Rate Limit - Output Tokens". На графіку вхідних токенів погодинний максимум некешованих вхідних токенів за хвилину порівнюється з поточним лімітом ITPM. Поруч показано коефіцієнт використання кешу. Так можна відстежувати наближення до ліміту, а не чекати його досягнення у production.

Щоб програмно переглянути налаштовані ліміти:

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

Потрібні облікові дані Admin API: ключ Admin API, OAuth-токен із дозволом org:admin або ключ користувача чи service account, не обмежений певним workspace. Ключі API workspace не працюють. GET /v1/organizations/workspaces/{workspace_id}/rate_limits виконує те саме для окремого workspace. Обидві команди доступні лише для читання. Щоб змінити ліміт, відкрийте сторінку Rate limits у Console.

Використовуйте менше, щоб рідше досягати лімітів

Обидві системи фактично враховують те саме, тому ці способи працюють в обох.

• Витрачайте менше токенів за один крок. Тривалі безперервні сеанси зберігають кеш прогрітим, а /clear між не пов’язаними завданнями нічого не коштує. У матеріалі Використання токенів Claude Code ці способи описано повністю.
• Зменште рівень зусиль. Доступні рівні: low, medium, high, xhigh і max. У меню /effort також є ultracode, але цей параметр збільшує витрати, а не зменшує їх. Глибоке міркування не дає переваг під час механічного перейменування.
• Зменште паралелізм після помилки 429. Знизьте CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY і не запускайте багато паралельних субагентів. Також виконайте /status: випадковий ANTHROPIC_API_KEY спрямовує запити через ключ нижчого рівня замість вашої підписки.
• Перенесіть неінтерактивні завдання до Message Batches API. API асинхронно обробляє великі обсяги даних зі знижкою 50% на вхідні та вихідні токени й використовує власні обмеження швидкості. Тому нічне завдання більше не конкурує з вашим сеансом.

Найсильніше це відчувається під час роботи, яка завантажує дані в контекст: якщо ви аналізуєте акції та опціони на основі актуальних ринкових даних, отримання лише потрібного для кожного запитання фрагмента коштує значно менше, ніж вставлення повних таблиць котирувань і опціонних ланцюжків. Періодичні завдання, якими керує програма, а не людина, від самого початку слід запускати з API key. Це змінює не лише спосіб обліку, а й спосіб оплати, оскільки Claude API не має безкоштовного рівня. Плани Max і Team включають щомісячні API credits для запуску власних застосунків і агентів після підключення організації в Console. Ці credits не поширюються на Claude Code і не змінюють ліміти використання вашого плану. У матеріалі Перший застосунок Claude API на VPS описано роботу з ключами та повторні спроби, а тривалий запуск агента переживе розрив з’єднання, якщо ви залишите Claude Code запущеним на VPS у tmux.

FAQ

Чому перемикання моделей не усуває мій ліміт використання Claude?

Тому що сесійні та тижневі ліміти спільні для всіх моделей. Ця квота належить плану, а не моделі, тому /model змінює модель, яка відповідатиме, але не обсяг доступної квоти. Виняток становлять ліміти сімейства моделей: You've hit your Opus limit і You've hit your Sonnet limit застосовуються лише до відповідного сімейства, а ліміт Fable для планів Max і Premium обмежує лише Fable. У такому випадку перемикання моделі є рекомендованим способом вирішення проблеми.

Що означає 429 rate_limit_error і скільки потрібно чекати?

Це означає, що для цього класу моделей ваш обліковий запис досяг ліміту частоти запитів: кількості запитів за хвилину, вхідних токенів за хвилину або вихідних токенів за хвилину. Відповідь зазвичай містить заголовок retry-after із кількістю секунд очікування, а попередні повторні спроби завершуються помилкою. Офіційні SDK вже повторюють запити після перевищення лімітів частоти та помилок 5xx з експоненційною затримкою, за замовчуванням двічі, враховуючи цей заголовок, якщо він присутній. Якщо 429 виникає, коли ви все ще перебуваєте в межах лімітів свого рівня, це вказує на ліміт прискорення через раптове збільшення навантаження. 429 із enforced_spend_limit_reached у error.details.error_code, який ніколи не містить заголовка retry-after, означає місячний ліміт витрат, і очікування протягом кількох хвилин його не скасує.

Як переглянути ліміти використання Claude і час їх скидання?

У Claude Code виконайте /usage, щоб переглянути індикатори вашого плану, час скидання та деталізацію використання; /cost є псевдонімом, а d або w перемикає період між останніми 24 годинами та останніми 7 днями. Ці показники отримуються з локальної історії сесій, тому вони не враховують використання з інших пристроїв і з claude.ai. Для API у Console відображаються графіки лімітів частоти, а GET /v1/organizations/rate_limits повертає налаштовані ліміти за обліковими даними Admin API, наприклад за ключем Admin API.

Чи можна продовжити роботу після досягнення ліміту плану Claude?

Іноді. Виконайте /usage-credits, щоб придбати використання понад ліміт у планах Pro і Max або запросити його в адміністратора для Team і Enterprise; для цього потрібен вхід до claude.ai через /login, і ця можливість недоступна за автентифікації за допомогою API key. В іншому разі дочекайтеся часу скидання, скористайтеся безкоштовним скиданням ліміту, якщо Settings > Usage у claude.ai або Claude Desktop пропонує таку можливість, перемкніть модель, якщо було досягнуто ліміту Opus, Sonnet або Fable, або перенесіть роботу на API key, де облік ведеться за хвилинами, а не за часовим вікном.