Gemini CLI: что это, как установить и лимиты в 2026

Gemini CLI, открытый ИИ-агент Google для терминала, устанавливается командой npm install -g @google/gemini-cli. С 18 июня 2026 личный аккаунт Google в нём не работает: для входа нужен платный ключ Gemini API или корпоративная лицензия Code Assist Standard/Enterprise, а бесплатной заменой для частного лица служит Antigravity CLI (сообщение Google).

Что такое Gemini CLI и зачем он нужен

Gemini CLI нужен для работы с проектом из терминала: вы пишете задачу обычными словами, а агент читает файлы, генерирует и правит код, запускает команды. В веб-версии Gemini вы общаетесь в браузере; CLI получает доступ к папке вашего проекта, понимает структуру кода и сам находит нужные файлы. Исходный код открыт, а пакет публикуется в npm под именем @google/gemini-cli.

Агент использует модели Gemini (в 2026 году это семейство Gemini 3) с окном контекста до 1 миллиона токенов, поэтому может держать в памяти почти весь проект сразу (сравнение инструментов, DataCamp).

Что умеет Gemini CLI

• Gemini CLI пишет код с нуля по текстовому описанию и объясняет, что делает уже готовый.
• Читает и редактирует сразу несколько файлов проекта.
• Запускает команды в терминале: установку зависимостей, тесты, работу с git.
• Отвечает на вопросы по кодовой базе, ищет ошибки, предлагает рефакторинг.
• Разбирает документы, собирает тексты и планы.

Как установить Gemini CLI: пошагово

Для установки Gemini CLI нужны Node.js 20.0.0+ и подключение к интернету. Инструмент работает на Windows, macOS и Linux; Google рекомендует macOS 15+, Windows 11 24H2+ или Ubuntu 20.04+ и оболочку Bash, Zsh либо PowerShell. В требованиях Gemini CLI также указано, что пользоваться им следует из региона, где поддерживается Gemini Code Assist. Для установки через Homebrew на macOS/Linux используйте brew install gemini-cli. Можно запустить агент без постоянной установки командой npx @google/gemini-cli. Если пакет уже установлен через npm, обновите его командой npm install -g @google/gemini-cli@latest.

1. Установите Node.js версии 20 или выше. Проверить версию можно командой node -v, а скачать Node.js с официального сайта.
2. Установите пакет командой npm install -g @google/gemini-cli. Флаг -g ставит его глобально, чтобы команда была доступна из любой папки.
3. Получите ключ Gemini API в Google AI Studio и включите для него оплату (billing): Google обещает сохранять доступ к Gemini CLI именно по платным ключам. Затем задайте переменную окружения GEMINI_API_KEY: на macOS/Linux командой export GEMINI_API_KEY="ВАШ_КЛЮЧ", в Windows PowerShell командой $env:GEMINI_API_KEY="ВАШ_КЛЮЧ" (вход по ключу).
4. Запустите инструмент командой gemini в папке вашего проекта и выберите «Use Gemini API key». Вход через личный аккаунт Google больше не работает. Аккаунт компании, школы или Google Workspace с лицензией Code Assist Standard либо Enterprise входит через «Sign in with Google»; для этого нужен проект Google Cloud. Сам по себе личный аккаунт или подписка Google AI Pro/Ultra такого доступа не дают. Для работы через Vertex AI предусмотрен отдельный способ входа.
5. Напишите первую задачу текстом, например: «прочитай файлы проекта и добавь кнопку на главную страницу».

По теме: Codex vs Claude Code, Cursor и Copilot: что выбрать в 2026

Бесплатные лимиты и что изменилось в июне 2026

Бесплатного входа через личный аккаунт Google в Gemini CLI больше нет. До его отключения тариф давал до 1000 запросов в день и 60 в минуту (README Gemini CLI); эти лимиты относятся к прежнему доступу и больше не действуют для личного аккаунта.

Google объявил о переходе на Antigravity CLI 19 мая 2026 года, а 18 июня 2026 Gemini CLI перестал обслуживать бесплатный Gemini Code Assist for individuals и подписки Google AI Pro и Ultra. Для этих пользователей Google предлагает Antigravity CLI. Новый клиент написан на Go.

У Antigravity CLI план Individual стоит 0 $ в месяц и включает базовые недельные лимиты. Бесплатная квота обновляется раз в неделю, у Google AI Pro и Ultra каждые пять часов до недельного предела. Точных чисел Google не публикует: по описанию планов квота зависит от доступной мощности сервиса, а доступ к CLI входит во все планы.

Исходный код Antigravity CLI закрыт, пишет The New Stack. Gemini CLI остаётся открытым под Apache 2.0 и получает обновления моделей. Доступ по лицензиям Code Assist Standard и Enterprise, через Vertex AI, платные ключи Gemini API и Gemini Enterprise Agent Platform сохранился.

Как поставить Antigravity CLI вместо Gemini CLI

Чтобы поставить Antigravity CLI, выполните команду официального установщика для вашей системы, затем запустите agy и войдите через аккаунт Google при первом запуске. На macOS и Linux:

curl -fsSL https://antigravity.google/cli/install.sh | bash
agy

В Windows используйте PowerShell:

irm https://antigravity.google/cli/install.ps1 | iex
agy

Если переходите с Gemini CLI, следуйте гайду миграции Google. Выбрать между ним и агентом OpenAI поможет сравнение Codex и Antigravity.

По теме: Как установить Codex в 2026: приложение на Windows и Mac, CLI и IDE

Как пользоваться Gemini CLI из России

Из России Gemini CLI используют с ключом Gemini API через VPN: России нет в списке регионов Google AI Studio и Gemini API. Вход личным аккаунтом Google в Gemini CLI отключён во всех странах, поэтому смена IP его не вернёт.

1. Для Gemini CLI получите ключ Gemini API через VPN и подключите платёжный аккаунт Google Cloud, чтобы использовать платный ключ. Оплату проводят зарубежной картой.
2. Для бесплатной работы поставьте Antigravity CLI и войдите личным аккаунтом Google через VPN.
3. Если у организации есть лицензия Code Assist Standard или Enterprise, используйте её аккаунт и проект Google Cloud для входа в Gemini CLI.
4. Для других клиентов можно использовать API-агрегаторы с оплатой в рублях и OpenAI-совместимым доступом (гайд по оплате). В Gemini CLI предусмотрены способы входа через аккаунт Google, ключ Gemini API и Vertex AI, поэтому OpenAI-совместимый ключ агрегатора напрямую в него не подставить.

Держите VPN одной страны, не меняйте регион между сессиями и используйте карту и данные аккаунта из той же страны, чтобы снизить риск проблем с доступом.

На 7 октября 2026 года цены Google AI в США составляют 19,99 $ в месяц за Pro и от 99,99 $ в месяц за Ultra. Эти подписки дают больше лимитов в Antigravity; вход личным аккаунтом в Gemini CLI остаётся отключённым.

Gemini в браузере на gemini.google.com работает отдельно от CLI; для него есть инструкция по использованию Gemini, включая доступ из России.

Создайте пустую папку, поставьте Gemini CLI и дайте ему простую задачу вроде «сделай страницу-визитку». Так вы поймёте логику агента до того, как пустите его в рабочий проект. Агент выполняет команды с вашими правами: пустая папка снижает риск, но не гарантирует безопасность.

Gemini CLI против Claude Code и Codex CLI

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

• Claude Code от Anthropic входит в Pro и Max. Pro стоит 20 $ в месяц или 17 $ в месяц при оплате за год; Max стоит от 100 $ в месяц. На бесплатном плане Claude Code нет.
• Codex CLI от OpenAI доступен с ChatGPT Plus за 20 $ в месяц на моделях GPT-6.1 Sol и GPT-6 Luna. На Free и Go за 8 $ в месяц Codex доступен только в настольном приложении. С API-ключом работа оплачивается по тарифам API. GPT-5.5 уходит из Codex 14 октября 2026 года.
• Gemini CLI от Google сохраняет большое окно контекста, но вход через личный аккаунт Google отключён. Бесплатная работа у Google теперь доступна в Antigravity CLI.

Для сложных задач и рефакторинга с правками сразу в десятках файлов можно выбрать Claude Code. Если нужно уместить кодовую базу в контекст Gemini, частному лицу доступны Gemini CLI с платным API-ключом или Antigravity CLI. Codex для вайбкодинга удобен, если у вас уже оплачен ChatGPT Plus. Сопоставить способы входа и стоимость помогает сравнение Codex, Claude, Cursor и Copilot.

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

Gemini CLI бесплатный?

Для личного аккаунта бесплатный вход в Gemini CLI отключён с 18 июня 2026. Бесплатно у Google работает Antigravity CLI: план Individual за 0 $ с недельной квотой. Gemini CLI доступен с платным ключом Gemini API, через Vertex AI или по лицензии Code Assist Standard/Enterprise. У Gemini API есть бесплатный уровень для части моделей. Однако Google обещает сохранять доступ к Gemini CLI именно по платным ключам, поэтому возможность работы и лимиты бесплатного ключа проверяйте в AI Studio.

Нужно ли уметь программировать, чтобы пользоваться Gemini CLI?

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

Чем Gemini CLI отличается от Gemini на сайте?

Веб-версия открывается как чат в браузере. CLI работает в терминале, видит файлы вашего проекта и может сам их менять и запускать команды.

Работает ли Gemini CLI на Windows?

Да, инструмент кроссплатформенный. Нужен установленный Node.js 20 или новее, а дальше команда та же, что на macOS и Linux.

Что теперь ставить, Gemini CLI или Antigravity CLI?

С личным аккаунтом без корпоративной лицензии для бесплатной работы ставьте Antigravity CLI. Если у вас есть платный ключ Gemini API, Vertex AI или лицензия Code Assist Standard/Enterprise, можно оставаться на Gemini CLI: Google поддерживает его и обновляет модели.