Обзор и отзыв на Gemini CLI

Gemini CLI — разработанный Google терминальный ИИ-агент с открытым исходным кодом. Он даёт доступ к моделям Gemini из командной строки, работает с файлами и shell-командами, подключает MCP-серверы и управляет подтверждениями инструментов. Для большинства индивидуальных пользователей проще войти с аккаунтом Google; в headless-среде без сохранённой OAuth-сессии используют API-ключ Gemini или Vertex AI.

Что умеет Gemini CLI

По документации, встроенные инструменты поддерживают операции с файлами, запуск shell-команд, загрузку веб-страниц и поиск с Google Search grounding. CLI работает в интерактивном и неинтерактивном режимах, а вывод доступен как обычный текст, JSON или потоковый JSON.

Агент может изменять файлы и выполнять команды. Подтверждения, политики и sandboxing снижают риск таких действий, но не устраняют его полностью.

Требования и установка

Google рекомендует macOS 15+, Windows 11 24H2+ или Ubuntu 20.04+, Node.js 20+, Bash, Zsh либо PowerShell и постоянное подключение к интернету. Это рекомендуемая конфигурация, а не обещание поддержки более старых систем. Доступность зависит также от страны и типа аккаунта.

Глобальная установка через npm:

npm install -g @google/gemini-cli

Разовый запуск без постоянной установки:

npx @google/gemini-cli

Также предусмотрены Homebrew, MacPorts и Anaconda. Stable устанавливается по умолчанию; preview и nightly дают более ранний доступ к изменениям, но могут быть менее стабильными.

Авторизация: три сценария

Личный аккаунт Google

Для большинства индивидуальных пользователей API-ключ не нужен, а проект Google Cloud обычно не требуется. OAuth-вход открывается в браузере на машине, связанной с терминалом. Корпоративным, учебным и Workspace-аккаунтам, а также пользователям некоторых лицензий Gemini Code Assist может понадобиться проект Google Cloud.

API-ключ Gemini

Ключ задаётся через переменную окружения и подходит для headless-среды, где нельзя пройти новый OAuth-вход. Это отдельный способ авторизации со своими моделями, квотой и тарификацией: лимиты входа с аккаунтом Google к нему не относятся.

Vertex AI

Для Vertex AI нужен проект Google Cloud с включённым Vertex AI API, а также параметры проекта и региона. В headless-среде без заранее сохранённой OAuth-сессии используют API-ключ либо Vertex AI через переменные окружения.

Квоты и платные режимы

Лимиты ниже проверены 5 августа 2026 года. Они зависят от способа авторизации и могут меняться.

Вариант	Лимит или принцип оплаты	Что учитывать
Личный аккаунт Google / Code Assist Individual	До 1 000 запросов к модели на пользователя в день	Действуют также ограничения в минуту и по доступности сервиса
Неоплачиваемый API-ключ Gemini	До 250 запросов в день, только Flash	README репозитория указывает другую квоту; перед использованием нужно сверить профильную страницу квот
Vertex AI Express Mode	До 90 дней без включения биллинга	Модели и квоты зависят от аккаунта
Google AI Pro / Code Assist Standard	До 1 500 запросов к модели в день	Фиксированная подписка; цена зависит от региона
Google AI Ultra / Code Assist Enterprise / Workspace AI Ultra	До 2 000 запросов к модели в день	Условия зависят от лицензии и аккаунта
Оплачиваемые Gemini API и Vertex AI	Pay-as-you-go по модели и токенам	Квота и расход переменные; использование можно отслеживать командой /stats

Не переносите эти лимиты на планы с похожими названиями: совместимость конкретной подписки с Gemini CLI нужно проверять отдельно.

Модели и автоматическая маршрутизация

По состоянию на 5 августа 2026 года режим Auto направляет простые запросы в Gemini 2.5 Flash, а сложные — в Gemini 3 Pro при наличии доступа или в Gemini 2.5 Pro. Gemini 3.1 Pro Preview разворачивается постепенно и доступен не всем. Фактическую модель можно проверить командой /model.

При исчерпании лимита возможен переход на запасную модель. При перегрузке Gemini 3 Pro CLI предлагает повторить запрос или перейти на Gemini 2.5 Pro. Поэтому режим Auto не гарантирует одну модель для всех запросов.

MCP и внешние инструменты

Gemini CLI подключает MCP-серверы по Stdio, SSE и Streamable HTTP. Можно разрешить только нужные инструменты или исключить отдельные. При запуске дочернего процесса CLI удаляет из наследуемого окружения чувствительные переменные, кроме явно переданных пользователем.

Параметр trust по умолчанию выключен. Значение trust=true пропускает подтверждения всех вызовов конкретного MCP-сервера, поэтому его стоит включать только после проверки сервера и доступных ему инструментов. OAuth для удалённого MCP требует локального браузера и callback; в SSH, контейнере и другой headless-среде без поддержки браузера этот сценарий не работает.

Подтверждения и policy engine

Policy engine разрешает действие, запрещает его или запрашивает подтверждение. В неинтерактивном режиме запрос подтверждения превращается в запрет, что важно учитывать в CI/CD.

• default — большинство инструментов записи требует подтверждения;
• autoEdit — часть операций изменения файлов одобряется автоматически;
• plan — строгий режим только для чтения;
• yolo — все инструменты одобряются автоматически.

Для незнакомого репозитория безопаснее начинать с default или plan. Режим yolo отключает подтверждения и не подходит как настройка по умолчанию. По состоянию на дату проверки проектные Workspace policies в документации отмечены как неработающие, поэтому рассчитывать на них как на механизм защиты нельзя.

Sandboxing

Изоляцию можно включить флагом, переменной окружения или через settings.json. Документация перечисляет macOS Seatbelt, Docker или Podman, Windows Native Sandbox, Linux gVisor/runsc и экспериментальный LXC/LXD. По умолчанию песочница имеет доступ к текущей рабочей папке; sandbox expansion запрашивает дополнительные права на конкретный запуск.

Sandboxing уменьшает последствия опасной команды, но не даёт абсолютной защиты. Графические приложения в песочнице могут не работать. У Windows Native Sandbox есть отдельный побочный эффект: созданные или изменённые файлы могут сохранить низкий уровень целостности после завершения сессии.

Лицензия и условия сервисов Google

Исходный код Gemini CLI распространяется по Apache License 2.0. Лицензия регулирует использование программы, но не отменяет условия и правила конфиденциальности облачного сервиса, через который выполняются запросы. Они различаются для аккаунта Google, Gemini API и Vertex AI.

Учётные данные OAuth Gemini CLI нельзя считать универсальным способом доступа к сервисам Google через сторонние программы. Документация предупреждает, что такой прямой доступ через стороннее ПО может нарушать применимые условия и политики.

Кому подойдёт Gemini CLI

Gemini CLI подходит разработчикам, которые работают в терминале, используют экосистему Gemini и готовы контролировать права агента. Вход с аккаунтом Google упрощает старт, а API-ключ и Vertex AI подходят для headless- и облачных сценариев. Команде стоит заранее проверить региональную доступность, способ авторизации, правила обработки данных, расходы и политику запуска инструментов.

Мнение автора

Gemini CLI подходит разработчикам, которым нужен терминальный агент в экосистеме Google. Вход с личным аккаунтом снижает порог старта: обычно не нужны API-ключ и проект Google Cloud. Открытый код, MCP, policy engine и несколько вариантов sandboxing дают инструменты для управления доступом к файлам и командам.

Главный компромисс — разные условия для аккаунта Google, API-ключа Gemini и Vertex AI. У этих способов авторизации отличаются квоты, модели, требования к облачному проекту и оплата. Для локальной работы разумно начать с режима default или plan. Для CI/CD нужно отдельно выбрать способ авторизации, контролировать расход и выдать только необходимые права. Режим yolo и trust=true для MCP не подходят как настройки по умолчанию.

Для задач в терминале используйте Google Gemini вместе с Gemini CLI: веб-сервис подходит для диалога и работы с файлами, а CLI переносит агентный сценарий в командную строку и репозиторий.