# Как пользоваться Gemini CLI: пошаговое руководство

URL: https://agentvera.dev/ru/blog/how-to-use-gemini-cli/ · Опубликовано: 2026-10-25

Как пользоваться Gemini CLI: установка, способ входа после изменений июня 2026, GEMINI.md, settings.json, MCP-серверы и откат правок через чекпоинты.

**Коротко:**

- Установите Gemini CLI через npm, Homebrew или MacPorts либо попробуйте через npx, затем запустите gemini в папке проекта и выберите способ входа.
- С 18 июня 2026 года пользователей бесплатного уровня и Google One перевели на Antigravity CLI; Gemini CLI теперь работает с платными ключами Gemini API, Vertex AI и Code Assist Standard или Enterprise.
- Правила проекта пишутся в GEMINI.md, настройки — в .gemini/settings.json, MCP-серверы добавляются через gemini mcp add, а чекпоинты и /restore позволяют откатить правки файлов.

Чтобы пользоваться 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`. Это [агент для программирования](/ru/glossary/coding-agent/ "Что такое агент для программирования"), а не автодополнение: вы ставите задачу, и он шаг за шагом её решает. Сравнение с другими агентами — в статьях [Gemini CLI или Claude Code](/ru/blog/gemini-cli-vs-claude-code/ "Gemini CLI или Claude Code") и [Codex или Gemini CLI](/ru/blog/codex-vs-gemini-cli/ "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` или переустановите через пакетный менеджер. Проверьте установку:

```bash
gemini --version
```

## Шаг 2: выберите способ входа

Перейдите в проект и запустите:

```bash
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.

```bash
export GEMINI_API_KEY="ваш-ключ"
gemini
```

Сменить способ потом можно через `/auth`. Если вы пользовались Gemini CLI на бесплатном личном аккаунте, уведомление Google отправляет вас в Antigravity CLI; подробно о переходе — в статье [Gemini CLI или Claude Code](/ru/blog/gemini-cli-vs-claude-code/ "Gemini CLI или Claude Code"). Перед долгими сессиями на ключе проверьте актуальные [цены Gemini API от Google](https://ai.google.dev/gemini-api/docs/pricing "Цены Gemini API").

## Шаг 3: первая задача

Начните с чего-то небольшого, но настоящего:

```text
Объясни, как устроен модуль платежей, затем добавь валидацию входных
данных в эндпоинт возврата и запусти тесты.
```

Gemini прочитает нужные файлы, покажет каждую правку и команду и дождётся вашего согласия. Несколько приёмов пригодятся с первого дня:

- `@path/to/file` добавляет файл (или целую папку) в запрос.
- `!git status` сразу выполняет команду оболочки. Одиночный `!` включает и выключает режим оболочки.
- `gemini -p "кратко перескажи README.md"` выполняет один запрос без интерактивного интерфейса и печатает ответ. Добавьте `--output-format json`, если результат будет читать скрипт.
- `/copy` копирует последний ответ в буфер обмена.

## Шаг 4: напишите GEMINI.md

`GEMINI.md` — Markdown-файл с инструкциями, который Gemini CLI загружает и отправляет с каждым запросом: как собирать и тестировать, стиль кода, что не трогать. Выполните `/init`, и Gemini создаст первую версию по вашему проекту. Пишите коротко и конкретно:

```markdown
# Проект: billing-service

## Команды
- Установка: npm ci
- Тесты: npm test (запускать, прежде чем говорить, что задача готова)

## Стиль
- TypeScript, отступ 2 пробела, только строгое равенство.
- Новые эндпоинты кладём в src/routes, к ним нужен тест.

## Нельзя
- Не править файлы в src/generated.
```

Gemini CLI загружает файлы контекста слоями и объединяет их:

1. **Глобальный:** `~/.gemini/GEMINI.md` — ваши личные настройки для всех проектов.
2. **Рабочая область:** файлы `GEMINI.md` в папке проекта и в родительских папках.
3. **По требованию:** когда инструмент обращается к файлу во вложенной папке, 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](/ru/blog/claude-md-agents-md/ "CLAUDE.md и AGENTS.md").

## Шаг 5: settings.json

Gemini CLI читает настройки из JSON-файлов:

- `~/.gemini/settings.json` — пользовательские настройки;
- `.gemini/settings.json` внутри проекта — настройки рабочей области.

Вместо ручной правки JSON выполните `/settings`: большинство опций меняется в редакторе прямо в CLI. Небольшой пример:

```json
{
  "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-агентов для программирования](/ru/blog/ai-coding-agent-security/ "Безопасность AI-агентов для программирования").

## Шаг 7: подключите MCP-серверы

[MCP](/ru/glossary/mcp/ "Что такое MCP")-серверы дают Gemini дополнительные инструменты: поиск по документации, браузер, GitHub, вашу базу данных. Добавьте сервер из оболочки:

```bash
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-сервер](/ru/blog/what-is-mcp-server/ "Что такое MCP-сервер"). Каждый сервер добавляет описания инструментов в [контекстное окно](/ru/glossary/context-window/ "Что такое контекстное окно"), поэтому оставляйте только те, которыми пользуетесь.

## Шаг 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`:

```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](/ru/blog/git-worktree-parallel-agents/ "Git worktree для параллельных агентов"), чтобы они не перезаписывали друг друга.

## Когда одного терминала мало

Gemini CLI часто лишь один из нескольких агентов, которыми пользуется команда. Как только вы хотите, чтобы Gemini делал одну задачу, а Codex или Claude Code — другую, или чтобы один агент проверял работу другого, в одном терминале становится тесно.

AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Gemini CLI (и других CLI-агентов) в настоящих терминалах рядом друг с другом. Каждый агент Gemini использует свой вход через Google или `GEMINI_API_KEY`; что именно, терминал спросит при первом запуске. Подробности — на странице [Gemini CLI в AgentVera](/ru/agents/gemini-cli/ "Gemini CLI в AgentVera").

- **[Workspace](/ru/features/workspace/ "Workspace"):** сетка агентов на проект, от 1×1 до 5×4. Каждый агент Gemini начинает со своей сессии и после перезапуска снова её открывает.
- **Разрешения для каждого агента:** при создании агента выберите Ask, Auto или Full access.
- **Инструкции:** у Gemini CLI нет флага для дополнительных инструкций, поэтому поле Role and instructions в AgentVera до него не доходит. Пишите правила в `GEMINI.md` или `AGENTS.md`.
- **[Менеджер MCP](/ru/features/mcp-manager/ "Менеджер MCP"):** серверы, настроенные в AgentVera, подключаются к Gemini при запуске и объединяются по имени с вашими собственными настройками Gemini.
- **[Flows](/ru/features/flows/ "Flows"):** передавайте результат одного агента следующему, например Gemini пишет, а другой агент проверяет.
- **[Автоматическое код-ревью](/ru/features/code-review/ "Автоматическое код-ревью"):** автоматическая проверка изменений агента в конце хода.
- **Worktrees:** создайте worktree в [панели Git](/ru/features/git-and-github/ "Git и GitHub") и запустите в нём агента.

Сетка, worktrees, код-ревью и MCP-менеджер доступны на бесплатном тарифе; flows входят в Pro и Team. [Скачайте AgentVera](/ru/download/ "Скачать AgentVera") и попробуйте на своём репозитории. Если у вас бесплатный аккаунт Google, AgentVera поддерживает и [Antigravity](/ru/agents/antigravity/ "Antigravity в AgentVera").

## Подведём итог

Установите Gemini CLI, запустите `gemini` и выберите вход, который работает и после июня 2026 года: платный API-ключ, Vertex AI или лицензию Code Assist. Выполните `/init` и держите `GEMINI.md` коротким, задайте настройки по умолчанию через `/settings` и добавляйте MCP-серверы, только когда они нужны. Оставайтесь в режиме подтверждений по умолчанию, пока не доверяете настройке, включите checkpointing, чтобы `/restore` мог откатывать правки, и возвращайтесь к работе через `--resume latest`. Чтобы сравнить с агентом OpenAI, прочитайте [как пользоваться Codex CLI](/ru/blog/how-to-use-codex-cli/ "Как пользоваться Codex CLI").

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

**Gemini CLI всё ещё бесплатный?** Для личных аккаунтов — нет. По уведомлению Google, 18 июня 2026 года пользователей бесплатного уровня и Google One перевели на Antigravity CLI. Gemini CLI продолжает работать с платными ключами Gemini API, Vertex AI и лицензиями Gemini Code Assist Standard или Enterprise.

**Чем GEMINI.md отличается от AGENTS.md?** Оба — Markdown-файлы с инструкциями для проекта. По умолчанию Gemini CLI читает GEMINI.md. Если ваша команда уже держит правила в AGENTS.md, задайте в settings.json для context.fileName список вроде ["AGENTS.md", "GEMINI.md"], и Gemini CLI будет читать оба.

**Как запретить Gemini CLI запускать команды без вопросов?** Оставайтесь в режиме подтверждений по умолчанию, который спрашивает перед каждым вызовом инструмента. auto_edit одобряет правки файлов, но перед другими инструментами всё равно спрашивает, а yolo одобряет всё, поэтому используйте его только в sandbox, которому доверяете.

**Как отменить изменение, сделанное Gemini CLI?** Включите checkpointing в settings.json. Тогда Gemini CLI перед каждой правкой файлов сохраняет снимок, а /restore возвращает файлы обратно. Даже без чекпоинтов /rewind (или двойной Esc) позволяет откатить разговор и изменения в файлах.

**Как продолжить прошлую сессию Gemini CLI?** Запустите Gemini CLI с --resume latest, чтобы продолжить последнюю сессию, или выполните gemini --list-sessions и откройте нужную по номеру. Внутри сессии /resume позволяет просмотреть сохранённые разговоры и выбрать один.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/