Установка Gemini CLI

Проверено 19 июля 2026 года. Команды сверены с официальной документацией Gemini CLI. Не включайте --yolo по умолчанию: этот режим автоматически подтверждает все действия инструментов. Не сохраняйте API-ключи и пароли прокси в репозитории.

Что понадобится

macOS, Windows или Linux с доступом в интернет;
терминал Bash, Zsh или PowerShell;
Node.js версии 20 или новее для установки через npm;
Google-аккаунт либо API-ключ Gemini из Google AI Studio;
доверенный проект, лучше — Git-репозиторий.

Проверьте Node.js и npm:

node --version
npm --version

Если Node.js отсутствует или версия ниже 20, установите актуальную поддерживаемую версию с официального сайта Node.js либо через принятый в вашей команде менеджер версий.

Установка

npm — основной способ

npm install --global @google/gemini-cli

Проверьте установку:

gemini --version

Для обновления стабильной версии:

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

Запуск без установки

npx @google/gemini-cli

Этот вариант удобен для знакомства, но перед запуском всё равно проверяйте имя официального пакета.

Homebrew на macOS или Linux

brew install gemini-cli

Для рабочей среды выбирайте стабильный канал. Preview и nightly предназначены для тестирования и могут содержать регрессии.

Авторизация

Запустите CLI:

gemini

Для большинства локальных пользователей официальный рекомендуемый вариант — Sign in with Google. CLI откроет браузер и сохранит авторизацию локально. Корпоративный или учебный аккаунт может потребовать настроенный Google Cloud project — уточните это у администратора организации.

Вход по API-ключу

Создайте ключ в Google AI Studio и передайте его через переменную окружения текущей сессии.

macOS или Linux:

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
gemini

Windows PowerShell:

$env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"
gemini

После запуска выберите Use Gemini API key. Не добавляйте настоящий ключ в Git, скриншоты, общие shell-скрипты или публичный .env. Для CI используйте защищённые секреты выбранной платформы.

Способ входа влияет на квоты, стоимость и условия обработки данных. Для корпоративной среды согласуйте Google Workspace, Vertex AI или API-ключ с администратором.

Первый запуск

Перейдите в корень нужного проекта:

cd /путь/к/проекту
gemini

Начните с задачи без изменений:

Изучи структуру проекта и существующие инструкции. Назови команды проверки, но пока не редактируй файлы и не запускай необратимые действия.

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

Контекст проекта

Команда /init анализирует текущий каталог и создаёт черновик GEMINI.md. В нём стоит оставить только устойчивые правила:

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

GEMINI.md — контекст, а не разрешение на любые действия. После генерации прочитайте файл, удалите догадки и оставьте только то, что действительно действует в проекте.

Безопасный режим

Стандартный режим запрашивает подтверждение перед действиями инструментов. Сохраняйте его как основной.

не запускайте Gemini CLI из домашней папки или каталога с несвязанными данными;
перед подтверждением читайте полную команду и путь, к которому она обращается;
проверяйте git diff, тесты и список изменённых файлов;
не доверяйте неизвестному репозиторию с локальными hooks, MCP, skills или настройками;
не передавайте в prompt секреты, доступ к которым модели не нужен;
не используйте --yolo для повседневной работы.

Песочница

Если Docker или Podman уже настроен, инструменты можно запускать в изолированной среде:

gemini --sandbox

Песочница ограничивает доступ к системе, но не отменяет проверку команд, подключений и смонтированных каталогов. Не подключайте Docker socket и лишние пути без понимания последствий.

Настройки и модель

Команда /settings открывает актуальные настройки интерфейса, модели, инструментов и безопасности. Пользовательские настройки хранятся в ~/.gemini/settings.json, проектные — в .gemini/settings.json.

Не фиксируйте в общей инструкции название «самой новой» модели: доступный набор зависит от версии CLI, аккаунта и способа авторизации. Сначала используйте модель по умолчанию, а конкретную выбирайте только если задача требует подтверждённой возможности или бюджета.

Автоматизация

Для ограниченной неинтерактивной задачи:

gemini -p "Запусти тесты и кратко объясни причину каждого сбоя"

Для машинной обработки результата официальный CLI поддерживает структурированные форматы вывода. Автоматизацию сначала отладьте локально, ограничьте права и не позволяйте недоверенному вводу напрямую формировать shell-команды.

Если что-то не работает

Команда `gemini` не найдена

Перезапустите терминал, проверьте node --version, npm --version и доступность глобального каталога npm через PATH. Для быстрой проверки попробуйте npx @google/gemini-cli.

Не открывается вход

Запустите gemini и смените способ через /auth. Для корпоративного аккаунта проверьте у администратора необходимость Google Cloud project и разрешённый метод входа.

Ошибка квоты или оплаты

Квоты зависят от Google-аккаунта, подписки, API-ключа или Vertex AI. Проверьте активный способ авторизации и официальную страницу quotas and pricing — смена модели не всегда решает ограничение.

Сеть ограничена организацией

Следуйте сетевой политике компании. Не вставляйте логин и пароль прокси в GEMINI.md, проектный .env или общий shell-профиль. Получите у администратора безопасный способ выдачи и хранения параметров.

Официальные источники

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