Перейти к содержимому

Gemini CLI: агент Google в терминале

Gemini CLI даёт моделям Google инструменты для работы в каталоге проекта: чтение файлов, правки, команды и поиск. Это харнес (agent harness) с интерфейсом командной строки (command-line interface, CLI), который можно использовать для интерактивных задач и запусков из скриптов.

Его имеет смысл включить в сравнение, если команда использует Gemini или инфраструктуру Google Cloud. Открытый исходный код инструмента не означает локальное выполнение модели: при облачном подключении контекст уходит провайдеру.

Обычный цикл знаком по другим харнесам: исследовать репозиторий, предложить план, изменить файлы и запустить проверку. Есть веб-поиск, режим планирования, расширения и запуск без интерактивного интерфейса. В документации Gemini CLI экспериментальные функции отмечены отдельно; перед командным внедрением проверяйте их статус в установленной версии.

Для первой задачи выберите небольшой дефект с воспроизведением. Сравнивайте результат с другим агентом на том же коммите и с одинаковыми разрешениями, как описано в главе про эвалы.

По умолчанию проектные инструкции задаются файлом GEMINI.md. Он играет ту же роль, что AGENTS.md или CLAUDE.md в других инструментах: команды, соглашения, ограничения. Поддерживаются инструкции разных уровней; просмотр загруженного контекста описан в руководстве по GEMINI.md.

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

Для процедур есть скилы, а для внешних систем поддерживается MCP. Подключение сервера требует отдельной проверки доступов: авторизация в Gemini не даёт автоматически права читать корпоративный трекер.

Официально описаны вход через Google, ключ Gemini API и подключение через Vertex AI. У них различаются требования к проекту Google Cloud, квоты и условия использования. Для рабочего кода выбирайте одобренный компанией вариант, а не тот, который оказался первым на экране. Источник: способы авторизации.

Модели выбираются через /model; доступны автоматический выбор и конкретные модели в зависимости от подключения. Точный список проверяйте в документации команды и своём клиенте. Появление модели в Gemini API не доказывает её доступность в каждом режиме Gemini CLI.

Перед запуском команд проверьте политику разрешений и песочницу (sandbox). В Gemini CLI её можно включить флагом --sandbox; поддерживаемые механизмы зависят от операционной системы и установленных средств изоляции. Настройка описана в руководстве по песочнице.

Рабочий каталог внутри песочницы может оставаться доступным на запись. Не помещайте туда секреты и боевые выгрузки ради удобства. Отдельно проверьте сеть, подключённые каталоги и полномочия MCP-серверов.

Начните с безопасного пробного действия внутри рабочей папки и попытки обратиться к специально созданному тестовому файлу вне разрешённой области. Так вы проверите ограничение без использования настоящих секретов.

Установка через npm приведена в официальном руководстве:

npm install -g @google/gemini-cli

После настройки поддерживаемого механизма песочницы перейдите в каталог тестового проекта и запустите:

gemini --sandbox

Пройдите авторизацию выбранным способом. Попросите агента найти команды сборки и объяснить один модуль; затем проверьте, какие инструкции он загрузил. К изменениям переходите, когда понятны среда, модель и права.

Автор учебника: Шахматов Алексей