Ошибка 429 Resource exhausted в терминале Gemini CLI означает, что исчерпана одна из квот — поминутная или суточная, и дальнейшие запросы к модели будут отклоняться до сброса счётчика. Это штатное поведение сервиса, а не сбой установки: инструмент продолжает работать, но API временно отказывает в обслуживании.
В этой статье разберём, какие именно лимиты действуют в Gemini CLI, чем отличается бесплатный доступ через личный аккаунт Google от платного API-ключа, и как организовать работу, чтобы упираться в квоты как можно реже. Отдельно рассмотрим типовые ошибки и способы диагностики.
Какие лимиты действуют в Gemini CLI
Gemini CLI — это консольный агент от Google, который отправляет ваши запросы в модели семейства Gemini. Квоты зависят от способа аутентификации. При входе через личный аккаунт Google действует бесплатный уровень: по официальной документации он включает порядка 60 запросов в минуту и 1000 запросов в сутки. Этих значений достаточно для обычной интерактивной работы, но агентные сценарии с циклами инструментов могут расходовать квоту заметно быстрее, чем кажется.
Важно понимать: один ваш вопрос в чате не равен одному запросу к API. Агент может выполнять несколько обращений к модели подряд — читать файлы, уточнять контекст, вызывать инструменты. Поэтому суточный лимит иногда «съедается» за пару часов активной сессии.
⚠️ Внимание: точные значения квот Google может пересматривать. Актуальные цифры для вашего аккаунта и проекта проверяйте в официальной документации Gemini CLI и в консоли Google AI Studio / Google Cloud — не полагайтесь на данные из сторонних статей.
Бесплатный доступ против платного API-ключа
Способ авторизации напрямую определяет потолок лимитов. Ниже — сравнение основных вариантов подключения.
| Способ доступа | Основа квот | Кому подходит |
|---|---|---|
| Личный аккаунт Google | Бесплатный уровень: поминутный и суточный лимиты | Личное использование, обучение |
| API-ключ Gemini API (AI Studio) | Квоты уровня Free или Paid по тарифу проекта | Разработчики, автоматизация |
| Vertex AI (Google Cloud) | Квоты проекта, биллинг по факту использования | Команды и продакшен-нагрузки |
| Code Assist / корпоративные лицензии | Лимиты по условиям подписки | Организации |
Переключиться на API-ключ можно, задав переменную окружения перед запуском:
export GEMINI_API_KEY="ваш_ключ"
gemini
Если ключ задан, CLI использует квоты вашего проекта в AI Studio, а не бесплатный лимит личного аккаунта. Это основной легальный способ поднять потолок запросов.
Почему лимит исчерпывается быстрее, чем ожидалось
Чаще всего пользователи недооценивают, сколько обращений к модели генерирует одна задача. Возможные причины ускоренного расхода квоты:
- 🔁 Агентные циклы — каждая итерация «подумал → вызвал инструмент → подумал снова» это отдельный запрос к API.
- 📁 Большой контекст — чтение объёмных файлов и длинная история диалога увеличивают стоимость каждого вызова.
- ⚡ Параллельные сессии — несколько открытых терминалов с Gemini CLI делят одну квоту аккаунта.
- 🤖 Автоматизация — скрипты и хуки, вызывающие CLI в цикле, способны исчерпать суточный лимит за минуты.
- 🔄 Повторные попытки — сам CLI может ретраить неудачные запросы, что тоже расходует квоту.
Что делать при ошибке 429
Код 429 говорит о превышении частоты запросов. Диагностика простая: если ошибка появляется редко и пропадает через минуту — сработал поминутный лимит; если CLI отказывает стабильно в течение часов — вероятно, исчерпана суточная квота.
Порядок действий при упоре в лимит:
- ⏳ Подождите 1–2 минуты и повторите запрос — поминутное окно сбрасывается автоматически.
- 🧭 Сократите контекст: начните новую сессию командой
/clearили перезапустите CLI. - 🔑 Проверьте, какой способ авторизации активен, командой
/authвнутри сессии. - 📊 Посмотрите текущее потребление квоты в консоли Google AI Studio или Google Cloud, если используется API-ключ.
☑️ Снижаем расход лимитов Gemini CLI
⚠️ Внимание: не пытайтесь обходить квоты созданием множества аккаунтов или ротацией ключей — это нарушает условия использования сервиса и может привести к блокировке. Корректный путь один: переход на платный уровень или снижение расхода запросов.
Как снизить расход запросов без потери качества
Экономия квоты — это в первую очередь дисциплина работы с контекстом. Формулируйте задачу конкретно с первого сообщения: агенту не придётся делать лишние уточняющие итерации, каждая из которых стоит запрос. Если работаете с кодом, указывайте конкретные файлы и директории, а не просите «посмотреть весь проект».
Для тяжёлых пакетных задач имеет смысл разбивать работу на этапы и выполнять их в разные сессии. Так проще контролировать расход и при необходимости переносить часть задач на следующие сутки, когда суточная квота обнулится. Суточный лимит бесплатного уровня сбрасывается автоматически — никаких действий для его восстановления предпринимать не нужно.
Как устроены квоты Gemini API под капотом
Лимиты в Gemini API обычно считаются по нескольким осям одновременно: запросы в минуту (RPM), токены в минуту (TPM) и запросы в сутки (RPD). Срабатывание любой из осей приводит к отказу. На платных уровнях пороги выше, а при росте нагрузки можно запросить увеличение квот через консоль Google Cloud. Точные значения для вашего проекта отображаются в разделе квот консоли.
Когда стоит переходить на платный уровень
Если вы регулярно исчерпываете суточную квоту бесплатного доступа и паузы мешают работе — это прямой сигнал к переходу на API-ключ с включённым биллингом. Вам нужно создать проект в Google AI Studio или Google Cloud, получить ключ и подключить его через переменную окружения GEMINI_API_KEY, как показано выше.
Для команд и продакшен-сценариев логичнее рассмотреть Vertex AI: там квоты управляются на уровне проекта, доступен мониторинг потребления и оплата по факту использования. Перед подключением сверьтесь с актуальным прайсингом на официальном сайте Google — тарифы и условия периодически меняются, и приводить здесь конкретные цены было бы небезопасно.
Частые вопросы о лимитах Gemini CLI
Сколько запросов в день даёт бесплатный доступ?
По официальной документации, при входе через личный аккаунт Google действует порядка 1000 запросов в сутки и 60 запросов в минуту. Значения могут пересматриваться — проверяйте актуальные данные в документации Gemini CLI.
Сбрасывается ли суточный лимит автоматически?
Да, суточная квота обновляется автоматически по прошествии расчётного периода. Ручных действий не требуется, достаточно дождаться сброса и продолжить работу.
Почему один вопрос расходует несколько запросов?
Gemini CLI работает как агент: для ответа он может несколько раз обращаться к модели — анализировать контекст, вызывать инструменты, уточнять результаты. Каждое такое обращение учитывается в квоте отдельно.
Поможет ли VPN или смена аккаунта обойти лимит?
Нет, и пытаться не стоит: ротация аккаунтов нарушает условия использования сервиса и грозит блокировкой. Легальные варианты — дождаться сброса квоты или перейти на платный API-ключ.
Где посмотреть текущее потребление квоты?
Внутри сессии используйте команду /stats. При работе через API-ключ детальная статистика доступна в консоли Google AI Studio или Google Cloud в разделе квот вашего проекта.