Ошибка ограничения частоты запросов Claude: что означает «API error: rate limit reached» и как её исправить

Точные сообщения и значение каждого из них

• API Error: 429 {"type":"rate_limit_error", ...} / «достигнут лимит частоты запросов» — вы превысили лимит запросов, токенов или параллельных запросов за заданный интервал. Дождитесь retry-after.
• rate limit reached for <model> с примечанием для конкретной модели — лимиты действуют отдельно для каждой модели; переключение уровня с помощью /model часто помогает сразу.
• «Вы достигли лимита использования» / «лимит сбрасывается в …» — это не лимит частоты запросов, а лимит использования подписки Pro/Max за скользящий период. Дождитесь сброса или используйте ключ API.
• 529 overloaded_error — проблема с доступной мощностью, а не с вашими запросами. Повторяйте попытки с увеличением интервала; это описано в руководстве по ошибкам.
• 400 … tool use concurrency — слишком много параллельных вызовов инструментов за один ход; это не 429, но встречается в тех же сеансах.

Лимиты Claude: три верхних предела

Anthropic ограничивает количество запросов в минуту (RPM), входных и выходных токенов в минуту (ITPM/OTPM) и одновременно выполняемых запросов для каждой модели и организации в зависимости от уровня использования — уровень повышается автоматически по мере роста совокупных расходов. Шлюзы применяют собственные аналогичные ограничения для каждого аккаунта. Значения опубликованы в документации Anthropic и отображаются в вашей консоли; для Claude Code важны лимит параллельных запросов и OTPM, поскольку сеанс агента — это поток длительных параллельных запросов с большим объёмом вывода.

Почему Claude Code достигает лимита, а чат-клиент — нет

Чат-клиент отправляет по одному запросу за раз. Claude Code использует потоковую передачу на каждом ходе, занимая слот параллельного запроса на всё его время, запускает субагентов параллельно, причём каждый занимает ещё один слот, и повторно отправляет весь разговор на каждом ходе, поэтому число токенов в минуту растёт с длительностью сеанса. Десять субагентов в большом репозитории — это десять одновременных потоков и сотни тысяч токенов в минуту; именно это и приводит к 429.

Способы устранения в порядке частоты их срабатывания

• 1. Дайте ему повторить попытку. Claude Code учитывает retry-after; большинство ошибок 429 исчезает за несколько секунд.
• 2. Запускайте меньше субагентов параллельно; выполняйте ресурсоёмкие задачи последовательно, а не распределяйте их для одновременного выполнения.
• 3. /compact — меньший контекст означает меньше токенов на ход, что позволяет снизить нагрузку на лимит TPM.
• 4. Переключите уровень с помощью /model для текущей задачи; лимиты действуют отдельно для каждой модели.
• 5. Перенесите фоновую работу на Haiku; оставьте Sonnet/Opus для основного цикла.
• 6. Запросите повышение лимита: в Anthropic — через повышение уровня расходов или обращение в отдел продаж; на этом шлюзе — напишите в поддержку по электронной почте, указав свой аккаунт и рабочую нагрузку. Для новых аккаунтов изначально установлены осторожные ограничения параллельных запросов именно для того, чтобы один неконтролируемый агент не исчерпал общий пул ресурсов; эти ограничения повышаются по запросу.

/compact focus on the current task
/model claude-sonnet-5
# in scripts: cap the loop and let retries happen
claude -p "..." --max-turns 20

Лимиты частоты запросов на этом шлюзе

Запросы оплачиваются из вашего баланса или в рамках тарифа с фиксированной оплатой; лимиты частоты запросов действуют для каждого аккаунта и не зависят от цены. Шлюз объединяет несколько аккаунтов поставщика, поэтому при 429 для конкретной модели на одном аккаунте запрос перенаправляется на другой, если у него есть свободная ёмкость, вместо того чтобы возвращать ошибку пользователю. Это одна из причин, по которым в сеансах здесь меньше ошибок 429, чем при использовании одного ключа из консоли. Скорее всего, вы достигнете лимита параллельных запросов; напишите в поддержку, указав число одновременно работающих агентов, и его скорректируют.

Все безлимитные тарифы →

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.