Лимиты использования Claude: что делать при ошибке

Каковы лимиты использования Claude?

Лимиты использования Claude разделены на две независимые системы, и первым делом нужно определить, какая из них ограничила ваш доступ. Подписка на Claude (Pro, Max, Team или Enterprise с оплатой за рабочее место) предоставляет фиксированный объем использования, который распределяется между моделями (за исключением нескольких ограничений для конкретных семейств моделей) и общим чатом Claude. При достижении этого лимита вы увидите сообщение вида You've hit your session limit · resets 3:45pm. Исключением являются текущие тарифные планы Enterprise с оплатой по факту использования: в них нет включенного объема, и вся активность тарифицируется по API-ставкам начиная с первого токена. API Claude измеряет другой показатель: скорость отправки запросов и токенов, которая рассчитывается в минуту. При превышении лимита возвращается ошибка 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 (rate limit). Вы достигли лимита, установленного для вашего ключа API, проекта Amazon Bedrock или Google Cloud. То, какой именно лимит применяется, зависит от того, как выполняется аутентификация клиента, поскольку квоты для клиентов Bedrock или Vertex учитываются в рамках вашего облачного проекта, а не организации Anthropic.
• API Error: Server is temporarily limiting requests (not your usage limit) — это кратковременное ограничение (throttle), не связанное с квотами вашего тарифного плана. Claude Code автоматически повторяет запрос с увеличением интервалов ожидания, прежде чем вывести эту строку.

Лимиты подписки: сессионные, недельные и окно Opus

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

• Он общий с чатом Claude. Работа на claude.ai расходует тот же лимит, что и работа в терминале, поэтому активная переписка в чате днем сокращает время на кодинг вечером. Все интерфейсы, в которые вы входите под одной учетной записью, используют общий пул, поэтому в Linux бета-версия настольного приложения и CLI Claude Code расходуют один лимит на двоих, а не каждый по отдельности.
• Он общий для всех моделей. Сессионные и недельные лимиты представляют собой единый пул для всех моделей. Исключениями являются ограничения внутри этого пула для семейств моделей: лимиты Opus и Sonnet, а также квота Fable для планов Max и Premium, составляющая до 50% от недельных лимитов. В планах Pro и Standard модель Fable вообще не включена в лимиты подписки и тарифицируется по кредитам использования с первого же запроса.

В Claude for Teams и планах Enterprise с оплатой за рабочее место предусмотрен лимит на каждое место, который обновляется в рамках скользящего пятичасового и недельного окна. Этот лимит является общим с чатом Claude и Cowork, а его размер зависит от уровня подписки (Standard или Premium). Текущие планы Enterprise с оплатой по факту использования работают иначе: здесь нет включенного лимита, который может закончиться, использование оплачивается по тарифам API, а потолок расходов определяется лимитами, установленными администраторами на уровне организации или для отдельных пользователей. В планах с поддержкой отдела продаж использование, остановленное из-за достижения лимита расходов, возобновляется в начале следующего расчетного периода, если владелец не увеличит лимит раньше. В планах с самостоятельным управлением использование также прекращается при исчерпании баланса предоплаченных кредитов до тех пор, пока владелец не пополнит счет. Для планов Pro и Max время сброса, указанное в сообщении, и ваши собственные полосы /usage являются достоверными данными, а не цифры из публикаций в блогах. Если вы еще выбираете тариф, сравнение планов Claude поможет понять, какие возможности ограничивает каждый из них.

Почему переключение модели через /model не восстанавливает сессию или недельный лимит

Это самая распространенная ошибка, и документация прямо указывает на это: лимиты сессии и недельные лимиты являются общими для всех моделей, поэтому переключение моделей не восстанавливает доступ. Выбор менее мощной модели после исчерпания лимита сессии лишь меняет модель, которая будет отвечать. Это не меняет остаток доступных запросов, так как лимиты сессии и недельные лимиты не привязаны к конкретной модели, поэтому переключение ничего не дает.

Исключением являются ограничения для семейств моделей. Если сообщение об ошибке гласит You've hit your Opus limit или You've hit your Sonnet limit, то /model — верное решение. Переключитесь на модель из другого семейства и продолжайте работу, так как были заблокированы запросы только для этого семейства. Лимит Fable для тарифов Max и Premium работает аналогично: переключитесь на другую модель, чтобы продолжить работу в рамках вашего плана, или продолжайте использовать Fable за счет кредитов на использование. Однако Fable расходует общий недельный лимит быстрее, чем другие модели, поэтому переключение после достижения лимита Fable не позволит вам превысить общий недельный лимит.

Воспринимать лимит как ошибку в работе системы — вторая распространенная ошибка. Переустановка или повторная аутентификация ничего не изменят. Лимит восстанавливается после сброса временного окна, при использовании бесплатного сброса лимита или при покупке кредитов на использование.

Что делать при достижении лимита подписки

1. Узнайте время сброса. Окно сессии короткое. Недельное окно — это не то, что стоит ждать, сидя за рабочим столом. В Claude Code версии 2.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, и каждое предложение имеет срок действия.
5. Выполните /usage-credits, чтобы продолжить работу после достижения потолка. Для планов Pro и Max откроются настройки биллинга. Для планов Team и Enterprise откроются настройки использования вашей организации или будет отправлен запрос администраторам, если у вас нет доступа к биллингу.
6. Если вы упираетесь в один и тот же лимит каждую неделю, значит, текущий план не соответствует вашему рабочему процессу, и стоит один раз изучить способы выхода из ограничений использования, вместо того чтобы делать это при каждом сбросе.

/usage-credits требует наличия подписки claude.ai, выполненной через /login. Эта функция недоступна при аутентификации с помощью API key, так как API key не имеет квоты плана, которую можно расширить.

У использования кредитов есть один побочный эффект, о котором стоит знать заранее. По умолчанию Claude Code предоставляет вашей основной беседе кэш промптов (prompt cache) длительностью один час, пока вы находитесь в рамках включенного в подписку объема использования. Как только вы начинаете расходовать кредиты, время жизни кэша сокращается до пяти минут. Из-за этого большее количество итераций начинается «с нуля», и потребление токенов в Claude Code для той же задачи возрастает. Субагенты не входят в этот основной объем беседы, поэтому для них время жизни кэша составляет пять минут даже при использовании лимитов плана. Самостоятельный выбор TTL с помощью настройки promptCacheTtl или CLAUDE_CODE_PROMPT_CACHE_TTL в Claude Code версии 2.1.242 или новее позволяет сохранить часовое время жизни кэша при расходовании кредитов.

Сообщения, которые выглядят как лимиты использования, но ими не являются

Четыре ошибки Claude Code ошибочно принимаются за лимиты использования, хотя ни одна из них таковой не является.

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

Еще одна ошибка поступает со стороны API. Ошибка 413 request_too_large — это ограничение размера одного запроса, а не лимит частоты запросов (rate limit).

Лимиты API: что именно учитывает ошибка 429

Messages API отслеживает три показателя отдельно для каждого класса моделей:

• запросы в минуту (RPM);
• входные токены в минуту (ITPM);
• выходные токены в минуту (OTPM).

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

Четыре механизма определяют, когда именно приходит ошибка 429.

• Лимиты действуют для каждого класса моделей. Они применяются отдельно к каждой модели, поэтому вы можете одновременно использовать разные модели в пределах их соответствующих лимитов. Некоторые семейства делят общий пул: лимит для 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) можно установить более низкий лимит, при этом общеорганизационные лимиты действуют всегда, даже если сумма лимитов рабочих пространств их превышает. Лимит, который вы не переопределили для рабочего пространства, наследуется от организации, а не остается неограниченным.

Уровни Start, Build, Scale и Custom определяют конкретные значения, которые назначаются автоматически на основе истории использования и статуса аккаунта. Новые организации и те, у кого мало истории использования, могут начать с уровня Evaluation, который ниже стандартных опубликованных лимитов, поэтому первая ошибка 429 может появиться раньше, чем предсказывает таблица. Резкое увеличение нагрузки активирует лимиты ускорения, которые возвращают 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 содержит этот заголовок; он никогда не передается при достижении лимита расходов (spend-cap).
• anthropic-ratelimit-requests-limit, anthropic-ratelimit-requests-remaining и anthropic-ratelimit-requests-reset описывают ваш бюджет запросов.
• anthropic-ratelimit-input-tokens-* и anthropic-ratelimit-output-tokens-* делают то же самое для ITPM и OTPM, используя те же суффиксы: limit (лимит), remaining (остаток) и reset (сброс).
• 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 в теле ошибки и как _request_id в ответах SDK для Python и TypeScript. Указывайте его при обращении в службу поддержки.

Прежде чем писать цикл с повторными попытками (backoff loop), проверьте, действительно ли он вам нужен. Официальные SDK автоматически повторяют запросы при временных сбоях, включая ошибки соединения, превышение лимитов (rate limits) и ошибки сервера 5xx, используя экспоненциальную задержку. По умолчанию выполняется две попытки с учетом заголовка retry-after, если он присутствует. Каждый клиент поддерживает опцию maximum-retries для изменения или отключения этого поведения.

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 временно перегружен; это может произойти, когда API испытывает высокую нагрузку от всех пользователей. Это не связано с вашим ключом или кодом. Повторите запрос с использованием экспоненциальной задержки (exponential backoff), что SDK уже делают для ответов 5xx, и проверьте статус на status.claude.com, если проблема не исчезает. Ошибка 500 api_error — это внутренняя ошибка, которую следует повторить таким же образом; ни одна из них не является ограничением частоты запросов (rate limit).

Просмотр собственных лимитов вместо таблицы

При наличии подписки экран /usage является основным. На нем отображаются индикаторы использования вашего тарифного плана и детализация потребления ресурсов, а переключатели d или w позволяют выбрать период: последние 24 часа или последние 7 дней. Есть два нюанса. Блок Session показывает использование API-токенов и предназначен для пользователей API, поэтому подписчики могут игнорировать указанную там сумму в долларах. Цифры берутся из локальной истории сессий на данном устройстве, поэтому данные об использовании с другого устройства или через claude.ai отсутствуют.

Что касается API, страница Usage в Claude Console содержит два графика: "Rate Limit - Input Tokens" и "Rate Limit - Output Tokens". На графике входных данных отображается почасовой максимум некэшированных входных токенов в минуту в сравнении с вашим текущим лимитом ITPM, а рядом указана скорость кэширования. Это позволяет отслеживать приближение к лимиту, а не сталкиваться с ним в процессе эксплуатации.

Чтобы получить настроенные лимиты программным способом:

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 или ключ личной учетной записи либо сервисной учетной записи, не ограниченный рабочим пространством. Ключи API рабочего пространства не подходят. GET /v1/organizations/workspaces/{workspace_id}/rate_limits выполняет аналогичную операцию для каждого рабочего пространства. Оба метода работают только на чтение: чтобы изменить лимит, используйте страницу Rate limits в Console.

Использование less для соблюдения лимитов

Обе системы учитывают одни и те же показатели, поэтому данные методы применимы к каждой из них.

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

Больше всего это затрагивает работу, связанную с передачей больших объемов данных в контекст: если вы анализируете акции и опционы на основе рыночных данных в реальном времени, извлечение только необходимого фрагмента для каждого вопроса стоит значительно дешевле, чем вставка целых таблиц с котировками. Задачи с высокой интенсивностью запросов, выполняемые программой, а не человеком, изначально должны использовать API-ключ. Переход на него меняет не только способ оплаты, но и систему учета, так как у Claude API нет бесплатного тарифа. Планы Max и Team включают ежемесячные API-кредиты для запуска собственных приложений и агентов после привязки организации в Console. Эти кредиты не распространяются на 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 уже выполняют повторные попытки при получении ошибок rate limit и 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 консоль отображает ваши лимиты запросов, а GET /v1/organizations/rate_limits возвращает настроенные лимиты при использовании учетных данных Admin API, таких как ключ Admin API.

Можно ли продолжить работу после достижения лимита плана Claude?

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