Gemini CLI — открытый AI-агент Google для терминала: читает код, правит файлы, запускает команды и проверяет результат, а не просто выдаёт ответы в чат. Инструмент переживает переходный период: с 18 июня 2026 Google отключил для него вход с Google-аккаунтом и переводит обычных пользователей на закрытый Antigravity CLI. Сам Gemini CLI жив — у репозитория 106 000 звёзд, релизы выходят еженедельно, а работать с ним можно через бесплатный API-ключ Google AI Studio (250 запросов в день) или Vertex AI. Ниже — что это такое, как установить, войти и начать работать, и что из этого реально доступно в России.
Что такое Gemini CLI
Gemini CLI — open-source (Apache 2.0) агент, который запускается в терминале и умеет:
- читать и менять файлы проекта, выполнять shell-команды, делать веб-запросы и искать в Google через встроенный grounding;
- работать с контекстом проекта через файл
GEMINI.mdи подгружаемые по требованию Skills; - подключать внешние инструменты через MCP-серверы (GitHub, базы данных и т.п.);
- работать в headless-режиме из скриптов и CI:
gemini -p "промпт"с выводом в JSON; - ревьюить пул-реквесты и сортировать issues через официальный GitHub Action.
Модели — Gemini 3 Pro и Gemini 3 Flash с контекстом до 1 млн токенов (README репозитория, на момент публикации). По умолчанию включён авто-роутинг: простые запросы уходят на Flash, сложные — на Pro, при исчерпании лимита агент предлагает переключиться на более старую модель (документация).
Масштаб проекта: 106 000 звёзд, 14 400+ форков и 6 000+ слитых пул-реквестов — по словам Google, «community of millions of users» (анонс).
Кейс: как разработчик использует Gemini CLI
Доменико Теначе, software-разработчик, в конце мая 2026 года опубликовал на dev.to разбор того, как он превратил Gemini CLI из «агента-джекпота» в инструмент, который знает его проекты (Gemini CLI Skills: Teaching Your Terminal Agent How to Think). Он описывает Skills — папки с инструкциями, которые агент подгружает только когда они нужны, и это его ключевое отличие от GEMINI.md:
A Skill is a self-contained directory that packages specialized instructions and context into a discoverable capability. Unlike GEMINI.md files that are always loaded into context, Skills are loaded on demand, only when the agent determines they’re relevant to your current task.
«Скилл — это самодостаточная папка, которая упаковывает специализированные инструкции и контекст в подключаемую способность. В отличие от файлов GEMINI.md, которые всегда загружены в контекст, скиллы подгружаются по требованию — только когда агент решает, что они релевантны текущей задаче.»
Практический результат из его текста: он написал скиллы для код-ревью (чек-лист по корректности, безопасности, производительности) и для коммитов в формате Conventional Commits, после чего Gemini CLI стабильно следует этим правилам без напоминаний. Его примечание о переходе стоит процитировать целиком — оно актуально и в августе 2026:
Google has announced that Gemini CLI will transition to Antigravity CLI on June 18th for free tier and Google One users. The good news? Skills work the same way in both tools, so everything you learn here applies directly to Antigravity CLI.
«Google объявил, что Gemini CLI перейдёт в Antigravity CLI 18 июня для бесплатного тарифа и пользователей Google One. Хорошая новость: скиллы работают в обоих инструментах одинаково, так что всё, чему вы научитесь здесь, напрямую применимо к Antigravity CLI.»
Установка
Системные требования
По документации (на момент публикации):
- Node.js 20.0+ (нужен для npm-установки);
- macOS 15+, Windows 11 24H2+, Ubuntu 20.04+ (Linux — любая современная сборка с bash/zsh);
- 4 ГБ+ RAM для коротких сессий, 16 ГБ+ для больших проектов;
- интернет-соединение.
Способы установки
Основной — через npm:
npm install -g @google/gemini-cli
Альтернативы:
| Способ | Команда | Когда удобно |
|---|---|---|
| Homebrew (macOS/Linux) | brew install gemini-cli |
если уже пользуетесь brew |
| MacPorts (macOS) | sudo port install gemini-cli |
для пользователей MacPorts |
| npx (без установки) | npx @google/gemini-cli |
попробовать без изменений в системе |
| Anaconda | conda create -n gemini_env -c conda-forge nodejs + npm внутри |
ограниченные окружения |
| Docker-песочница | gemini --sandbox -p "промпт" |
когда нужна изоляция команд |
Проверка установки:
gemini --version
На момент публикации актуальная стабильная версия — из серии 0.2x, релизы выходят каждую неделю по вторникам (каналы latest, preview, nightly).
В Windows Gemini CLI ставится нативно через npm (требуется Node.js) и работает в PowerShell. Альтернативный путь — WSL, если привычнее Linux-окружение. Версия для macOS, Windows и Linux одна и та же npm-упаковка, отдельных инсталляторов Google не выпускает.
Вход: что работает в августе 2026
Здесь главное отличие Gemini CLI от большинства гайдов в интернете: вход «через Google-аккаунт» больше не работает. 18 июня 2026 Google отключил для Gemini CLI бесплатный тариф Gemini Code Assist for individuals и подписки Google AI Pro / Ultra (официальная страница deprecation, обновлена 23.06.2026):
Starting June 18, 2026, Gemini Code Assist IDE extensions stopped serving requests for the Gemini Code Assist for individuals, Google AI Pro, and Google AI Ultra tiers. This also applies to usage of Gemini CLI. As part of the deprecation, you can no longer use the Login with Google option to access the IDE extensions or Gemini CLI.
«С 18 июня 2026 расширения Gemini Code Assist перестали обслуживать тарифы Gemini Code Assist for individuals, Google AI Pro и Google AI Ultra. Это касается и Gemini CLI. В рамках отключения вы больше не можете использовать вариант „Вход с Google“ для доступа к расширениям IDE или Gemini CLI.»
Документация geminicli.com при этом местами не обновлена: баннер на сайте всё ещё обещает замену «для unpaid tier», а README репозитория описывает старый бесплатный тариф (60 запросов/мин и 1000 в день) — ориентируйтесь на страницу deprecation, а не на README.
Что работает сейчас:
| Способ входа | Кто подходит | Лимиты |
|---|---|---|
| API-ключ Google AI Studio | новички и индивидуальные разработчики | бесплатно: 250 запросов/день, только Flash-модели; далее pay-as-you-go |
| Vertex AI (Express Mode) | те, кто уже в Google Cloud | ~90 дней без включения биллинга, лимиты по аккаунту |
| Gemini Code Assist Standard/Enterprise | организации | 1500 / 2000 запросов на пользователя в день |
| ~~Вход с Google-аккаунтом~~ | — | отключён 18.06.2026 |
Источник цифр — Quotas and pricing (обновлена 18.06.2026).
Путь 1 (рекомендуемый): API-ключ
- Зайдите в Google AI Studio и создайте API-ключ.
- Пропишите его в переменную окружения:
export GEMINI_API_KEY="ваш_ключ"
- Запустите
geminiи выберите пункт Use Gemini API key.
Чтобы ключ не пропадал между сессиями, добавьте строку в ~/.zshrc (или ~/.bashrc), либо положите его в .gemini/.env — Gemini CLI читает этот файл автоматически (аутентификация).
Путь 2: Vertex AI
Для команд и тех, кто уже работает с Google Cloud: вход через Vertex AI (Application Default Credentials через gcloud auth application-default login или service account) с обязательными переменными GOOGLE_CLOUD_PROJECT и GOOGLE_CLOUD_LOCATION. Express-режим даёт ~90 дней без включения биллинга, дальше — оплата за токены.
Первый запуск и базовые команды
Запуск в директории проекта:
cd /путь/к/проекту
gemini
Дальше — обычный разговор на естественном языке. Примеры промптов, которые реально работают:
> Объясни, что делает модуль auth.py, и найди в нём потенциальные проблемы
> Напиши тесты для функции parse_config и запусти их
> Собери проект и почини ошибки компиляции
> Создай файл GEMINI.md с правилами этого репозитория
Headless-режим для скриптов и CI:
gemini -p "Объясни архитектуру этой кодовой базы" --output-format json
Полезные команды внутри сессии:
/model— выбор модели и роутинга (Auto / Pro); конкретная модель задаётся флагом:gemini -m gemini-3.1-pro-preview(preview-доступ по мере появления);/skills— список подключённых Skills;/stats— текущий расход токенов и лимиты;/help— все команды.
Контекст проекта — файл GEMINI.md: агент читает его в начале каждой сессии, туда складывают стек, команды сборки и правила (подробнее — документация). Внешние инструменты подключаются MCP-серверами через ~/.gemini/settings.json:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
После этого в чате можно писать @github Покажи мои открытые пул-реквесты.
Модели Gemini API на август 2026
По списку моделей (обновлён 05.08.2026), из стабильных для кодинга доступны три Flash-модели:
| Модель (id в API) | Что это | Для чего |
|---|---|---|
gemini-3.6-flash |
последняя модель, баланс скорости и интеллекта | агентные и мультимодальные задачи: работа с кодом, файлами, изображениями; основная рабочая лошадка |
gemini-3.5-flash |
самый интеллектуальный в семействе 3.5 | сложные агентные и кодинг-задачи, длинные сессии, где важнее качество, чем скорость |
gemini-3.5-flash-lite |
самая быстрая и дешёвая модель 3.5 | высоконагруженные сценарии: парсинг, суммаризация, простые правки, массовые запросы |
Gemini 3.1 Pro доступен в preview (для самых сложных задач), а модели 2.5 — как fallback при исчерпании лимитов. Бесплатный тариф API-ключа (250 запросов/день) работает с Flash-семейством — для знакомства этого достаточно.
Gemini API через OpenAI-совместимый endpoint
Если вы уже пользуетесь инструментом, который понимает только OpenAI API (например, Aider, OpenCode или собственные скрипты на openai SDK), модели Gemini подключаются через официальный OpenAI-совместимый endpoint — меняются всего три строки: ключ, base URL и имя модели (документация):
from openai import OpenAI
client = OpenAI(
api_key="GEMINI_API_KEY",
base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
response = client.chat.completions.create(
model="gemini-3.6-flash",
messages=[{"role": "user", "content": "Объясни, как работает этот код"}],
)
print(response.choices[0].message)
Тот же ключ из AI Studio подходит и Gemini CLI, и OpenAI-совместимым клиентам. Эндпоинт поддерживает chat completions, стриминг, function calling, эмбеддинги и batch-запросы.
Gemini CLI → Antigravity CLI: что происходит
19 мая 2026 на Google I/O Google объявил, что развивать терминальный агент продолжит в рамках платформы Antigravity 2.0, а открытый Gemini CLI останется в режиме поддержки (официальный анонс):
We’re unifying our efforts into Google Antigravity, our premier agent-first development platform, which includes a powerful server-side harness and a brand-new terminal experience: Antigravity CLI.
«Мы объединяем усилия вокруг Google Antigravity — нашей основной agent-first платформы разработки, в которую входит развитая серверная обвязка и новый терминальный опыт: Antigravity CLI.»
Что это значит на практике:
- Antigravity CLI — закрытый (closed source), написан на Go, ориентирован на мультиагентные сценарии и фоновые задачи. Сохранил ключевое из Gemini CLI: Skills, Hooks, Subagents, расширения (теперь в виде Antigravity-плагинов). Миграционный гайд — на antigravity.google/docs/gcli-migration.
- Gemini CLI — остаётся open source, релизы продолжают выходить еженедельно, но новые возможности в первую очередь появляются в Antigravity CLI. Поддержка enterprise-лицензий (Code Assist Standard/Enterprise) и работы через API-ключи не прекращалась.
Для новой установки в августе 2026 выбор простой: если нужен open source и знакомый инструмент — Gemini CLI через API-ключ; если важны мультиагентность и свежие фичи — стоит смотреть в сторону Antigravity CLI.
Российские реалии
Специфика доступа из РФ — по опыту тех, кто уже работает с экосистемой Gemini:
- Бесплатный веб-Gemini (gemini.google.com) иногда открывается без VPN, но Google блокирует по IP и по стране аккаунта — типична ошибка «Gemini is not available in your country» (разбор ситуации, с комментариями пользователей за май–июль 2026).
- API-ключ из Google AI Studio — самый рабочий путь из РФ: ключ создаётся с обычным Google-аккаунтом, бесплатный тариф (250 запросов/день) не требует привязки карты. Если IP заблокирован, помогает VPN с «чистым» иностранным адресом.
- Регистрация Google-аккаунта из РФ — возможна с VPN: страна аккаунта привязывается к IP, с которого он регистрировался, поэтому через VPN-выход заводится обычный аккаунт, а от него — API-ключ. Карта для бесплатного тарифа не нужна.
- Оплата — карты РФ (Visa/Mastercard, Mir) для биллинга Google не принимаются. Те, кому нужны платные лимиты, используют посредников (Oplatym, EasyCrds, Global-Payments), зарубежные карты (Казахстан, Узбекистан, Киргизия) или VPS в Европе за €5–10/мес, с которого ходят запросы к Google (там же).
- Antigravity из РФ — с региональной блокировкой: при запуске «Not available in your region», нужен Google-аккаунт со страной не РФ (зарегистрировать его из РФ можно с VPN, но страна аккаунта должна быть не российская; смена — через policies.google.com/country-association-form, обработка ~3 часа) и стабильный VPN (plaan.ai, раздел «Ситуация с доступом в России»).
- Русскоязычное сообщество собрало обход для Antigravity-семейства и Gemini CLI: анлокер на GitHub (256+ звёзд) правит региональный флаг в бинарниках и DNS для доменов Google; обсуждения — в Telegram-чате t.me/nova_txt.
- Обзор экосистемы по-русски: «Google Antigravity и Gemini 3 Pro» на Habr — как российские разработчики экспериментируют с Gemini API через AI Studio.
Коротко для РФ: аккаунт Google регистрируется с VPN, Gemini CLI ставится штатно (npm), вход — через API-ключ AI Studio, бесплатный тариф работает; платные лимиты и Antigravity CLI требуют зарубежной карты/посредника и VPN.
Советы для безопасного старта
- Начните на пет-проекте, не на продакшене. Первые сессии — «объясни код», «напиши тесты», а не «перепиши всё».
- Коммитьте до изменений и просматривайте диффы: агент вносит правки в файлы, ошибки случаются.
- Не отключайте песочницу без причины — по умолчанию shell-команды выполняются в изолированном окружении, это снижает риск.
- Следите за расходом:
/statsпоказывает токены и лимиты; на бесплатном тарифе 250 запросов в день хватает на десятки небольших задач. - Для RU-аккаунта Google держите один и тот же VPN-выход — смена IP может спровоцировать проверку безопасности аккаунта.
Ограничения (честно)
- Переходный статус инструмента. Новые функции Google закладывает в Antigravity CLI; судьба открытого Gemini CLI в долгосрочной перспективе не гарантирована. Для продакшн-процессов стоит следить за анонсами Google.
- Устаревшая документация. README и часть страниц geminicli.com до сих пор описывают вход с Google-аккаунтом, которого больше нет. Проверяйте инструкции по дате обновления.
- Бесплатный тариф скромный. 250 запросов/день и только Flash-модели — для изучения хватает, для постоянной работы понадобится pay-as-you-go через API-ключ или Vertex AI (а это уже оплата с не-российской карты).
- Закрытый Antigravity. Преемник — не open source; если для вас принципиален открытый код, остаётесь на Gemini CLI.
- Безопасность. Агент выполняет команды и читает файлы — при работе с чувствительными данными используйте песочницу и не открывайте агенту лишние директории.
Частые вопросы
Нужна ли подписка, чтобы пользоваться Gemini CLI? Нет. Бесплатного тарифа через API-ключ AI Studio (250 запросов в день, Flash-модели) достаточно для знакомства. Подписки Google AI Pro/Ultra для Gemini CLI с 18.06.2026 не работают вовсе.
Чем Gemini CLI отличается от Antigravity CLI? Gemini CLI — открытый (Apache 2.0), релизы каждую неделю, но новые функции Google добавляет в первую очередь в закрытый Antigravity CLI (мультиагентность, фоновые задачи). Оба используют одни и те же Skills и модели Gemini.
Где хранится ключ и не протухнет ли он? Ключ задаётся переменной GEMINI_API_KEY или файлом .gemini/.env. Он не протухает сам по себе, но если ключ скомпрометирован или удалён в AI Studio — пересоздайте его и обновите переменную.
Работает ли Gemini CLI в России? Да, через API-ключ AI Studio — бесплатный тариф не требует карты и биллинга. Для стабильности лучше держать один VPN-выход. Платные лимиты и Antigravity CLI требуют зарубежной карты/посредника (подробности — в разделе «Российские реалии»).
Итог
Gemini CLI — рабочий, бесплатный для старта терминальный AI-агент от Google: установка через npm занимает минуту, вход через API-ключ AI Studio не требует карты, а модели Gemini 3 с контекстом 1 млн токенов хватает на реальные задачи. Главное, что нужно знать в августе 2026: способ входа изменился (вход с Google-аккаунтом отключён), а стратегически Google развивает Antigravity CLI — так что следить стоит за обоими.
Из России это один из немногих агентов, который заводится без подписки: ключ AI Studio, бесплатный тариф, VPN для стабильности. Попробуйте на маленькой задаче — «объясни этот модуль» или «напиши тесты» — этого достаточно, чтобы понять, ваш ли это инструмент.
Дальше по серии «Агентный кодинг для программистов»: общая вводная — «Что такое агентный кодинг», бесплатный старт — «Как установить OpenCode», настройка и подписки — «Как установить Claude Code», курсор-новинки — «Как пользоваться Cursor», подключение внешних данных — «Что такое MCP», файлы-конвенций — «AGENTS.md», локальные модели — «Aider и локальные модели».