Claude Code лимиты: подписка, API и бюджет ключа
Claude Code: лимиты могут относиться к подписке, API Relay, размеру контекста или самому клиенту. При подключении к Relay вызовы оплачиваются с баланса Relay; подписка Claude не оплачивает эти запросы. Чтобы понять причину остановки, сначала проверьте источник авторизации и код ответа. Ошибка 402 требует проверки денег и лимитов ключа, 429 указывает на частоту или параллелизм. Перезапуск сессии не снимает эти ограничения и может заново отправить большой контекст.
Коротко
Разделяйте бюджет ключа, частоту запросов и размер контекста.
При 402 читайте код причины, при 429 ещё и заголовки ответа.
Пустое поле лимита ключа означает отсутствие этого ограничения.
Claude Code: лимиты подписки и API
Подписка внешнего продукта и ключ Relay относятся к разным способам оплаты. Вопрос limits shared with Claude Code требует сначала установить, каким способом выполнен вход. Правила общей квоты подписки нужно проверять у продавца подписки; нельзя переносить их на сторонний API.
Для Relay адрес и источник ключа проверьте в статусе клиента по инструкции подключения. Если новый вызов появился в журнале Relay, он прошёл через шлюз. Локальная оценка расходов клиента может отличаться от фактического списания, поэтому бюджет сверяйте по кабинету.
| Ограничение | Что оно измеряет | Что обычно меняют |
|---|---|---|
| Лимит расходов ключа | Сумму в USD за день, месяц или всё время | Бюджет ключа либо объём задачи |
| Запросы в минуту | Частоту по ключу и аккаунту | Паузы и число одновременно работающих клиентов |
| Одновременные потоки | Число открытых потоков и медиа | Параллелизм, закрытие ненужных запросов |
| Контекст | Объём входа, допустимый для модели | Передаваемые файлы и историю |
Численные пределы не угадывайте по тарифу другой компании. Они зависят от настроек аккаунта, ключа и модели. Действующие правила описаны в документации лимитов Relay.
Как задать бюджет ключа для Claude Code
Создайте отдельный ключ для редактора. В параметрах есть дневной, месячный и общий лимиты расходов в USD. Если поле оставлено пустым, этот предел не задан и ключ использует общий баланс аккаунта. Отдельный ключ отделяет историю и настройки, но не создаёт второй кошелёк.
Задайте также ограничение запросов в минуту, если нужно уменьшить частоту для клиента. Оно не заменяет денежный лимит: один большой запрос может стоить дороже нескольких коротких. Несколько ключей аккаунта делят общий счётчик запросов, поэтому выпуск ещё одного ключа не гарантирует устранение 429.
Перед запуском выберите модель в каталоге. Размер контекста и цена входных и выходных токенов влияют на характер задачи. Один ID для короткой проверки не означает, что нужно использовать эту же модель для каждого фонового вызова.
Что делать при HTTP 402
Прочитайте код ошибки в теле ответа, а не только фразу клиента «лимит исчерпан».
insufficient_balance: доступной суммы не хватает на резерв запроса либо баланс недоступен для списания. Проверьте баланс и выполняющиеся запросы: их резервы временно уменьшают доступные средства.key_limit_exceeded: резерв нового запроса не помещается в общий, дневной или месячный лимит ключа. Пополнение аккаунта этот лимит не сбрасывает. Измените предел или дождитесь обновления дневного либо месячного окна.new_account_limit: запрос ограничен правилами нового аккаунта. Уменьшите запрос или проверьте условия перехода к обычным ограничениям; приветственный бонус не заменяет оплаченные пополнения.
Эти отказы происходят до вызова модели. Повтор без изменения причины снова даст отказ. Механизм резерва и фактического списания описан в разделе о расходах. Не принимайте резерв за окончательную стоимость: после ответа расчёт идёт по фактическому использованию.
Как обработать Claude Code limits с кодом 429
Сохраните x-request-id, код ошибки, Retry-After и x-should-retry. Для rate_limited уменьшите частоту, для concurrency_limit проверьте число открытых потоков. У разных причин разные действия, хотя HTTP-статус совпадает.
Следуйте правилам повтора: повторять следует при x-should-retry: true, с указанной паузой и ограниченным числом попыток. Перезапуск нескольких сессий одновременно добавит запросы и может продлить проблему. Не заставляйте клиента автоматически переключаться на новый ключ, когда старый достиг денежного лимита.
Если клиентский интерфейс скрывает HTTP-заголовки, сохраните его сообщение и время сбоя. Уточните причину по журналу и руководству вашей версии. Отсутствие заголовка в окне чата не доказывает, что сервер его не отправлял.
Как сократить расход длинной сессии
Давайте конкретные файлы вместо всего репозитория. Ограничивайте вывод команд: большой лог тестов входит в следующий контекст, даже если ваш вопрос короткий. Для новой независимой задачи готовьте краткую сводку принятого решения, а не копируйте все промежуточные версии.
После задачи выберите ключ и период в журнале. Сверьте число вызовов, входные и выходные токены, модель и итоговую сумму. Если дорогими оказались повторы одного шага, уточните задание; если вход растёт, сократите передаваемые файлы. Увеличивать бюджет имеет смысл после такого разбора.
Claude Code: лимиты Relay общие с подпиской Claude?
Нет. Запросы к Relay оплачиваются и ограничиваются в Relay. Правила квоты подписки относятся к соответствующему внешнему сервису.
Пополнение уберёт key_limit_exceeded?
Нет. Оно увеличивает баланс аккаунта. У ключа нужно проверить и при необходимости изменить собственные пределы расходов.
Почему новый ключ тоже получает 429?
Кроме счётчика ключа есть общий счётчик аккаунта и ограничения параллелизма. Выпуск другого ключа не меняет эти причины.
Какой универсальный лимит сообщений у Claude Code?
Единого числа для всех способов подключения нет. Для API проверяйте настройки Relay и объём запросов; для подписки смотрите правила её продавца.