Gemini CLI: установка и доступ из России
Терминальный агент Google ставится одной командой и даёт тысячу бесплатных запросов в сутки. Разбираем установку, три способа входа, реальные лимиты и главную засаду: России нет в списке стран, где сервис доступен официально.
Gemini CLI это открытый агент Google для терминала: ставится командой npm install -g @google/gemini-cli, требует Node.js версии 20 или выше и работает с файлами в той папке, из которой запущен. Вход по личному Google-аккаунту даёт 60 запросов в минуту и 1000 в сутки на моделях Gemini 3. Главная сложность для нас не установка, а регион: России нет в официальном списке стран, где доступны Gemini API и AI Studio.
Что узнаешь из гайда
- Четыре способа установки и что нужно до неё
- Три способа входа: аккаунт, ключ, 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 · Вход
Три способа входа, и они не равнозначны
Установка это половина дела. Дальше агенту нужно доказать, что вы имеете право обращаться к моделям, и здесь у Google три разных механики с разными лимитами и разными последствиями для России.
| Способ | Что даёт | Кому подходит |
|---|---|---|
| Личный Google-аккаунт | 60 запросов в минуту, 1000 в сутки, модели Gemini 3 | тем, кто просто хочет попробовать |
| Ключ 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 · Деньги
Лимиты и цена: что бесплатно на самом деле
Сам агент бесплатный и открытый, платите вы только за обращения к моделям. Бесплатный уровень у Google щедрый по меркам конкурентов: 1000 запросов в сутки при входе по личному аккаунту и потолок в 60 запросов в минуту. Контекст до миллиона токенов означает, что в один запрос влезает большой кусок проекта целиком.
| Как вошли | Потолок запросов в сутки |
|---|---|
| Google-аккаунт, бесплатно | 1000 |
| Подписка Google AI Pro | 1500 |
| Подписка Google AI Ultra | 2000 |
| Ключ Gemini API, бесплатный уровень | 250 |
| Оплата по факту и Vertex AI | зависит от тарифа и региона |
Цифры на витрине и цифры в документации расходятся
На главной странице проекта бесплатный уровень по ключу API описан щедрее, чем в таблице квот внутри документации: там 250 запросов в сутки. Мы сверили обе страницы 29 августа 2026 года. Ориентироваться стоит на таблицу квот, витрина обычно отстаёт от неё на несколько обновлений.
Тонкость в том, что запрос это не «одна задача». Пока агент правит файл, читает соседний, запускает тесты и разбирает вывод, он тратит несколько запросов. Тысяча в сутки это много для точечных правок и мало для дня плотной работы над большим проектом. Здесь работает та же арифметика, что и в других агентах: чем аккуратнее вы формулируете задачу и чем уже контекст, тем дольше живёт лимит. Разбор приёмов экономии есть в гайде почему быстро кончаются лимиты и как экономить токены.
Сравнение по деньгам
У Claude Code бесплатного тарифа нет вовсе, агент входит в платные планы (разбор цен и способов оплаты). У Codex CLI доступ идёт через подписку ChatGPT или ключ API. На этом фоне тысяча бесплатных запросов в сутки выглядит сильным предложением, и именно поэтому вопрос про регион становится главным.
Часть 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-аккаунту даёт 60 запросов в минуту и 1000 запросов в сутки на моделях Gemini 3 с контекстом в миллион токенов. У ключа Gemini API бесплатный уровень скромнее: таблица квот в документации даёт 250 запросов в сутки. Подписки Google AI Pro и Ultra поднимают потолок до 1500 и 2000 запросов в сутки соответственно.
Работает ли 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
Канал с полезными материалами про нейросети
Разборы, новые инструменты и приёмы по ИИ — то, чем пользуюсь сам, без воды. Подпишись, чтобы не потерять.
