«Request rate limited». «Token limit reached». «Concurrency exceeded». Если вы активно пользуетесь Claude Code, эти сообщения вам слишком хорошо знакомы. В Claude Code несколько уровней лимитов, и без их понимания продуктивно работать не получится.
В этом руководстве разобраны все типы лимитов Claude Code, приведены временные и постоянные решения и показано, как управление квотами в TeamoRouter помогает работать без перерывов.
Типы лимитов Claude Code
1. Лимиты запросов
Лимиты запросов ограничивают, сколько API-запросов можно отправить за заданный промежуток времени:
| Тип лимита | Free/Tier | Tier 1 | Tier 2 | Tier 3 |
|---|---|---|---|---|
| RPM (запросов в минуту) | 5 | 20 | 100 | 500 |
| TPM (токенов в минуту) | 10K | 100K | 500K | 5M |
| RPD (запросов в день) | 100 | 500 | 5K | 50K |
Значения приблизительные — фактические лимиты зависят от статуса аккаунта и истории использования.
2. Ограничения на токены
Лимиты токенов на один запрос:
| Модель | Макс. входных токенов | Макс. выходных токенов |
|---|---|---|
| Claude Opus 4.8 | 200K | 8K-16K |
| Claude Sonnet 4.7 | 200K | 8K-16K |
| Claude Haiku 4.5 | 200K | 8K-16K |
3. Лимиты параллельности
Одновременные запросы на один API-ключ:
- По умолчанию: 2–5 параллельных запросов
- Пользователи с большими объёмами: можно запросить 10–20
- Enterprise: по договорённости
4. Лимиты на уровне аккаунта
- Месячный лимит расходов: зависит от уровня верификации
- Требования к балансу: для некоторых операций нужен достаточный баланс
- Региональные ограничения: в некоторых регионах доступ может быть ограничен
Типичные сценарии срабатывания
Сценарий 1: интенсивная разработка
Одновременный запуск нескольких агентских задач или CI/CD-пайплайнов может упереться в лимиты RPM/TPM.
Признак ошибки: 429 Too Many Requests или rate_limit_error.
Сценарий 2: анализ большой кодовой базы
Отправка очень длинного контекста (например, при анализе всей кодовой базы) может упереться в ограничения на токены.
Признак ошибки: ошибки, связанные с max_tokens.
Сценарий 3: общий ключ на всю команду
Когда несколько человек используют один API-ключ, лимиты параллельности срабатывают часто.
Признак ошибки: overloaded_error или engine_overloaded.
Временные решения
1. Подождать
После срабатывания лимита подождите от 30 секунд до нескольких минут — самый простой, но наименее эффективный подход.
2. Отправлять пакетами
Разбейте крупные задачи на небольшие пакеты с паузами между ними:
# Плохо: отправлять всё разом
claude code --analyze entire-codebase/
# Хорошо: обрабатывать модуль за модулем
for module in src/utils src/services src/components; do
claude code --analyze "$module"
sleep 5 # пауза
done
3. Оптимизировать промпты
- Сократите системный промпт
- Включайте только необходимый контекст
- Держите историю диалога короткой
- Уберите лишние примеры
4. Сменить модель
Если модель упёрлась в лимит, попробуйте менее загруженную:
- Лимит на Opus 4.8 → переключитесь на Sonnet 4.7
- Лимит на Sonnet 4.7 → переключитесь на Haiku 4.5
Долгосрочное решение 1: маршрутизация через TeamoRouter
TeamoRouter предлагает единое управление квотами, которое решает проблему лимитов в корне:
Единое управление квотами
Объедините несколько API-ключей в общий пул. Когда один ключ упирается в лимит, TeamoRouter автоматически переключается на другой.
Формирование потока запросов
- Сглаживание частоты: запросы равномерно распределяются во времени
- Очередь с приоритетами: критичные запросы идут первыми, некритичные ждут в очереди
- Умные повторы: экспоненциальная задержка после срабатывания лимита
Кэш сокращает число вызовов
Доля попаданий в кэш 99.3% означает, что большинство повторяющихся запросов вообще не доходит до Anthropic API, — а значит, вероятность упереться в лимиты резко снижается.
Шаги настройки
- Добавьте несколько API-ключей в консоли TeamoRouter
- Настройте приоритеты и политику ротации
- Задайте верхние пределы частоты запросов
- Настройте бюджет и оповещения о расходе
- Укажите TeamoRouter в качестве Base URL для Claude Code
Долгосрочное решение 2: балансировка нагрузки между несколькими ключами
В TeamoRouter встроена балансировка нагрузки между несколькими ключами:
| Функция | Описание |
|---|---|
| Автоматический round-robin | Запросы равномерно распределяются по ключам |
| Приоритетная маршрутизация | Сначала основной ключ, при лимите — резервные |
| Проверки состояния | Автоматическое исключение неработоспособных ключей |
| Статистика использования | Расход по каждому ключу с первого взгляда |
Пример конфигурации
В консоли TeamoRouter:
keys:
- key: sk-ant-xxx1
weight: 3
tier: primary
daily_limit: $100
- key: sk-ant-xxx2
weight: 1
tier: secondary
daily_limit: $50
- key: sk-ant-xxx3
weight: 1
tier: fallback
daily_limit: $30
Управление квотами в команде
Общий пул квот
- Один командный аккаунт с несколькими участниками
- Единый пул квот
- Отдельные подквоты для каждого участника
Отчёты об использовании
- По участникам, проектам или периодам
- Автоматически формируемые еженедельные и ежемесячные отчёты
- Оповещения в реальном времени при аномальном расходе
Контроль бюджета
- Общий лимит бюджета на уровне команды
- Индивидуальные квоты для каждого участника
- Автоматическое ограничение скорости при превышении порогов
FAQ
Можно ли запросить повышение лимитов запросов Claude Code?
Да — обратитесь в поддержку Anthropic, описав свой сценарий и потребности. Корпоративным пользователям повышенные лимиты обычно дают охотнее.
Как работает балансировка нагрузки между ключами в TeamoRouter?
Добавьте несколько API-ключей в консоли TeamoRouter и задайте им веса и приоритеты. Балансировкой нагрузки и автоматическим переключением на резервные ключи система занимается сама. Подробности — в руководстве по настройке Claude Code.
Как командам управлять квотами Claude Code?
Создайте командный аккаунт в TeamoRouter, настройте единый пул квот с лимитами для каждого участника и контролируйте расход по отчётам об использовании.
Помогает ли кэширование при проблемах с лимитами запросов?
Да. Кэширование сокращает число реальных вызовов Anthropic API, а значит, снижает вероятность упереться в лимиты запросов. Доля попаданий в кэш 99.3% в TeamoRouter кардинально уменьшает объём API-вызовов.