Гайды

VSCode Gemini CLI бесплатный: лимиты и вход

9 октября 2026 · 13 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 9 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Бесплатный вход в Gemini CLI изменился: на текущей странице Plans сказано, что для бесплатных пользователей и подписчиков Google One Gemini CLI заменён Antigravity CLI с 18 июня 2026 года. Старый файл quota-and-pricing описывает прежний вход через Google с 1000 запросами в день; это не гарантия текущего доступа. Для бесплатного Gemini API-ключа тот же файл указывает 250 запросов в день только к Flash.

Мы скачали подборку результатов веб-поиска по запросу «gemini cli бесплатный»: текст отдали 9 из 10. В VSCode можно открыть встроенный терминал в папке проекта и выполнять CLI-команды там; право доступа определяется выбранной авторизацией.

Что такое Gemini CLI и где проходят границы бесплатного доступа

Gemini CLI — открытый ИИ-агент для терминала. В репозитории gemini-gsa/gemini-cli он описан как open-source AI agent, который приносит возможности Gemini прямо в командную строку и даёт короткий путь от запроса к модели. Лицензия — Apache 2.0. Это инструмент для разработчиков, которые работают в терминале.

Документация google-gemini/gemini-cli в разделе quota-and-pricing прямо говорит: проект предлагает щедрый бесплатный уровень, покрывающий многие сценарии индивидуальных разработчиков. Для корпоративного или профессионального использования и при потребности в увеличенной квоте доступны варианты, зависящие от типа аккаунта аутентификации.

Сохранённый quota-and-pricing описывает прежний Google-вход через Code Assist for individuals и бесплатный Gemini API-ключ. Актуальный баннер Plans сообщает о замене Gemini CLI на Antigravity CLI для бесплатных пользователей и Google One с 18 июня 2026 года. Бесплатный API-ключ в таблице квот ограничен моделью Flash.

Границы продукта заданы самим форматом. Это терминальный агент: он читает файлы, выполняет команды оболочки, ходит в веб. Бесплатный доступ ограничен квотой запросов к модели, при этом набор функций остаётся полным. Встроенные инструменты — поиск Google, файловые операции, команды shell, загрузка веб-страниц — перечислены в описании репозитория gemini-gsa/gemini-cli как часть базового набора.

Отдельно стоит сказать про расширяемость. Поддержка MCP (Model Context Protocol) для пользовательских интеграций заявлена в том же описании. Это значит, что бесплатный режим можно наращивать собственными подключениями. Про плагины у нас есть отдельный разбор: Плагины для Gemini CLI, которые сделают работу с ИИ-агентом проще.

По старой таблице запросы Google-входа распределялись по семейству моделей Gemini. Для бесплатного API-ключа в той же таблице указана только Flash. Формулировка о распределении не доказывает отсутствия ручного выбора модели.

Подтверждённые условия доступа и где смотреть актуальные требования

Источник актуальных требований — файл quota-and-pricing.md в репозитории google-gemini/gemini-cli на GitHub и его зеркало на google-gemini.github.io. Документация прямо указывает: статья описывает конкретные квоты и цены, применимые к Gemini CLI при разных методах аутентификации. Это и есть первоисточник, к которому стоит возвращаться при изменении условий.

Второй источник — страница Plans на geminicli.com. Документация quota-and-pricing отсылает к ней за высокоуровневым сравнением доступных подписок и подбором подходящей квоты. На странице Plans перечислены уровни: Free, Google AI Pro, Google AI Ultra, Google Developer Program, AI Studio, Vertex AI. Там же есть блок для тех, кто уже подписан на Google AI.

Условия бесплатного доступа зависят от типа авторизации. Документация формулирует это так: бесплатное использование управляется лимитами, которые зависят от типа авторизации. Это ключевая мысль: один и тот же инструмент даёт разные квоты в зависимости от того, как вы вошли.

Третий ориентир — страница релизов google-gemini/gemini-cli. Проект выпускает сборки по расписанию. Preview-релизы публикуются еженедельно по вторникам и не проходят полную проверку, могут содержать регрессии. Stable-релизы выходят по вторникам как полное продвижение прошлого preview плюс исправления. Nightly-сборки публикуются ежедневно со всеми изменениями основной ветки.

Практический вывод: требования к бесплатному доступу меняются вместе с релизами. Сверяйтесь с quota-and-pricing перед тем, как планировать нагрузку, и смотрите на канал, с которого установлена версия. Если вы на preview или nightly, поведение может отличаться от stable.

Документированный порядок действий: установка и первый запуск

Установка описана в репозитории gemini-gsa/gemini-cli. Основной способ — npm:

npm install -g @google/gemini-cli

Для macOS и Linux есть Homebrew:

brew install gemini-cli

Для macOS через MacPorts:

sudo port install gemini-cli

Каналы установки задаются тегом. Preview:

npm install -g @google/gemini-cli@preview

Stable:

npm install -g @google/gemini-cli@latest

Nightly:

npm install -g @google/gemini-cli@nightly

После установки запустите gemini. Документация CLI-справочника описывает базовые режимы. Интерактивный REPL стартует без аргументов. Неинтерактивный запрос выполняется через флаг -p:

gemini -p "summarize README.md"

Запрос с продолжением в интерактивном режиме:

gemini "explain this project"

Обработка содержимого из конвейера:

cat file.txt | gemini -p "summarize"

Запуск с продолжением интерактива:

gemini -i "What is the purpose of this project?"

Продолжение последней сессии:

gemini -r "latest" "query"

Продолжение сессии по идентификатору:

gemini -r "abc123" "Finish this PR"

Справочник CLI описывает позиционный аргумент как запрос: по умолчанию он открывает интерактивный режим в TTY, а флаг -p или --prompt включает неинтерактивное выполнение. Внутри REPL доступны интерактивные команды — например, перезагрузка обнаруженных навыков с диска.

Для Gemini CLI сначала установите пакет и запустите gemini, затем настройте подходящий действующий способ авторизации. Для бесплатного API-доступа используйте Gemini API-ключ с учётом квоты Flash. Бесплатный Google-вход из старого руководства был заменён Antigravity CLI, как сообщает Plans; условия нового инструмента проверяйте отдельно. Для организационной лицензии Code Assist старое руководство дополнительно требует проект Google Cloud.

Оригинальный учебный пример и критерии самостоятельной проверки

Возьмём учебную задачу для самостоятельной проверки: разобрать незнакомый репозиторий и получить карту его структуры. Это предложенное редакцией упражнение; фактический тест редакции здесь не заявлен.

Шаг первый. Откройте терминал в корне проекта и запустите интерактивный режим командой gemini.

Шаг второй. Дайте запрос на обзор структуры. Пример формулировки — ниже в блоке промптов.

Шаг третий. Попросите выделить точки входа: файлы, с которых начинается выполнение, и конфигурацию сборки.

Шаг четвёртый. Попросите список зависимостей и их назначение в двух-трёх словах на каждую.

Шаг пятый. Сохраните ответ в файл и сравните с тем, что видите сами через ls и чтение README.

Критерии самостоятельной проверки. Первый: агент назвал реально существующие файлы. Проверяется командой ls по названным путям. Второй: точки входа совпадают с тем, что написано в README проекта. Третий: список зависимостей совпадает с содержимым файла манифеста. Четвёртый: ни один ответ не потребовал выхода за бесплатную квоту — счётчик запросов остаётся в пределах дневного лимита.

Это упражнение укладывается в бесплатный уровень: несколько запросов на один проект. Для сравнения, медиана объёма читаемого текста в нашем срезе — 1743 слова, и такой разбор не приближается к дневному потолку.

Смежные варианты: что выбирать под задачу

Бесплатный доступ — не единственный путь. Документация quota-and-pricing делит варианты на три категории. Free Usage — для экспериментов и лёгкого использования. Paid Tier с фиксированной ценой — для индивидуальных разработчиков или предприятий, которым нужны более щедрые дневные квоты и предсказуемые расходы. Pay-As-You-Go — самый гибкий вариант для профессионального использования, длительных задач и полного контроля над потреблением.

Внутри платного уровня документация перечисляет отдельные позиции: Code Assist Standard, Code Assist Enterprise, Pay-as-you-go. Для организаций есть вход через Vertex AI в обычном режиме, для индивидуальных пользователей — через Vertex AI в Express Mode. Отдельная строка — планы Gemini for Workspace.

Страница Plans на geminicli.com добавляет уровни Google AI Pro, Google AI Ultra, Google Developer Program и AI Studio. Там же — блок для действующих подписчиков Google AI.

Для знакомства с Gemini CLI можно рассмотреть бесплатный API-ключ с квотой Flash. Пользователям бесплатного Google-входа и Google One страница Plans указывает Antigravity CLI. Для профессиональной нагрузки изучите текущие организационные лицензии и оплату API. Про возможности агента для разработчиков у нас есть отдельный материал: ИИ-агент Gemini CLI: возможности для разработчиков.

Типичные проблемы и проверяемые способы диагностики

Первая проблема — исчерпание дневной квоты. Для бесплатного Gemini API-ключа сохранённый quota-and-pricing указывает 250 запросов в день только к Flash и ограничения по частоте. Прежние 1000 запросов Google-входа не следует считать текущей гарантией: Plans сообщает о замене для бесплатных пользователей и Google One. Проверяйте квоты действующего способа входа перед нагрузкой.

Вторая проблема — ошибки аутентификации. В списке изменений релизов google-gemini/gemini-cli есть исправление, которое предотвращает бесконечные циклы верификации и повторных попыток OAuth. Если вход зацикливается, обновитесь до свежего релиза: исправление уже влито в основную ветку. Проверить версию можно через страницу релизов.

Третья проблема — поведение в недоверенных папках. В релизах есть исправление, которое принудительно включает настройки рабочего пространства только для чтения в недоверенных папках. Если агент отказывается писать в директорию, проверьте, не помечена ли она как недоверенная.

Четвёртая проблема — дублирование ответов инструментов при возобновлении сессии. В changelog есть исправление, которое убирает дублирующиеся ходы ответов инструментов при возобновлении сессий. Если видите повторы, обновите версию.

Пятая проблема — потеря истории сессии при быстром выходе. В релизах описано исправление, предотвращающее удаление истории возобновлённой сессии при быстром выходе. Для диагностики проверьте, воспроизводится ли потеря на последней stable-сборке.

Шестая проблема — лишние очистки терминала при разворачивании через Ctrl+O. Это тоже закрыто исправлением в changelog. Общий порядок диагностики: определить версию и канал, сверить с последними релизами, обновиться до stable, воспроизвести проблему заново.

Готовый промпт для разбора проекта

Промпт, чтобы получить карту незнакомого репозитория и точки входа.

Ты — ассистент по разбору кода в терминале. Изучи текущий проект и дай отчёт по структуре.

Сделай следующее:
1. Перечисли основные директории и объясни назначение каждой в одном предложении.
2. Назови файлы точек входа и файлы конфигурации сборки.
3. Выпиши зависимости из манифеста и укажи назначение каждой в двух-трёх словах.
4. Отметь места, где логика проекта неочевидна и требует чтения исходников.
5. Дай краткий итог: с чего начать чтение кода, если нужно внести правку в [ваша область].

Формат ответа: заголовки по пунктам, внутри — списки. Без вступлений.

Что менять под себя: в пункте 5 подставьте свою область — например, обработку запросов, слой работы с файлами, конфигурацию. Если проект на конкретном языке, добавьте его название в первую строку.

Вариации той же задачи:

Промпт, чтобы найти причину падения теста.

Ты — ассистент по отладке. В проекте падает тест [название теста или файла].

Сделай следующее:
1. Найди файл теста и связанный с ним код.
2. Опиши, что тест проверяет.
3. Найди места, где поведение кода может расходиться с ожиданием теста.
4. Предложи порядок проверки гипотез от самой вероятной к менее вероятной.
5. Для каждой гипотезы укажи команду или файл, которые её подтвердят или опровергнут.

Формат: нумерованный список гипотез, под каждой — способ проверки.

Промпт, чтобы подготовить описание изменений для ревью.

Ты — ассистент по подготовке ревью. Посмотри изменения в текущей ветке относительно [базовая ветка].

Сделай следующее:
1. Сгруппируй изменения по смыслу: новая функциональность, исправления, рефакторинг.
2. Для каждой группы дай краткое описание в одном-двух предложениях.
3. Отметь изменения, которые затрагивают публичные интерфейсы.
4. Перечисли файлы, которые стоит прочитать первыми при ревью.
5. Укажи места, где не хватает тестов.

Формат: разделы по группам, внутри — списки файлов с пояснениями.

Промпт, чтобы разобрать незнакомую библиотеку.

Ты — ассистент по изучению зависимостей. Возьми библиотеку [название] из манифеста проекта.

Сделай следующее:
1. Опиши, какую задачу она решает в этом проекте.
2. Найди все места в коде, где она используется.
3. Объясни типовой сценарий вызова на примере из проекта.
4. Отметь нестандартные способы использования, если они есть.
5. Предложи, что прочитать в первую очередь, чтобы уверенно её применять.

Формат: разделы по пунктам, внутри — короткие абзацы.

Промпт, чтобы составить план правки.

Ты — ассистент по планированию изменений. Нужно внести правку: [описание задачи].

Сделай следующее:
1. Найди файлы, которые придётся изменить.
2. Опиши порядок правок от независимых к зависимым.
3. Отметь места, где правка может затронуть другие части проекта.
4. Предложи, какие тесты добавить или обновить.
5. Дай чек-лист проверки перед коммитом.

Формат: нумерованный план, под каждым пунктом — конкретные файлы.

Частые вопросы

Gemini CLI бесплатный или платный?

Plans сообщает о замене Gemini CLI на Antigravity CLI для бесплатных пользователей и Google One с 18 июня 2026 года. В старом quota-and-pricing Google-вход имел квоту 1000 запросов в день. Бесплатный Gemini API-ключ там имеет 250 запросов в день только к Flash; актуальные условия выбранного способа проверяйте перед использованием.

Сколько запросов в день даёт бесплатный режим?

Plans сообщает о замене Gemini CLI на Antigravity CLI для бесплатных пользователей и Google One с 18 июня 2026 года. В старом quota-and-pricing Google-вход имел квоту 1000 запросов в день. Бесплатный Gemini API-ключ там имеет 250 запросов в день только к Flash; актуальные условия выбранного способа проверяйте перед использованием.

Как установить Gemini CLI на Windows?

Основной способ установки — через npm командой npm install -g @google/gemini-cli. Для macOS и Linux документация приводит Homebrew и MacPorts. Для Windows среда npm остаётся документированным путём. После установки запустите gemini и выберите способ входа. Каналы preview, stable и nightly задаются тегом при установке.

Gemini CLI работает по-русски?

Интерфейс команд и флагов описан в CLI-справочнике на английском. Запросы к модели можно формулировать по-русски: агент принимает позиционный аргумент или флаг -p с произвольным текстом. Язык ответа зависит от формулировки запроса. Отдельного переключателя языка в документированных командах нет.

Чем Gemini CLI отличается от других терминальных агентов?

Документация проекта описывает его как открытый ИИ-агент с лицензией Apache 2.0, который даёт прямой путь от запроса к модели Gemini. Он поддерживает MCP для пользовательских интеграций и работает с встроенными инструментами: поиском Google, файловыми операциями, командами оболочки, загрузкой веб-страниц. Бесплатный уровень привязан к типу авторизации.