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Пройдите авторизацию выбранным способом. Попросите агента найти команды сборки и объяснить один модуль; затем проверьте, какие инструкции он загрузил. К изменениям переходите, когда понятны среда, модель и права.
Что дальше
Заголовок раздела «Что дальше»- OpenCode: если нужно переключаться между поставщиками моделей.
- Память проекта: как поддерживать общие инструкции команды.
- Безопасность и приватность: как проверить границы доступа до работы с данными.