Заметки

Gemini CLI: установка и первые задачи в проекте

M
Markabus
·
Ноутбук с условным терминалом и карточками Gemini CLI и Antigravity CLI. Иллюстрация, интерфейс условный.

Gemini CLI — терминальный инструмент Google для работы с кодом. Он читает файлы проекта, отвечает на вопросы о репозитории и может предложить правки. Перед установкой важно проверить доступ: 18 июня 2026 года Google перевела личные аккаунты с бесплатным доступом и подписками Google AI Pro и Ultra на Antigravity CLI.

Ниже — маршрут для тех, у кого по-прежнему есть доступ к Gemini CLI, и короткая развилка для пользователей личных аккаунтов. Первый пример разбирает небольшой репозиторий и проверяет результат через Git. Условия доступа и команды сверены с документацией 22 ноября 2026 года.

Сначала проверьте, какой CLI вам подходит

ДоступС чего начать
Личный аккаунт Google, раньше использовавший бесплатный Gemini CLI или Google AI Pro / UltraAntigravity CLI, команда agy. Порядок установки зависит от ОС.
Организация с Gemini Code Assist Standard или EnterpriseGemini 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.

Частые вопросы

Q.Работает ли Gemini CLI с личной подпиской Google AI Pro?

Google перевела личные планы Free, Pro и Ultra на Antigravity CLI. Для них используйте agy.

Q.Как проверить установленную версию?

Выполните gemini --version или npx @google/gemini-cli@0.70.0 --version для указанной версии.

Q.Что даёт режим Plan?

Он ограничивает правки проекта, сохраняя возможность анализа и записи плана в служебную папку.

Q.Как сверить первую правку?

Перед запуском проверьте git status. После изменения посмотрите git status и git diff для нужного файла.

Источники

Поделиться:OKVK