Gemini CLI — терминальный инструмент Google для работы с кодом. Он читает файлы проекта, отвечает на вопросы о репозитории и может предложить правки. Перед установкой важно проверить доступ: 18 июня 2026 года Google перевела личные аккаунты с бесплатным доступом и подписками Google AI Pro и Ultra на Antigravity CLI.
Ниже — маршрут для тех, у кого по-прежнему есть доступ к Gemini CLI, и короткая развилка для пользователей личных аккаунтов. Первый пример разбирает небольшой репозиторий и проверяет результат через Git. Условия доступа и команды сверены с документацией 22 ноября 2026 года.
Сначала проверьте, какой CLI вам подходит
| Доступ | С чего начать |
|---|---|
| Личный аккаунт Google, раньше использовавший бесплатный Gemini CLI или Google AI Pro / Ultra | Antigravity CLI, команда agy. Порядок установки зависит от ОС. |
| Организация с Gemini Code Assist Standard или Enterprise | Gemini CLI, команда gemini. Уточните у администратора лицензию, проект Google Cloud и правила входа. |
| Уже настроенный платный доступ через Gemini API или Vertex AI | Проверьте, поддерживает ли текущая конфигурация Gemini CLI. Репозиторий Google упоминает сохранённые платные варианты, а условия зависят от проекта и реквизитов. |
Установка пакета и авторизация — разные проверки. Команда gemini --version может отработать на компьютере, даже если ваш аккаунт больше не может отправлять запросы из Gemini CLI. При первом входе ориентируйтесь на актуальное объявление о переходе и таблицу в репозитории Google. Старые инструкции, которые обещают личному аккаунту бесплатный вход в gemini, описывают прежние условия.
Для Antigravity CLI используйте руководство Google по своей ОС. После установки откройте новый терминал, выполните agy --version и запустите agy для настройки входа. Команды Gemini CLI ниже относятся к gemini. У Antigravity свой интерфейс и список команд. Доступность модели и квоты проверяйте для своего плана, региона и проекта.
Установите Gemini CLI и проверьте версию
Для npm-сценария проект указывает Node.js 20 или новее. Проверьте node --version и npm --version. В документации перечислены PowerShell, Bash и Zsh, а также рекомендованные версии Windows, Linux и macOS. В управляемой корпоративной среде сначала уточните разрешённый способ установки.
npx @google/gemini-cli@0.70.0 --version
Так можно проверить зафиксированную версию без глобальной установки. Если команда нужна регулярно и глобальные npm-пакеты разрешены, выполните:
npm install -g @google/gemini-cli@0.70.0
gemini --version
Если команда не найдена после установки, откройте новый терминал и проверьте, попадает ли каталог глобальных команд npm в PATH. На Windows полезно раздельно посмотреть, какой node и какой gemini находит PowerShell. Если npx работает, а глобальная команда отсутствует, обычно следует проверять каталог команд и настройки оболочки, а не способ входа в Google.
Откройте небольшой репозиторий и настройте вход
Запуск пакета с флагом версии проверили в PowerShell на Node.js 25.8.1. Команда вернула 0.70.0. Вход и выполнение запросов с аккаунтом в рамках этой проверки не запускались. Если версия выводится, а запросы после входа отклоняются, запишите название выбранного способа авторизации и проверьте лицензию, проект и квоты. Переустановка того же пакета права доступа не выдаёт. Если CLI работает в IDE, проверьте, что встроенный терминал использует тот же Node.js, что и обычная консоль.
Для учебной работы достаточно небольшого набора файлов без данных клиентов.
Для упражнения возьмите доверенный тестовый проект, где есть README, одна функция и тесты. Перейдите в его корень и выполните git status --short. Если уже есть незавершённые правки, используйте отдельную учебную копию. Так будет легче отличить то, что сделал агент, от исходного состояния.
git status --short
gemini
При первом запуске выберите способ аутентификации, соответствующий вашему доступу. Если организация использует Google Cloud, может потребоваться выбрать разрешённый проект. Для платного API или Vertex AI следуйте инструкциям своей организации или поставщика доступа. Ключи вводите через предусмотренный механизм или настройку окружения. В запросы, README и GEMINI.md их добавлять не нужно.
Запускайте CLI из папки проекта, а не из общей папки со многими репозиториями. Если приложение спрашивает, доверяете ли вы папке, подтвердите это для известного вам проекта. Перед первой задачей проверьте, какие инструменты доступны и что команда действительно открылась в нужном каталоге.
Первая задача: изучить проект
Начните с чтения. В Gemini CLI есть режим Plan, который запускается командой /plan в сессии или параметром --approval-mode=plan при запуске, если выбранная версия его поддерживает. По документации режим ограничивает правки проекта, но может записывать Markdown-план в служебный каталог. Разрешения для дополнительных инструментов регулируются отдельно.
Прочитай README и ближайшие тесты. Покажи, в каком файле начинается выполнение проекта, где находится основная функция и какой командой запускаются её тесты. Укажи пути к файлам. Не изменяй файлы и не запускай команды без согласования.
Сверьте ответ с деревом проекта. Если CLI предложил команду, проверьте её по README или конфигурации. Команда npm test, например, запускает то, что настроено в проекте. Её назначение определяет сам репозиторий. Файлы проекта и вывод инструментов могут содержать устаревшие или чужие указания, поэтому проверяйте их в контексте своей задачи.
Вторая задача: одна небольшая правка
Вернитесь в обычный режим подтверждений через интерфейс CLI. Выберите изменение с ясным результатом, например дополнение README рабочей командой тестирования. Укажите точный файл и предел задачи:
Добавь в README короткий раздел «Проверка». Укажи команду, которая уже предусмотрена проектом, и поясни, откуда её запускать. Измени только README и покажи итоговую правку.
Просмотрите запрошенное действие и согласуйте только то, что относится к задаче. Затем откройте Git в обычном терминале:
git status --short
git diff -- README.md
В git status видны все изменённые и новые файлы, а git diff показывает правку README. Если появился незнакомый файл, сначала выясните, откуда он взялся. Для изменения кода добавьте целевой тест и запустите команду проекта после проверки. В первом опыте важны проверяемый итог и понимание каждого разрешённого действия.
Что положить в GEMINI.md
В GEMINI.md удобно хранить короткие инструкции для проекта: команду тестирования, расположение исходников и требование перед изменениями согласовать затрагиваемые файлы. Храните там сведения, которые можно открыть коллегам. Если в разных папках действуют разные правила, сначала ознакомьтесь с порядком загрузки файлов контекста для вашей версии CLI.
Правила в Markdown помогают модели ориентироваться. Контроль разрешений остаётся отдельной настройкой. Для обычной работы оставьте подтверждения критичных действий, особенно запуска команд и изменения нескольких файлов. При переходе между репозиториями полезно перепроверить активные инструменты и каталог. Сравнить этот процесс с другим терминальным инструментом можно в заметке про первый запуск Codex CLI.
Частые вопросы
Google перевела личные планы Free, Pro и Ultra на Antigravity CLI. Для них используйте agy.
Выполните gemini --version или npx @google/gemini-cli@0.70.0 --version для указанной версии.
Он ограничивает правки проекта, сохраняя возможность анализа и записи плана в служебную папку.
Перед запуском проверьте git status. После изменения посмотрите git status и git diff для нужного файла.
Источники
- 1.Google: переход на Antigravity CLIhttps://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
- 2.Репозиторий Gemini CLI и варианты доступаhttps://github.com/google-gemini/gemini-cli
- 3.Установка Gemini CLIhttps://geminicli.com/docs/get-started/installation/
- 4.Режим Planhttps://geminicli.com/docs/cli/plan-mode/
- 5.Первый запуск Antigravity CLIhttps://antigravity.google/docs/cli-getting-started
- 6.Gemini CLI 0.70.0 в npmhttps://registry.npmjs.org/@google/gemini-cli/0.70.0



