Чтобы пользоваться Gemini CLI, установите его через npm или Homebrew, запустите gemini в папке проекта, выберите способ входа и опишите обычными словами, что нужно сделать. Gemini читает ваши файлы, предлагает правки и команды оболочки и по умолчанию спрашивает перед каждым запуском.
Перед началом — важная оговорка. С 18 июня 2026 года Gemini CLI больше не обслуживает пользователей бесплатного уровня и Google One. Google перевела их на Antigravity CLI. Gemini CLI продолжает работать с платным ключом Gemini API, Vertex AI или лицензией Gemini Code Assist Standard либо Enterprise. В этом руководстве — установка, вход, GEMINI.md, настройки, MCP, режимы подтверждений, slash-команды, чекпоинты и возврат к сессиям. Всё здесь опирается на официальную документацию Google по Gemini CLI по состоянию на октябрь 2026 года.
Что такое Gemini CLI
Gemini CLI — агент для программирования от Google с открытым исходным кодом, работающий в терминале. Он использует модели Gemini, читает и правит файлы в папке, из которой вы его запустили, выполняет команды оболочки, ищет в интернете, подключается к MCP-серверам и берёт инструкции проекта из GEMINI.md. Это агент для программирования, а не автодополнение: вы ставите задачу, и он шаг за шагом её решает. Сравнение с другими агентами — в статьях Gemini CLI или Claude Code и Codex или Gemini CLI.
Шаг 1: установите Gemini CLI
Для Gemini CLI нужен Node.js. Выберите способ установки, который вам подходит:
| Способ | Команда |
|---|---|
| Попробовать без установки | npx @google/gemini-cli |
| npm (любая платформа) | npm install -g @google/gemini-cli |
| macOS, Linux (Homebrew) | brew install gemini-cli |
| macOS (MacPorts) | sudo port install gemini-cli |
В npm есть три канала релизов: @latest (стабильный, еженедельно), @preview (еженедельно, опережает стабильный) и @nightly. Большинству стоит оставаться на стабильном. Чтобы обновиться позже, выполните gemini update или переустановите через пакетный менеджер. Проверьте установку:
gemini --versionШаг 2: выберите способ входа
Перейдите в проект и запустите:
cd my-project
geminiПри первом запуске Gemini CLI спросит, как вы хотите пройти аутентификацию. Вариантов три:
- Sign in with Google: открывает браузер. После изменений июня 2026 года этот вариант предназначен для организаций с лицензией Gemini Code Assist Standard или Enterprise; перед запуском задайте
GOOGLE_CLOUD_PROJECT— ID вашего проекта Google Cloud. - Ключ Gemini API: создайте ключ в Google AI Studio и задайте
GEMINI_API_KEY. На платном ключе использование оплачивается за токены. - Vertex AI: для команд в Google Cloud. Задайте
GOOGLE_API_KEYиGOOGLE_GENAI_USE_VERTEXAI=trueили используйте учётные данные Cloud.
export GEMINI_API_KEY="ваш-ключ"
geminiСменить способ потом можно через /auth. Если вы пользовались Gemini CLI на бесплатном личном аккаунте, уведомление Google отправляет вас в Antigravity CLI; подробно о переходе — в статье Gemini CLI или Claude Code. Перед долгими сессиями на ключе проверьте актуальные цены Gemini API от Google.
Шаг 3: первая задача
Начните с чего-то небольшого, но настоящего:
Объясни, как устроен модуль платежей, затем добавь валидацию входных
данных в эндпоинт возврата и запусти тесты.Gemini прочитает нужные файлы, покажет каждую правку и команду и дождётся вашего согласия. Несколько приёмов пригодятся с первого дня:
@path/to/fileдобавляет файл (или целую папку) в запрос.!git statusсразу выполняет команду оболочки. Одиночный!включает и выключает режим оболочки.gemini -p "кратко перескажи README.md"выполняет один запрос без интерактивного интерфейса и печатает ответ. Добавьте--output-format json, если результат будет читать скрипт./copyкопирует последний ответ в буфер обмена.
Шаг 4: напишите GEMINI.md
GEMINI.md — Markdown-файл с инструкциями, который Gemini CLI загружает и отправляет с каждым запросом: как собирать и тестировать, стиль кода, что не трогать. Выполните /init, и Gemini создаст первую версию по вашему проекту. Пишите коротко и конкретно:
# Проект: billing-service
## Команды
- Установка: npm ci
- Тесты: npm test (запускать, прежде чем говорить, что задача готова)
## Стиль
- TypeScript, отступ 2 пробела, только строгое равенство.
- Новые эндпоинты кладём в src/routes, к ним нужен тест.
## Нельзя
- Не править файлы в src/generated.Gemini CLI загружает файлы контекста слоями и объединяет их:
- Глобальный:
~/.gemini/GEMINI.md— ваши личные настройки для всех проектов. - Рабочая область: файлы
GEMINI.mdв папке проекта и в родительских папках. - По требованию: когда инструмент обращается к файлу во вложенной папке, Gemini подхватывает и
GEMINI.mdиз этой папки и её родителей.
Длинный файл можно разбить импортами, например строкой @./docs/style-guide.md. Чтобы увидеть, что на самом деле получает модель, выполните /memory show; /memory list покажет, какие файлы загружены. Если вы изменили файл посреди сессии, перезагрузите его через /memory reload.
Если в репозитории уже есть AGENTS.md, дублировать его не нужно. Задайте в настройках context.fileName как ["AGENTS.md", "GEMINI.md"]. Как держать один набор правил для нескольких агентов, объясняет статья CLAUDE.md и AGENTS.md.
Шаг 5: settings.json
Gemini CLI читает настройки из JSON-файлов:
~/.gemini/settings.json— пользовательские настройки;.gemini/settings.jsonвнутри проекта — настройки рабочей области.
Вместо ручной правки JSON выполните /settings: большинство опций меняется в редакторе прямо в CLI. Небольшой пример:
{
"general": {
"defaultApprovalMode": "auto_edit",
"checkpointing": { "enabled": true }
},
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}Модель на один запуск задаётся через -m / --model. Псевдонимы auto (по умолчанию), pro, flash и flash-lite позволяют выбирать по скорости и глубине, не запоминая точные названия моделей; в сессии модель меняется через /model.
Шаг 6: режимы подтверждений и sandbox
Если не сказать иначе, Gemini CLI спрашивает перед запуском инструментов. Поведение задаёт флаг --approval-mode:
| Режим | Что происходит |
|---|---|
default | Спрашивает перед каждым вызовом инструмента |
auto_edit | Автоматически одобряет правки файлов, но перед другими инструментами, например командами оболочки, спрашивает |
plan | Только чтение: Gemini может смотреть и планировать, но ничего не меняет |
yolo | Одобряет все вызовы инструментов; только для изолированной среды |
Старый флаг --yolo ещё существует, но объявлен устаревшим в пользу --approval-mode=yolo. Сделать auto_edit или plan режимом по умолчанию можно в настройках; yolo включается только из командной строки.
Sandbox по умолчанию выключен. Запустите с --sandbox (или -s), чтобы инструменты работали в изолированной среде: Seatbelt в macOS или контейнер Docker либо Podman. Если собираетесь регулярно пользоваться auto_edit или yolo, сначала включите sandbox. Почему одних подтверждений недостаточно, объясняет статья безопасность AI-агентов для программирования.
Шаг 7: подключите MCP-серверы
MCP-серверы дают Gemini дополнительные инструменты: поиск по документации, браузер, GitHub, вашу базу данных. Добавьте сервер из оболочки:
gemini mcp add github npx -y @modelcontextprotocol/server-githubДля HTTP-сервера добавьте --transport http и укажите URL вместо команды. --env KEY=value передаёт переменные окружения, а --scope user делает сервер доступным во всех проектах, а не только в текущем. gemini mcp list показывает, что настроено, а gemini mcp remove <имя> удаляет сервер.
Под капотом всё это записывается в раздел mcpServers файла settings.json, так что править можно и там. Внутри сессии /mcp выводит серверы и их инструменты, /mcp auth выполняет вход на серверы с OAuth, а /mcp reload перезапускает их. Если тема новая, прочитайте что такое MCP-сервер. Каждый сервер добавляет описания инструментов в контекстное окно, поэтому оставляйте только те, которыми пользуетесь.
Шаг 8: slash-команды, которые стоит знать
| Команда | Что делает |
|---|---|
/init | Создаёт GEMINI.md для проекта |
/memory show | Показывает инструкции, которые получает модель |
/settings | Открывает редактор настроек |
/model | Меняет модель |
/auth | Меняет способ входа |
/mcp | Список MCP-серверов и инструментов |
/tools | Список инструментов, доступных Gemini |
/stats | Статистика сессии, модели и инструментов |
/compress | Заменяет разговор кратким изложением, экономя токены |
/clear | Очищает экран и начинает заново |
/resume | Просмотр и продолжение сохранённых сессий |
/rewind | Шаг назад по разговору (также двойной Esc) |
/restore | Восстанавливает файлы из чекпоинта |
/directory | Добавляет папки в рабочую область |
/help | Список всех команд |
Можно писать и свои команды. Файл .toml в ~/.gemini/commands/ становится личной slash-командой, а файл в .gemini/commands/ внутри проекта доступен всем, кто работает с репозиторием. /commands list покажет их.
Шаг 9: чекпоинты и откат
Checkpointing — страховочная сетка Gemini CLI, и по умолчанию он выключен. Включите его в settings.json:
{
"general": {
"checkpointing": { "enabled": true }
}
}С этого момента каждый раз, когда вы одобряете инструмент, меняющий файлы, Gemini сначала сохраняет снимок проекта в отдельный теневой git-репозиторий в ~/.gemini/history/. Ваша собственная история git не затрагивается. Выполните /restore, чтобы увидеть список чекпоинтов, и /restore <id>, чтобы вернуть файлы и разговор к этой точке. Затем Gemini снова предложит исходный вызов инструмента: его можно повторить, изменить или пропустить.
Даже без чекпоинтов /rewind (или двойной Esc) позволяет вернуться к более раннему запросу и выбрать, что откатить: разговор, изменения в коде или и то и другое.
Шаг 10: возвращайтесь к сессиям
Gemini CLI сохраняет сессии для каждого проекта:
gemini --resume latest(или-r latest) продолжает последнюю сессию.gemini --list-sessionsпоказывает сохранённые сессии с номерами;gemini --resume 3открывает одну из них.- Внутри сессии
/resumeпозволяет просматривать, сохранять и снова открывать разговоры.
Новый запрос можно передать сразу: gemini -r latest "проверь ошибки типов".
Советы для лучших результатов
- Коммитьте перед крупными задачами. Чекпоинты — это хорошо, но git-коммит лучше и работает с любым инструментом.
- Говорите, как проверить. «Запусти
npm testи исправь падения» работает лучше, чем «сделай, чтобы работало». - Для крупных изменений — режим plan. Пусть Gemini осмотрится и предложит план, прежде чем что-то править.
- Указывайте файлы через
@. Это быстрее, чем ждать, пока Gemini их найдёт, и контекст остаётся сфокусированным. - Сжимайте или очищайте между задачами.
/compressоставляет краткое изложение,/clearначинает заново. Оба экономят токены. - Один агент на worktree. Если агентов несколько, дайте каждому свой git worktree, чтобы они не перезаписывали друг друга.
Когда одного терминала мало
Gemini CLI часто лишь один из нескольких агентов, которыми пользуется команда. Как только вы хотите, чтобы Gemini делал одну задачу, а Codex или Claude Code — другую, или чтобы один агент проверял работу другого, в одном терминале становится тесно.
AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Gemini CLI (и других CLI-агентов) в настоящих терминалах рядом друг с другом. Каждый агент Gemini использует свой вход через Google или GEMINI_API_KEY; что именно, терминал спросит при первом запуске. Подробности — на странице Gemini CLI в AgentVera.
- Workspace: сетка агентов на проект, от 1×1 до 5×4. Каждый агент Gemini начинает со своей сессии и после перезапуска снова её открывает.
- Разрешения для каждого агента: при создании агента выберите Ask, Auto или Full access.
- Инструкции: у Gemini CLI нет флага для дополнительных инструкций, поэтому поле Role and instructions в AgentVera до него не доходит. Пишите правила в
GEMINI.mdилиAGENTS.md. - Менеджер MCP: серверы, настроенные в AgentVera, подключаются к Gemini при запуске и объединяются по имени с вашими собственными настройками Gemini.
- Flows: передавайте результат одного агента следующему, например Gemini пишет, а другой агент проверяет.
- Автоматическое код-ревью: автоматическая проверка изменений агента в конце хода.
- Worktrees: создайте worktree в панели Git и запустите в нём агента.
Сетка, worktrees, код-ревью и MCP-менеджер доступны на бесплатном тарифе; flows входят в Pro и Team. Скачайте AgentVera и попробуйте на своём репозитории. Если у вас бесплатный аккаунт Google, AgentVera поддерживает и Antigravity.
Подведём итог
Установите Gemini CLI, запустите gemini и выберите вход, который работает и после июня 2026 года: платный API-ключ, Vertex AI или лицензию Code Assist. Выполните /init и держите GEMINI.md коротким, задайте настройки по умолчанию через /settings и добавляйте MCP-серверы, только когда они нужны. Оставайтесь в режиме подтверждений по умолчанию, пока не доверяете настройке, включите checkpointing, чтобы /restore мог откатывать правки, и возвращайтесь к работе через --resume latest. Чтобы сравнить с агентом OpenAI, прочитайте как пользоваться Codex CLI.