Ограничения скорости

Существует два типа ограничений:

1. Лимиты расходов (spend limits) устанавливают максимальную ежемесячную сумму, которую организация может потратить на использование API.
2. Ограничения скорости (rate limits) устанавливают максимальное количество запросов к API, которое организация может выполнить за определённый период времени.

API применяет настроенные сервисом ограничения на уровне организации, но вы также можете установить настраиваемые пользователем ограничения для рабочих пространств вашей организации.

Об ограничениях скорости

• Ограничения разработаны для предотвращения злоупотреблений API при минимальном влиянии на типичные сценарии использования клиентами.
• Ограничения определяются уровнем использования (usage tier). Организации автоматически помещаются на определённый уровень на основе истории использования и состояния аккаунта и со временем могут переходить на более высокий уровень по мере использования API.
• Новые организации и организации с ограниченной историей использования могут начинать с уровня Evaluation, лимиты которого ниже стандартных лимитов, указанных на этой странице, пока формируется история аккаунта. Эти начальные лимиты являются частью мер Anthropic по предотвращению мошенничества и злоупотреблений, и они автоматически увеличиваются по мере того, как ваша организация накапливает историю использования.
• Ограничения устанавливаются на уровне организации. Уровень вашей организации и текущие лимиты можно посмотреть на странице Rate limits в Claude Console.
• Вы можете столкнуться с ограничениями скорости на более коротких временных интервалах. Например, скорость 60 запросов в минуту (RPM) может применяться как 1 запрос в секунду. Короткие всплески запросов могут превысить лимит и вызвать ошибки ограничения скорости.
• Приведённые ниже лимиты являются стандартными для каждого уровня. Если вам нужны более высокие лимиты, см. раздел Запрос более высоких лимитов.
• Для ограничения скорости API использует алгоритм маркерной корзины (token bucket). Это означает, что ваша пропускная способность непрерывно пополняется до максимального лимита, а не сбрасывается через фиксированные интервалы.
• Все описанные здесь лимиты представляют собой максимально допустимое использование, а не гарантированные минимумы. Эти лимиты предназначены для снижения непреднамеренного перерасхода и обеспечения справедливого распределения ресурсов между пользователями.

Лимиты расходов

Каждый из уровней Start, Build и Scale имеет ежемесячный предел расходов — максимальную сумму, которую ваша организация может потратить на API в каждом календарном месяце. Вы можете просмотреть ежемесячный предел расходов вашей организации и установить собственный лимит на странице Billing.

Организации на уровне Custom не имеют ежемесячного предела расходов; лимиты согласовываются с их командой по работе с аккаунтом.

Достижение предела расходов

Как только вы достигаете предела расходов вашего уровня, использование API приостанавливается до 00:00 UTC первого дня следующего месяца, если только вы не запросите более высокий лимит раньше. Пока использование приостановлено, запросы к API возвращают HTTP 429:

{
  "type": "error",
  "error": {
    "type": "rate_limit_error",
    "message": "You have reached your API usage limits: your organization has crossed its monthly API usage threshold, set based on your organization's API tier. You will regain access on 2026-09-01 at 00:00 UTC.",
    "details": { "error_code": "enforced_spend_limit_reached" }
  },
  "request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}

• Тип ошибки — rate_limit_error, такой же, как при ограничении скорости, но в ответе нет заголовка retry-after. Повторные попытки, включая автоматические повторы SDK, будут завершаться неудачей до восстановления доступа.
• В Messages API значение error.details.error_code равно enforced_spend_limit_reached. Используйте его, чтобы отличить этот ответ от ограничения скорости.
• Переход на более высокий уровень восстанавливает доступ; см. раздел Запрос более высоких лимитов.

Установка собственного лимита расходов

Вы также можете установить собственный лимит расходов ниже предела вашего уровня для контроля затрат:

1. 1

   Перейдите на страницу Billing

   Откройте Settings > Billing в Claude Console.

2. 2

   Откройте редактор лимита расходов

   В разделе Spend limits нажмите Adjust limit (или Set limit, если лимит в данный момент не установлен).

3. 3

   Измените лимит расходов

   Введите новое значение. Ваш лимит расходов не может превышать предел вашего текущего уровня.

Когда использование достигает установленного вами лимита расходов, запросы возвращают HTTP 400 с типом ошибки invalid_request_error. Сообщение начинается со слов You have reached your specified API usage limits или You have reached your specified workspace API usage limits для лимита рабочего пространства и указывает, когда доступ будет возобновлён. Повысьте или удалите лимит, чтобы восстановить доступ раньше.

Лимиты рабочего пространства Claude Code проверяются отдельно: запросы Claude Code, превышающие лимит этого рабочего пространства, могут вместо этого получить ответ 429 с заголовком retry-after.