Gemini CLI: установка и доступ из России
Главное на сентябрь 2026: бесплатного входа по личному Google-аккаунту больше нет — 18 июня Google перестал обслуживать личные аккаунты и предлагает переходить на Antigravity CLI. Разбираем, что осталось рабочего, как ставится агент и почему России нет в списке стран Google.
Gemini CLI это открытый агент Google для терминала: ставится командой npm install -g @google/gemini-cli, требует Node.js версии 20 или выше и работает с файлами в той папке, из которой запущен. Сама программа жива и обновляется, но 18 июня 2026 года Google перестал обслуживать через неё запросы личных аккаунтов, включая бесплатные и подписки Google AI Pro и Ultra. Осталось два рабочих пути: ключ Gemini API и Vertex AI, и оба упираются во вторую сложность — России нет в официальном списке стран, где эти сервисы доступны.
Проверено 1 сентября 2026
Официальное объявление опубликовано 18 июня 2026 года в обсуждениях самого репозитория и называется «Gemini CLI перестал обслуживать запросы личных аккаунтов». Затронуты бесплатный уровень, Google AI Pro и Google AI Ultra; не затронуты корпоративные пользователи с лицензиями Gemini Code Assist по API-ключу. На официальной странице тарифов висит баннер о замене на Antigravity CLI с 18 июня. При этом README проекта и внутренняя документация Google до сих пор описывают бесплатный уровень как действующий — документация отстала от факта, и именно на ней построено большинство статей в выдаче.
Что узнаешь из гайда
- Четыре способа установки и что нужно до неё
- Три способа входа: аккаунт, ключ, Vertex AI
- Настоящие цифры лимитов, без маркетинга
- Что именно ломается при работе из России
- Чем заменить: четыре живых терминальных агента
Часть 1 · Что это
Что это за инструмент
Главное
Это не веб-версия Gemini и не отдельная программа с окнами. Это команда в терминале, которая читает и правит ваши файлы.
У Google сейчас три разных входа в одни и те же модели, и их постоянно путают. Веб-версия по адресу gemini.google.com это чат в браузере, про него отдельный разбор: как пользоваться нейросетью Gemini. Antigravity это агентная среда с графическим интерфейсом, окнами и панелями, разбор Antigravity здесь. А Gemini CLI это агент в командной строке.
Разница принципиальная. Чат в браузере не видит ваш проект: всё, что ему нужно, вы приносите копипастом. Терминальный агент запускается внутри папки и работает с ней напрямую: читает файлы, правит их, запускает команды сборки и тестов, ходит в интернет за документацией. Это тот же класс инструментов, что Claude Code, Codex CLI у OpenAI и OpenCode.
| Свойство | Значение |
|---|---|
| Пакет | @google/gemini-cli, на 29 августа 2026 версия 0.57.0 |
| Лицензия | Apache 2.0, исходники открыты на GitHub |
| Требование | Node.js 20 или выше (поле engines в пакете) |
| Модели | семейство Gemini 3, контекст до миллиона токенов |
| Встроенное | поиск Google, работа с файлами, запуск команд оболочки, загрузка страниц, MCP |
Отдельно стоит отметить встроенное заземление на поиск Google. Для терминального агента это редкая вещь: большинство конкурентов ходят в интернет через сторонние инструменты, а здесь поиск свой и включён из коробки.
Часть 2 · Установка
Установка: четыре способа
Сначала проверьте Node.js. Пакету нужна версия 20 или выше, и это не рекомендация, а требование, записанное в самом пакете: на более старой версии установка упадёт с ошибкой EBADENGINE.
node --versionЕсли команда не найдена, сначала ставится Node.js, потом всё остальное. Дальше выбирайте способ.
npx @google/gemini-clinpm install -g @google/gemini-clibrew install gemini-clisudo port install gemini-cliПро Windows
Команда та же самая, но важно, в какой оболочке вы её набираете. Строка вида PS C:\Users\Имя> означает PowerShell, строка без PS означает CMD. Для npm разницы нет, а вот дальше она вылезет: многие инструкции пишут команды под одну оболочку и молчат об этом. Если терминал вы открываете впервые, начните с гайда терминал с нуля: как открыть и что там набирать.
У проекта три канала обновлений. Stable выходит по вторникам и ставится тегом latest, preview публикуется раньше и без полной проверки, nightly собирается каждый день из основной ветки. Если вам нужна работа, а не тестирование, берите stable, то есть обычную команду без тега.
Часть 3 · Вход
Три способа входа, и они не равнозначны
Установка это половина дела. Дальше агенту нужно доказать, что вы имеете право обращаться к моделям. Механик по-прежнему три, но рабочих из них с 18 июня 2026 года осталось две: вход по личному Google-аккаунту Google больше не обслуживает.
| Способ | Что даёт | Кому подходит |
|---|---|---|
| Личный Google-аккаунт | не обслуживается с 18 июня 2026, вместо него Antigravity CLI | больше никому |
| Ключ Gemini API | 250 запросов в сутки на бесплатном уровне, выбор конкретной модели, оплата по факту сверх лимита | тем, кто хочет управлять моделью и тратами |
| Vertex AI | корпоративные лимиты и договор с Google Cloud, платёжный аккаунт обязателен | командам с уже настроенным Google Cloud |
Ключ выпускается в Google AI Studio и передаётся агенту переменной окружения. На macOS и Linux это выглядит так:
export GEMINI_API_KEY="ваш_ключ"
geminiДля Vertex AI переменных две: GOOGLE_CLOUD_PROJECT с идентификатором проекта, где включён Vertex AI API, и GOOGLE_CLOUD_LOCATION с регионом, в котором вы хотите запускать задачи.
Ключ это не пароль от аккаунта
Ключ Gemini API отдаёт доступ к вашим лимитам и к вашему счёту любому, кто его получит. Не храните его в коде проекта и не коммитьте в репозиторий: боты вычёсывают публичные репозитории по шаблонам ключей за минуты. Правильное место это переменная окружения или менеджер секретов.
Часть 4 · Деньги
Лимиты и цена: что бесплатно на самом деле
Сам агент бесплатный и открытый, платите вы только за обращения к моделям. До 18 июня 2026 года бесплатный уровень у Google был самым щедрым в категории: тысяча запросов в сутки по обычному аккаунту. Этого больше нет — личные аккаунты через Gemini CLI не обслуживаются, и бесплатным остался только скромный уровень по ключу Gemini API. Контекст до миллиона токенов при этом никуда не делся.
| Как вошли | Потолок запросов в сутки |
|---|---|
| Google-аккаунт, бесплатно | не обслуживается с 18.06.2026 |
| Подписка Google AI Pro | не обслуживается с 18.06.2026 |
| Подписка Google AI Ultra | не обслуживается с 18.06.2026 |
| Ключ Gemini API, бесплатный уровень | 250 |
| Оплата по факту и Vertex AI | зависит от тарифа и региона |
Документация Google отстала от реальности
Это главная ловушка темы. README проекта и внутренняя страница квот до сих пор описывают бесплатный вход по личному аккаунту как действующий, хотя обслуживание прекращено. Мы проверили историю файла 1 сентября 2026: строка про бесплатный уровень в README не менялась с октября 2025 года. Верить в этом вопросе стоит объявлению в обсуждениях репозитория и баннеру на странице тарифов, а не рекламному блоку README.
Тонкость в том, что запрос это не «одна задача». Пока агент правит файл, читает соседний, запускает тесты и разбирает вывод, он тратит несколько запросов. Поэтому 250 запросов в сутки по бесплатному ключу API — это несколько точечных правок, а не рабочий день. Здесь работает та же арифметика, что и в других агентах: чем аккуратнее вы формулируете задачу и чем уже контекст, тем дольше живёт лимит. Разбор приёмов экономии есть в гайде почему быстро кончаются лимиты и как экономить токены.
Сравнение по деньгам
У Claude Code бесплатного тарифа нет вовсе, агент входит в платные планы (разбор цен и способов оплаты). У Codex CLI доступ идёт через подписку ChatGPT или ключ API. Раньше Gemini CLI выигрывал у обоих именно бесплатным входом, и после 18 июня 2026 года это преимущество исчезло. Как теперь выглядит расклад по бесплатным вариантам целиком, разобрано в хабе бесплатные ИИ-агенты.
Часть 5 · Регион
Доступ из России: что проверено
Коротко
Сетевой блокировки нет, но России нет и в списке стран, где Gemini API и AI Studio доступны официально.
Мы проверили это руками 29 августа 2026 года, а не пересказали чужой пост. Google публикует список поддерживаемых стран и территорий на странице документации Gemini API. Список алфавитный, и в нём после Romania сразу идёт Rwanda: России в перечне нет. Белоруссии тоже нет. Казахстан, Армения, Грузия и Украина при этом присутствуют.
Второй замер про сеть. Запрос с московского адреса на эндпоинт generativelanguage.googleapis.com с заведомо неверным ключом возвращает обычную ошибку 400 про неверный ключ. Это значит, что запрос доходит до сервиса и разбирается им: канал связи не перекрыт. Страница AI Studio с московского адреса тоже отвечает кодом 200.
Что из этого следует
Ограничение живёт не на уровне сети, а на уровне региона аккаунта и правил сервиса. Практически это выглядит так: установка проходит, команда запускается, а на входе или на первом же обращении к модели прилетает отказ, связанный с местоположением. Обещать обходной путь мы не будем: любые схемы со сменой региона нарушают правила Google и в любой момент заканчиваются блокировкой аккаунта, к которому у вас может быть привязана почта и документы.
Полезно понимать разницу между двумя видами ограничений. У Anthropic, например, ситуация похожая: инфраструктура из России отвечает, а упирается всё в правила про поддерживаемые страны и в верификацию личности. Подробный разбор этого механизма есть в гайде Claude не работает из России: что именно ломается.
Часть 6 · Работа
Как с ним работать каждый день
Запуск выглядит одинаково у всех терминальных агентов: переходите в папку проекта и вызываете команду.
cd ~/projects/moy-proekt
geminiДальше есть три вещи, которые превращают игрушку в рабочий инструмент.
Файл GEMINI.md. Кладётся в корень проекта и описывает правила: какой стек, какой стиль кода, что трогать нельзя, как запускать тесты. Агент читает его при старте, и вам не приходится повторять одно и то же в каждом запросе. Ровно та же идея, что у CLAUDE.md, про который есть отдельный разбор: как настроить файл проекта и что такое AGENTS.md и зачем он агентам.
MCP-серверы. Прописываются в ~/.gemini/settings.json и дают агенту доступ к внешним системам: репозиторию, базе, трекеру задач. Протокол общий для всей индустрии, поэтому сервер, поднятый ради Claude Code, подойдёт и сюда. Что это такое и какие серверы имеет смысл ставить первыми, разобрано в гайде по MCP-серверам.
Неинтерактивный режим. Агента можно запускать в скриптах и в GitHub Actions: он отработает задачу и вернёт результат без диалога. Это то, ради чего вообще существует терминальная версия, потому что графический интерфейс в конвейер не встроишь.
Порядок первого запуска
Проверить node --version → поставить пакет → выбрать способ входа → перейти в папку проекта → положить туда GEMINI.md с правилами → запустить gemini и дать первую маленькую задачу, а не переписывание половины кода.
Часть 7 · Замена
Чем заменить, если регион мешает
Терминальных агентов сейчас много, и они взаимозаменяемы по классу задач. Отличаются доступом, ценой и тем, на каких моделях работают.
| Агент | Чем берёт | Разбор |
|---|---|---|
| Claude Code | сильнее всех в длинных задачах с кодом, но платный | гайд для начинающих |
| Codex CLI | агент OpenAI, вход по подписке ChatGPT или по ключу | установка и команды |
| Qwen Code | агент Alibaba, открытый, дешёвый тариф на кодинг | установка и цена |
| OpenCode | открытый агент, подключается к любым моделям | модели и цена |
Если хочется остаться на моделях Google, есть ещё один вход: Antigravity, агентная среда с интерфейсом. Правила про регионы у Google общие, но набор поверхностей разный, и проверять доступ имеет смысл на каждой отдельно.
Часть 8 · Ошибки
Частые ошибки на старте
- EBADENGINE при установке. Node.js старее двадцатой версии. Обновляете Node.js и повторяете установку.
- command not found: gemini. Пакет встал, но каталог глобальных пакетов npm не попал в PATH. Лечится добавлением каталога в PATH и новым окном терминала. Тот же класс проблемы разобран по шагам в гайде про терминал с нуля.
- Права при npm install -g. На macOS и Linux не ставьте глобальные пакеты через sudo: это ломает права в каталоге npm. Правильнее настроить пользовательский префикс npm или ставить через Homebrew.
- Отказ по региону. Не лечится переустановкой. Это ограничение аккаунта, а не сборки.
- Агент видит слишком много. Запуск из домашней папки или с рабочего стола даёт агенту весь ваш диск в качестве контекста. Запускайте из папки проекта.
Чего делать не стоит
Не ставьте сборки Gemini CLI со сторонних сайтов и «репаков» с торрентов. Пакет открытый и бесплатный, официальные каналы это npm, Homebrew, MacPorts и GitHub. Любая другая раздача это чужой код с вашим ключом внутри.
FAQ
Частые вопросы
Что такое Gemini CLI простыми словами?
Это агент Google, который живёт в терминале и работает с файлами на вашем компьютере. Вы пишете задачу обычным текстом, а он сам читает и правит файлы, запускает команды, ищет в интернете через Google Search и подключается к внешним инструментам по протоколу MCP. Проект открытый, лицензия Apache 2.0, ставится одной командой. Ближайшие аналоги: Claude Code, Codex CLI от OpenAI и OpenCode.
Как установить Gemini CLI на Windows?
Нужен Node.js версии 20 или выше, это требование записано в самом пакете. Дальше в PowerShell выполняется npm install -g @google/gemini-cli, после чего команда gemini доступна в любом окне терминала. Попробовать без установки можно командой npx @google/gemini-cli. Если PowerShell отвечает, что gemini не распознан, каталог глобальных пакетов npm не попал в PATH, и терминал нужно перезапустить.
Сколько стоит Gemini CLI и остался ли бесплатный тариф?
Сам инструмент бесплатный и открытый, платить нужно за обращения к моделям. Бесплатного входа по личному Google-аккаунту больше нет: 18 июня 2026 года Google объявил, что Gemini CLI перестаёт обслуживать запросы личных аккаунтов, включая бесплатные и подписки Google AI Pro и Ultra, и предложил переходить на Antigravity CLI. Осталось два пути: ключ Gemini API, где бесплатный уровень по таблице квот даёт 250 запросов в сутки, и Vertex AI по договору с Google Cloud.
Почему в README проекта до сих пор написано про 1000 бесплатных запросов?
Потому что документация отстала от факта. Мы проверили историю файла 1 сентября 2026 года: строка про бесплатный уровень в README не менялась с октября 2025 года, а сам README не трогали с мая 2026. Внутренняя страница квот тоже описывает бесплатный вход как действующий. Объявление об отключении опубликовано отдельно, в обсуждениях репозитория, поэтому большинство статей в выдаче пересказывают устаревшую цифру.
Работает ли Gemini CLI из России?
Официально нет. В списке стран, где доступны Gemini API и Google AI Studio, России нет: список идёт по алфавиту и после Romania сразу следует Rwanda. Казахстан, Армения, Грузия и Украина в нём есть, Белоруссии тоже нет. При этом сетевой блокировки не наблюдается: с московского адреса эндпоинт generativelanguage.googleapis.com отвечает обычной ошибкой про неверный ключ. То есть упирается всё в регион аккаунта, а не в канал связи.
Чем Gemini CLI отличается от Antigravity?
Antigravity это агентная среда Google с графическим интерфейсом, целая программа с окнами и панелями. Gemini CLI живёт только в терминале: одна команда, никакого интерфейса, зато его удобно запускать по SSH на сервере и встраивать в скрипты и в GitHub Actions. Модели под ними общие, разница в способе давать работу и в том, сколько вы видите происходящего.
Какой файл отвечает за поведение агента в проекте?
GEMINI.md в корне проекта. Это обычный текстовый файл, в котором вы описываете правила: стек, стиль кода, что трогать нельзя, как запускать тесты. Агент читает его при старте, и дальше не приходится повторять контекст в каждом запросе. Логика та же, что у CLAUDE.md в Claude Code и AGENTS.md в других агентах.
Как подключить к Gemini CLI внешние инструменты?
Через MCP-серверы. Они прописываются в файле ~/.gemini/settings.json, после чего агент умеет обращаться к ним прямо из запроса: к GitHub, к базе данных и так далее. Тот же протокол используют Claude Code и остальные агенты, поэтому один и тот же MCP-сервер обычно подходит нескольким инструментам сразу.
Какие каналы обновлений есть у Gemini CLI?
Три. Stable выходит еженедельно по вторникам и ставится тегом latest. Preview публикуется тоже по вторникам, но раньше и без полной проверки, ставится тегом preview. Nightly собирается каждый день из основной ветки, тег nightly. Для работы берут stable, остальные каналы существуют для тех, кто готов ловить регрессии.
Читать дальше
Платформа и сообщество, где я по шагам показываю, как поставить ИИ на рутину: контент, код, продажи, аналитика. Заходи и забирай рабочие связки, которыми пользуюсь сам.
Посмотреть, что внутриtelegram
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.
