Диагностика · Claude Code

Claude Code API Error 429 (rate_limit_error) — причина и решение

Claude Code печатает API Error: 429 rate_limit_error, когда исчерпан поминутный лимит. Что это за лимит, почему его выбивают параллельные агенты и как это чинится.

Что вы видите

API Error: 429 {"type":"error","error":{"type":"rate_limit_error","message":"This request would exceed your organization's rate limit of 80,000 input tokens per minute. Please reduce the prompt length or the maximum tokens requested, or try again later."}}

Почему возникает

  • Превышен поминутный потолок по токенам или запросам у API-организации, которой принадлежит ключ. Число в сообщении — собственный лимит этой организации, поэтому у разных аккаунтов оно разное.
  • Несколько сессий Claude Code или субагентов работают параллельно на одном ключе — каждая на каждом ходе пересылает весь свой контекст, поэтому всплески накапливаются быстрее, чем кажется.
  • Один очень большой контекст может исчерпать поминутный бюджет токенов сам по себе — поэтому сообщение предлагает не только подождать, но и сократить промпт.
  • Ретраи, наложенные поверх всплеска, вызвавшего первый 429, раздувают его вместо того, чтобы дать ему рассосаться.

Что делать

  • Переждите минутное окно — Claude Code ретраит автоматически и учитывает Retry-After. Если ошибка повторяется, уменьшите число сессий на одном ключе.
  • Сократите то, что несёт каждый ход: сверните разросшийся диалог через /compact или начните свежую сессию вместо того, чтобы тащить длинную историю дальше.
  • Не путайте это с HTTP 402 billing_error — то пустой предоплаченный баланс. 429 — повторяемая пропускная способность. Для 402 пополните баланс; для 429 читайте Retry-After.
  • Если вам стабильно нужно больше пропускной способности, чем даёт ключ, ограничьте параллелизм или разнесите работу по ключам. Не ретрайте 402 как 429.

Похожие запросы

  • claude code api error 429
  • claude code rate limit error

Вопросы и ответы

API Error 429 в Claude Code означает, что предоплаченный баланс пуст?+
Нет. 429 — поминутная пропускная способность. Пустой предоплаченный баланс — HTTP 402 billing_error. На 429 читайте Retry-After. На 402 пополните баланс.
Ретраит ли Claude Code 429 сам?+
Да — он отступает и повторяет автоматически. Если ошибка держится, окно пополняется быстрее, чем расходуется, — обычно параллельными сессиями на том же ключе.
Почему один огромный промпт сам по себе вызывает 429?+
Лимиты считаются в токенах в минуту, и один переросший контекст может потратить весь минутный бюджет одним запросом.

Все ошибки Claude Code · Коды ошибок Claude API · Гайд по настройке

Пропустите сломанную настройку

apiToken.sale отдаёт стандартный Anthropic API — те же модели, те же SDK, один предоплаченный баланс. Направьте base URL вашего инструмента на него, и конфигурация с этой страницы заработает как написано.

Получить ключДокументация API