Gemini CLI: как установить, куда делся бесплатный доступ и как работать из России

Что такое Gemini CLI и кому он нужен в 2026 году?

Gemini CLI — открытый агент Google для терминала. Он читает и правит код в папке проекта, запускает команды оболочки, загружает веб-страницы и ищет в Google. Постоянные инструкции агент берет из файла GEMINI.md, внешние сервисы подключает по MCP. Есть неинтерактивный режим для скриптов.

Код лежит на GitHub в репозитории google-gemini/gemini-cli под лицензией Apache 2.0. На 29 октября 2026 года у него 108,6 тыс. ★ репозитория, последний стабильный выпуск в npm 0.66.0, предварительный — 0.67.0-preview.0. Стабильные и предварительные сборки выходят каждую неделю по вторникам, ночные каждый день. В каталоге SkillFoxx агент описан в карточке Gemini CLI и на странице агента.

Сейчас README прямо называет аудиторию: владельцы лицензий Gemini Code Assist Standard и Enterprise и разработчики с платным ключом API. Если вы пришли за бесплатным агентом в терминале, сначала прочитайте следующий раздел.

Есть ли у Gemini CLI бесплатный тариф?

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

Кого перемена не задела:

• организации с лицензиями Gemini Code Assist Standard и Enterprise;
• разработчиков, которые входят по ключу Gemini API с оплатой по факту;
• проекты в Google Cloud, которые работают через Vertex AI.

У Google в терминале теперь один бесплатный путь — Antigravity CLI с командой agy. На странице цен Antigravity у бесплатного тарифа Individual указаны безлимитные автодополнения и «базовые недельные лимиты» для агента, без числа запросов. Antigravity CLI закрыт, исходного кода нет. Установщик сам находит папку Gemini CLI и переносит скиллы, MCP-серверы, профили агентов и файлы GEMINI.md.

Тарифы Gemini API, бесплатный уровень AI Studio и подписки Google AI подробно разобраны в статье Gemini бесплатно, здесь их нет.

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

Требования из документации на 29 октября 2026 года: macOS 15 и новее, Windows 11 24H2 и новее или Ubuntu 20.04 и новее, Node.js 20.0.0 и выше, от 4 ГБ памяти для обычной работы и от 16 ГБ для длинных сессий и больших репозиториев. Нужен доступ в интернет.

1. Проверьте версию Node.js командой node --version. Если она ниже 20, обновите ее с nodejs.org.
2. Поставьте агента глобально командой npm install -g @google/gemini-cli.
3. Если ставить не хочется, запустите его разово через npx @google/gemini-cli.
4. Команда npm ls -g @google/gemini-cli покажет установленную версию.
5. Запустите агента в папке проекта командой gemini.

Другие способы из README: brew install gemini-cli на macOS и Linux, sudo port install gemini-cli через MacPorts, пакет conda. Предварительная сборка ставится командой npm install -g @google/gemini-cli@preview, ночная — через тег @nightly. Для работы стабильная версия надежнее: в preview и nightly бывают регрессии.

Обновить агента можно той же командой с тегом: npm install -g @google/gemini-cli@latest.

Как установить Gemini CLI на Windows?

На Windows порядок тот же, оболочка PowerShell. По документации нужна Windows 11 24H2 или новее. Поставьте Node.js 20 или новее с nodejs.org, откройте новое окно PowerShell и выполните npm install -g @google/gemini-cli. Команда gemini после этого доступна в любой папке.

Файлы настроек на Windows лежат в профиле пользователя: %USERPROFILE%\.gemini\. Там же агент ищет файл .env с ключом, если не нашел его в папке проекта.

Как войти в Gemini CLI: ключ API, Vertex AI или лицензия?

При первом запуске агент предлагает способ входа. Документация перечисляет три.

• Вход через аккаунт Google. Работает для организаций с лицензией Code Assist, им нужна переменная GOOGLE_CLOUD_PROJECT с номером проекта. Бесплатные и личные аккаунты с 18 июня отправлены в Antigravity.
• Ключ Gemini API из Google AI Studio. Задайте GEMINI_API_KEY в переменной окружения или в файле .gemini/.env и выберите вход по ключу. README называет этот путь оплатой по факту использования.
• Vertex AI. Нужны GOOGLE_CLOUD_PROJECT и GOOGLE_CLOUD_LOCATION, а вход через gcloud, ключ сервисного аккаунта или GOOGLE_API_KEY вместе с GOOGLE_GENAI_USE_VERTEXAI=true.

Файл .env агент ищет вверх от текущей папки, затем в ~/.gemini/.env. Значения берутся из первого найденного файла, файлы не объединяются. Ключ держите вне репозитория: Google в документации просит обращаться с ним как с паролем.

Еще одна оговорка из README: Gemini CLI не настроен под модели серии Gemini 4. Для них Google советует Antigravity.

Как подключить MCP-сервер к Gemini CLI?

MCP-сервер дает агенту доступ к внешнему сервису: базе, браузеру, таблицам. Серверы описываются в объекте mcpServers файла settings.json. Пользовательский файл лежит в ~/.gemini/settings.json, проектный — в .gemini/settings.json.

Быстрее всего добавить сервер командой. Документация дает синтаксис gemini mcp add [опции] <имя> <команда или адрес> [аргументы]. Удаленный сервер по HTTP добавляется так: gemini mcp add --transport http имя https://адрес/mcp/. Флаг -s выбирает файл: по умолчанию проект, -s user пишет в пользовательский. Команда /mcp внутри агента показывает серверы, статус подключения и список инструментов.

Две настройки сервера стоит знать до первого запуска. Поле includeTools оставляет только перечисленные инструменты, остальные агенту не видны. Поле trust: true отключает подтверждение каждого вызова, по умолчанию доверие выключено. Я бы не включал его для серверов, которые пишут в данные.

Серверы из каталога SkillFoxx ставятся в Gemini CLI одной командой с флагом агента. Например, npx skillfoxx add mcp/excel-mcp-server --agent gemini-cli --dry-run покажет план: какой файл изменится и какой уровень доступа у сервера. Без --dry-run команда запишет сервер в настройки. Подробнее о CLI каталога в статье как поставить MCP и скиллы одной командой.

Как поставить скиллы в Gemini CLI?

Скиллы в Gemini CLI сделаны по открытому стандарту Agent Skills: папка с файлом SKILL.md, который агент читает, когда задача совпала с описанием. Поэтому скилл, написанный для Claude Code или Codex, обычно работает и здесь.

Агент ищет скиллы в четырех местах, от низшего приоритета к высшему:

1. встроенные в Gemini CLI;
2. внутри установленных расширений;
3. пользовательские: ~/.gemini/skills/ или ~/.agents/skills/;
4. проектные: .gemini/skills/ или .agents/skills/ в папке проекта.

При совпадении имен побеждает более высокий уровень. Поставить скилл из репозитория можно командой gemini skills install <адрес git> --consent, флаг --path укажет подпапку. Список покажет gemini skills list --all, внутри сессии работают /skills list, /skills enable и /skills disable.

Что поставить первым из каталога:

• Скиллы Anthropic, 184,5 тыс. ★ репозитория: официальные примеры, среди них docx, pdf, pptx и xlsx для работы с офисными файлами. Скрипты скиллов обрабатывают файлы на диске.
• Gemini Skills, 4,4 тыс. ★ репозитория: три скилла команды Google Gemini с актуальными правилами Gemini API, Live API и генерации видео. Им нужен свой ключ API.

Какие расширения есть для Gemini CLI?

Расширение — пакет, который приносит сразу несколько вещей: MCP-серверы, свои команды, хуки, субагентов, скиллы и темы. Ставится по адресу репозитория, например gemini extensions install https://github.com/gemini-cli-extensions/workspace. Список установленных покажет gemini extensions list, общий каталог Google лежит на geminicli.com/extensions.

В каталоге SkillFoxx три расширения с проверкой и описанием на русском:

• Google Workspace для Gemini CLI: документы, таблицы, презентации, Drive, почта, чат и календарь из терминала. Сервер может читать, менять и удалять данные аккаунта, поэтому уровень доступа высокий. Авторы сами предупреждают о промпт-инъекциях через письма и документы.
• Расширение безопасности: команда /security:analyze разбирает изменения ветки на уязвимости, /security:scan-deps сверяет зависимости с базой OSV.dev. Нужна версия 0.4.0 и новее.
• Stitch Extension: команда /stitch работает с проектами Google Stitch, скачивает экраны картинкой или HTML. Нужна версия 0.19.0 и новее.

Для GitHub есть официальное действие Run Gemini CLI: агент проверяет pull request и разбирает issues прямо в Actions. Ему нужен секрет GEMINI_API_KEY или ключ Vertex AI, а права токена лучше сузить заранее, потому что бот правит репозиторий.

Насколько безопасен Gemini CLI?

Агент запускает команды в вашей системе, поэтому опасность зависит от режима. В мае 2026 года SecurityWeek писал об уязвимости с оценкой CVSS 10 из 10, которую нашла Pillar Security: в режиме --yolo агент игнорировал список разрешенных инструментов, и спрятанный в issue промпт мог захватить агента в GitHub Actions. Google закрыла уязвимость 24 апреля в версии 0.39.1 и обновила действие run-gemini-cli.

Что я бы сделал до работы с чужим кодом:

• держал версию свежей, сейчас это 0.66.0;
• не включал --yolo и trust: true в репозиториях с внешними issues;
• ограничивал MCP-серверы через includeTools;
• отдавал токену GitHub Actions только нужные права.

Сколько токенов и денег ушло на работу агента, покажет ccusage: утилита читает локальные журналы Gemini CLI, Claude Code, Codex и OpenCode.

Работает ли Gemini CLI в России?

Установить агента можно, потому что пакет лежит в npm, а исходный код на GitHub. Войти и работать с моделями из России нельзя. Россия не входит в список регионов Gemini API на ai.google.dev, а за его пределами Google предлагает только Gemini в своей корпоративной облачной платформе. Antigravity CLI тоже требует аккаунт Google и работает на моделях Gemini. Оплатить сервисы Google российской картой нельзя.

Инструкций по VPN я не даю. Google открывает сервис по своему списку стран, и доступ из России может пропасть вместе с историей и настройками. Доступ через общие аккаунты или чужие ключи закрывают без предупреждения.

Законные варианты для работы с кодом из России:

• открытый агент OpenCode для терминала, который подключается к разным поставщикам моделей и к локальным моделям;
• локальная модель через Ollama, о ней статья локальная нейросеть: данные не уходят с компьютера;
• SkillFoxx API в закрытой бете: один ключ к GPT, Claude, Gemini и DeepSeek с оплатой в рублях. Шлюз принимает форматы OpenAI и Anthropic, поэтому к нему подключаются Claude Code, Codex и OpenCode. Gemini CLI работает с форматом Gemini API, и его совместимость со шлюзом пока не проверена.

Скиллы и MCP-серверы из этой статьи от модели не зависят и переносятся в любой из этих агентов.

Gemini CLI, Antigravity CLI или Claude Code: что выбрать?

Gemini CLI остается выбором для команд с лицензией Code Assist, проектов в Google Cloud и тех, кто платит за Gemini API по факту. У него открытый код, стабильные выпуски каждую неделю и большой набор расширений. Минус в том, что Google развивает основной продукт в Antigravity и модели Gemini 4 советует запускать там.

Antigravity CLI подходит тем, кто хочет агента Google с бесплатным стартом и готов к закрытому коду и недельным лимитам без опубликованных чисел. Главные альтернативы вне экосистемы Google (Claude Code и Codex) сравниваются в статье Codex или Claude Code. Для Codex есть отдельный разбор скиллов, MCP и первых шагов.

Короткий глоссарий

• Gemini CLI — открытый агент Google для терминала на моделях Gemini.
• Antigravity CLI — закрытый преемник Gemini CLI с командой agy, сюда Google перевела бесплатных пользователей.
• GEMINI.md — файл с постоянными инструкциями для агента в папке проекта.
• MCP-сервер — программа-посредник, через которую агент работает с внешним сервисом.
• Скилл — папка с SKILL.md, которая учит агента одной задаче.
• Расширение — пакет для Gemini CLI с MCP-серверами, командами, хуками и скиллами.
• Vertex AI — облачная платформа Google Cloud, через которую корпоративные клиенты получают модели Gemini.

Что дальше

Если Gemini CLI у вас уже работает, начните с одного MCP-сервера на чтение и одного скилла под частую задачу. Готовые записи для Gemini CLI собраны в разделе CLI и в карточках выше, у каждой указан уровень доступа и команда установки. Если вы не знаете, что поставить под свой проект, опишите задачу в подборе с Foxx AI на главной: он подберет скиллы и серверы из каталога.