Gemini CLI: что это такое и как запустить терминальный агент от Google бесплатно

Gemini CLI 2026: что это такое и как запустить терминальный агент от Google бесплатно

Gemini CLI — open source AI-агент от Google, который работает прямо в терминале. Один раз установил, запустил в папке с проектом командой gemini — и получил полноценного кодинг-агента с 1 миллионом токенов контекста. Бесплатно, с аккаунтом Google. Без IDE, без плагинов.

В этой статье — как установить Gemini CLI, настроить аутентификацию, сделать первые запросы и понять, чем он отличается от Claude Code и от Gemini Code Assist (это разные продукты, и путаница тут частая).

Что такое Gemini CLI и чем он отличается от Code Assist

Первое, что надо прояснить: Gemini CLI и Gemini Code Assist — разные продукты с разной установкой и разными сценариями.

Gemini Code Assist — это плагин для VS Code и других IDE. Он подсказывает код прямо в редакторе, как Copilot. Устанавливается через маркетплейс расширений.

Gemini CLI — терминальный агент. Он не привязан к редактору, живет в командной строке и умеет:

• читать файлы вашего проекта и понимать его структуру
• вносить изменения в код по вашей просьбе
• запускать shell-команды (с подтверждением)
• подключаться к внешним сервисам через MCP-серверы
• работать с любым редактором — хоть VS Code, хоть Neovim, хоть вообще без него

По архитектуре Gemini CLI похож на Claude Code — оба терминальные агенты, оба используют ReAct-цикл (think → act → observe). Но ключевое отличие: Gemini CLI полностью бесплатен при авторизации через Google-аккаунт.

По качеству кода они практически равны. Разница в деньгах — существенная.

Системные требования перед установкой

Gemini CLI требует Node.js версии 20 и выше. На Node 18 установка может завершиться без ошибок, но бинарник будет неполным — это задокументированная проблема в issue #7795 на GitHub.

Проверь версию Node перед установкой:

node --version

Если версия ниже 20 — скачай актуальную с nodejs.org. Работает на macOS 15+, Windows 11 и Ubuntu 20.04+.

Как установить Gemini CLI через npm

Установка одной командой. На Mac и Linux:

npm install -g @google/gemini-cli

На Windows через PowerShell — та же команда. Занимает 10-15 секунд на нормальном интернете.

После установки проверь, что всё встало корректно:

gemini --version

Если терминал не находит команду gemini — значит папка с глобальными npm-пакетами не добавлена в PATH. Это самая частая проблема (45% всех issue по установке). Решается добавлением пути в .bashrc или .zshrc:

export PATH="$HOME/.npm-global/bin:$PATH"

Перезапусти терминал и попробуй снова.

Важно: не используй sudo npm install -g. Это создаст root-owned директорию, и каждый следующий апдейт будет ломаться с permission error. Вместо этого настрой npm prefix без root.

Есть альтернатива — запустить без установки через npx:

npx @google/gemini-cli

Это скачает последнюю версию и запустит. Удобно попробовать, прежде чем ставить глобально.

Homebrew на Mac — самый простой вариант

Если работаешь на Mac и используешь Homebrew, это проще:

brew install gemini-cli

Homebrew сам разберется с Node.js и PATH. Никаких permission-проблем.

Как настроить аутентификацию

При первом запуске gemini в терминале появится выбор из трех способов авторизации:

1. Войти через Google-аккаунт — самый простой. Открывается браузер, логинишься как обычно. Бесплатно, 1000 запросов в день, модель Gemini 2.5 Pro.

2. API-ключ — нужен для доступа к Gemini 3.1 Pro. Ключ берешь из Google AI Studio (aistudio.google.com), потом:

export GEMINI_API_KEY="твой_ключ_сюда"

Или пропиши в ~/.bashrc / ~/.zshrc, чтобы не вводить каждый раз.

3. Vertex AI — для корпоративных аккаунтов Google Cloud. Требует GOOGLE_CLOUD_PROJECT.

Для старта — выбирай первый вариант. Gemini 2.5 Pro на бесплатном плане достаточно мощный для большинства задач.

Первый запуск: что делать после установки

Переходи в папку с проектом:

cd /path/to/your/project
gemini

Появится ASCII-логотип Gemini и интерактивная сессия. Теперь можно спрашивать:

> Расскажи мне про этот проект

Агент просмотрит файлы, поймет структуру и даст сводку. Это занимает секунд 10-15 в зависимости от размера проекта.

С марта 2026 Gemini CLI запускается в Plan Mode по умолчанию. Это значит, что перед любыми изменениями агент сначала прочитает кодовую базу и предложит план — без записи в файлы. Только после твоего подтверждения пойдут реальные правки. Хорошая защита от случайных изменений.

Полезные команды внутри сессии

Gemini CLI в VS Code: как настроить рабочее место

Gemini CLI можно запустить прямо во встроенном терминале VS Code. Но есть удобный трюк: перенеси терминал с агентом на правую панель, а не оставляй внизу. Так код и агент видны одновременно, не надо переключаться.

Для этого: открой правую панель VS Code (значок боковой панели справа), перетащи туда вкладку с терминалом.

Также есть официальное расширение Gemini CLI для VS Code. Оно добавляет:

• контекст открытых файлов
• контекст выделенного кода
• нативный diff для просмотра изменений

Поставь его, если работаешь в VS Code — сильно удобнее.

Как работает контекстное окно 1М токенов на практике

1 миллион токенов — это примерно 3-4 миллиона символов кода. Средний проект на React или Next.js весом в 50-100 тысяч строк влезает целиком. Gemini CLI видит всю кодовую базу сразу, без чанкинга и суммаризации.

На практике это важно для рефакторинга больших файлов и поиска зависимостей между модулями. Агент не теряет контекст, когда переходит от одного файла к другому.

Но есть нюанс: к концу длинной сессии любая LLM начинает хуже работать с ранним контекстом. Опытные пользователи советуют начинать новую сессию, когда агент начинает «тупить» — это сбрасывает фокус и восстанавливает качество ответов.

Максим: «У нас в NanaBanana кодовая база ~80 тысяч строк. Gemini CLI берет всё в контекст с первой попытки — Claude Code на бесплатном плане этого не умеет. Для задач типа "найди все места, где обрабатываются ошибки" — разница ощутимая. Когда надо копаться по всему проекту сразу, беру Gemini. Когда важна точность на конкретном компоненте — Claude Code.»

Gemini CLI vs Claude Code: когда что брать

Оба инструмента умеют одно и то же. Разница — в деталях и деньгах.

Gemini CLI выигрывает по скорости генерации кода. Хорош для прототипирования и работы с большими кодовыми базами. Открытый исходный код позволяет форкнуть и кастомизировать под себя.

Claude Code выигрывает на сложных многофайловых задачах и на точности архитектурных решений. Первый проход без правок — чаще у Claude. Но только платно.

Реалистичный сетап для большинства вайбкодеров в 2026 году: Gemini CLI бесплатно для исследования, прототипирования и работы с большими проектами + Claude Code Pro ($20/мес) для задач, где важна точность.

MCP-серверы: как расширить возможности агента

MCP (Model Context Protocol) — это протокол для подключения внешних сервисов к агенту. Через него Gemini CLI может обращаться к документации, базам данных, сторонним API.

Конфигурируется через ~/.gemini/settings.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

После перезапуска агента MCP-серверы появятся в списке /mcp. Популярные: Context7 для актуальной документации по библиотекам, Taskmaster AI для управления задачами, Firebase для работы с базой данных прямо из терминала.

Посмотреть все доступные расширения: каталог AI-инструментов.

Распространенные ошибки и как их решить

gemini: command not found — PATH не настроен. Добавь export PATH="$HOME/.npm-global/bin:$PATH" в .bashrc или .zshrc и перезапусти терминал.

Ошибка при авторизации через Google — в корпоративных сетях иногда требуется переменная окружения GOOGLE_CLOUD_PROJECT с ID проекта из Google Cloud Console.

Установка прошла, но бинарник не работает — скорее всего, Node.js ниже 20-й версии. Корпоративные прокси тоже ломают postinstall-шаг (issue #7795). Попробуй установить через Homebrew.

Медленная работа на больших проектах — нормально при первом запуске. Агент обходит файловую систему. На повторных запусках быстрее.

FAQ

Gemini CLI правда бесплатный?
Да, при авторизации через Google-аккаунт. 60 запросов в минуту, 1000 в день. Модель Gemini 2.5 Pro. Для большинства задач хватает. С апреля 2026 Google сдвинул Gemini Pro из полностью бесплатного в платный Google AI Pro ($19.99/мес), но базовый доступ через Google-аккаунт остался.

Чем Gemini CLI отличается от Gemini Code Assist?
Code Assist — плагин для IDE (VS Code, JetBrains). Gemini CLI — терминальный агент, работает независимо от редактора. Разные продукты с разной установкой.

Нужен ли платный план для Gemini 3.1 Pro в CLI?
Да. Для доступа к Gemini 3.1 Pro нужен API-ключ (платно через Google AI Studio) или подписка Google AI Pro ($19.99/мес). На бесплатном плане — Gemini 2.5 Pro.

Как обновить Gemini CLI до последней версии?
Просто заново запусти npm install -g @google/gemini-cli. Или npm update -g @google/gemini-cli. Стабильные обновления выходят каждый вторник.

Что такое Plan Mode в Gemini CLI?
Режим, включенный по умолчанию с марта 2026 (v0.34.0). В Plan Mode агент сначала читает кодовую базу и предлагает план изменений — без записи в файлы. Ты подтверждаешь, и только потом идут реальные правки. Хорошо защищает от случайных изменений.

Можно ли использовать Gemini CLI без интернета?
Нет. Агент отправляет запросы в API Google. Нужен стабильный интернет.

Как добавить инструкции для агента под конкретный проект?
Создай файл GEMINI.md в корне проекта. Туда пиши: стек, соглашения по стилю кода, куда складывать новые файлы, как писать тесты. Агент читает его при каждом запуске.

Глоссарий

CLI (Command Line Interface) — интерфейс командной строки. Программа, которая работает в терминале, без графического интерфейса.

Терминальный агент — AI-инструмент, который работает в терминале и может выполнять действия: читать файлы, писать код, запускать команды.

Контекстное окно — количество текста, которое модель «держит в голове» за одну сессию. 1М токенов ≈ 3-4 млн символов кода.

MCP (Model Context Protocol) — открытый протокол для подключения внешних сервисов к AI-агентам. Придуман Anthropic, поддерживается большинством терминальных агентов.

ReAct-цикл — подход к работе агента: think (подумать) → act (действовать) → observe (наблюдать за результатом). Повторяется до выполнения задачи.

Plan Mode — режим Gemini CLI, где агент сначала предлагает план изменений без записи в файлы, ждет подтверждения.

SWE-bench Verified — бенчмарк для оценки качества кода AI-моделей. Измеряет процент реальных GitHub-issues, которые модель успешно исправляет.

npx — способ запустить npm-пакет без глобальной установки. npx @google/gemini-cli запустит агент без npm install -g.

Что дальше

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

Посмотри обзоры других инструментов из той же категории:

• Claude Code — лучший вариант для сложных архитектурных задач
• Cursor — если хочешь агента внутри IDE, а не в терминале
• Aider — еще один open source терминальный агент с поддержкой любых API

Весь каталог AI IDE и инструментов для вайбкодинга — на сайте.

Если хочешь разобраться, какой стек подойдет под твои задачи — запишись на консультацию к Максиму. Без продаж, просто разберемся по делу.

Обновлено: май 2026. Актуальные версии: Gemini CLI v0.41+, Node.js 20+, Gemini 2.5 Pro на бесплатном плане.