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

Сама программа бесплатная и открытая, лицензия Apache 2.0. Платить приходится за модель. С 18 июня 2026 года бесплатный вход через личный аккаунт Google в Gemini CLI отключён, Google переводит таких пользователей на Antigravity CLI. Работать можно по ключу Gemini API, через Vertex AI или по рабочей лицензии Code Assist.

Можно ли войти в Gemini CLI через аккаунт Google?

Для личных аккаунтов уже нет. С 18 июня 2026 года Gemini CLI не обслуживает запросы бесплатного Gemini Code Assist for individuals и подписок Google AI Pro и Ultra. Вход через Google остался у рабочих аккаунтов с лицензией Gemini Code Assist Standard или Enterprise, им нужно указать свой проект Google Cloud.

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

Напрямую нет: в списке регионов Gemini API на ai.google.dev России и Беларуси нет, а ключ и оплата привязаны к Google. Программа ставится без ограничений, но запросы к модели идут на серверы Google и упираются в регион. Этот барьер одинаков для Gemini CLI и для любого другого инструмента на моделях Gemini.

Чем Gemini CLI отличается от Claude Code?

Устроены похоже: агент в терминале, файл правил проекта, MCP, скиллы, хуки, режим плана. Разница в моделях и способе оплаты: Gemini CLI работает на моделях Google по ключу или через Google Cloud, Claude Code - на моделях Claude по подписке или ключу Anthropic. У Gemini CLI открытый код, у Claude Code нет.

Как обновить Gemini CLI?

Тем же способом, каким ставил. Для npm документация Google даёт команду npm install -g @google/gemini-cli@latest. Для Homebrew - brew upgrade gemini-cli, но формула в Homebrew обновляется позже npm. Версию после обновления проверь командой gemini -v в новом окне терминала.

Gemini CLI в 2026: установка, вход по ключу, отличия от Claude Code

Что такое Gemini CLI и работает ли он сейчас?

Коротко: Gemini CLI - агент Google, который работает в терминале и работает с файлами твоей папки. Программа жива и обновляется, но с 18 июня 2026 года вход через личный аккаунт Google в ней отключён. Рабочие пути теперь - ключ Gemini API, Vertex AI или корпоративная лицензия.

Gemini CLI - это программа с открытым кодом от Google: ставишь её одной командой, заходишь в папку проекта, пишешь gemini, и дальше агент сам открывает нужные файлы, вносит правки и выполняет команды, каждый раз спрашивая разрешение. По смыслу это ровно то же, что Claude Code или Codex, только на моделях Gemini.

Почти все русскоязычные инструкции в выдаче написаны в 2025 году и обещают бесплатный вход через аккаунт Google. Это устарело. Google 19 мая 2026 года объявил, что переносит силы в Antigravity CLI, и с 18 июня Gemini CLI перестал обслуживать запросы бесплатного плана Gemini Code Assist for individuals и подписок Google AI Pro и Ultra. На сайте geminicli.com теперь висит плашка: для бесплатного уровня и пользователей Google One Gemini CLI заменён на Antigravity CLI.

При этом программа не заброшена: 24 сентября вышла версия 0.61.0. Корпоративным клиентам Google обещает поддержку дальше, остальным оставляет доступ по ключам Gemini API.

Я поставил 0.61.0 на Mac и прогнал проверку версии, справку и три ошибки, которые встречаешь в первые десять минут. Их тексты ниже скопированы из моего терминала. Полноценную сессию с оплаченным ключом для статьи я не запускал: остальное сверено с документацией Google 26 сентября 2026 года.

Если ты выбираешь, на каком агенте строить работу, начни с того, где уже есть готовые настройки. В ClaudeBase собраны уроки и материалы по Claude Code и Codex: правила проекта, разрешения, скиллы. Отдельного урока про Gemini CLI там нет, зато логика настройки агента в терминале та же.

С какой ситуации ты начинаешь

Коротко: у каждой из четырёх ситуаций свой первый шаг. Главное различие - есть ли у тебя ключ Gemini API или доступ к Google Cloud: без них установка пройдёт, а работа не начнётся.

Хочешь бесплатно попробовать агента в терминале. Вход через Google для личных аккаунтов закрыт, поэтому сначала посмотри аналоги Claude Code и сравни варианты, прежде чем ставить.
Ключ Gemini API уже есть. Иди по шагам ниже: установка, переменная GEMINI_API_KEY, первая сессия.
У компании есть Google Cloud или лицензия Code Assist. Тебе подойдёт вход через Vertex AI или через рабочий аккаунт с указанием проекта, об этом в разделе про вход.
Уже работаешь в Claude Code и просто сравниваешь. Переходи сразу к таблице отличий и разделу о том, когда какой агент брать.

Что нужно до установки?

Коротко: Node.js 20 или новее, если ставишь через npm, подходящая система и интернет. Отдельно нужен способ входа, без него агент не ответит ни на один запрос.

Google рекомендует macOS 15 и новее, Windows 11 24H2 и новее или Ubuntu 20.04 и новее, оболочку Bash, Zsh или PowerShell и от 4 ГБ памяти, для больших проектов - от 16 ГБ.

Требование к Node.js проверяется по самому пакету: в реестре npm у @google/gemini-cli указано node >=20. Посмотри свою версию:

node -v

Если ответ начинается с v18 или меньше, сначала обнови Node.js.

Второе условие - регион. Россия и Беларусь в перечень регионов Gemini API не входят. Программа установится где угодно, но запросы к модели уходят на серверы Google, и регион проверяется там. Агент, который работает из России напрямую, есть у Сбера, его разбор - в сравнении GigaCode или Claude Code.

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

Коротко: основной способ - npm install -g @google/gemini-cli. На Mac и Linux есть Homebrew, но версия там отстаёт. Попробовать без установки можно через npx.

Выбери один способ из трёх.

Через npm - основной путь из документации Google:

npm install -g @google/gemini-cli

Через Homebrew на Mac или Linux:

brew install gemini-cli

Разовый запуск без установки - удобно, чтобы посмотреть на программу, ничего не ставя глобально:

npx @google/gemini-cli

Способ	Кому подходит	Как обновлять
`npm install -g @google/gemini-cli`	всем, у кого стоит Node.js 20+	`npm install -g @google/gemini-cli@latest`
`brew install gemini-cli`	тем, кто держит программы в Homebrew	`brew upgrade gemini-cli`
`npx @google/gemini-cli`	чтобы попробовать без установки	каждый запуск берёт свежую версию

Про Homebrew одно предупреждение. 26 сентября в npm лежала версия 0.61.0, а формула Homebrew показывала 0.46.0. Разница в пятнадцать релизов, а Gemini CLI выходит каждую неделю по вторникам. Если тебе важны свежие команды из документации, ставь через npm.

Проверка установки - в новом окне терминала:

gemini -v

У меня ответ был 0.61.0. Номер версии на экране значит, что программа стоит и терминал её находит.

Как войти: ключ, Vertex AI или рабочая подписка?

Коротко: для личного использования остался один простой путь - ключ Gemini API в переменной GEMINI_API_KEY. Vertex AI и вход через рабочий аккаунт - для тех, у кого есть Google Cloud.

Ключ Gemini API. Ключ создаётся в Google AI Studio на странице aistudio.google.com/app/apikey. Тот же ключ подходит и для генерации картинок из кода через Nano Banana API. Дальше его кладут в переменную окружения:

export GEMINI_API_KEY="твой_ключ"
gemini

На Windows в PowerShell строка другая:

$env:GEMINI_API_KEY="твой_ключ"

При первом запуске программа спросит, как входить. Выбирай вход по ключу Gemini API. Строка с export действует только в текущем окне, для постоянства её дописывают в ~/.zshrc. Сам ключ никому не пересылай и не клади в папку проекта, которую выкладываешь на GitHub.

Одна оговорка. В объявлении Google сказано, что Gemini CLI остаётся доступен по платным ключам Gemini API. В документации самой программы бесплатный уровень ключа ещё описан, но это текст, который не обновляли с весны. Проверяй на своём ключе, а цифры квот смотри в своём проекте AI Studio, а не в старых статьях.

Vertex AI. Путь для тех, у кого проект в Google Cloud: нужны переменные GOOGLE_CLOUD_PROJECT и GOOGLE_CLOUD_LOCATION и вход через gcloud или ключ.

Рабочий аккаунт с лицензией Code Assist. Вход через Google для компаний с лицензией Gemini Code Assist Standard или Enterprise не отключали. Перед запуском указывается проект:

export GOOGLE_CLOUD_PROJECT="id_проекта"
gemini

Сменить способ входа позже можно командой /auth прямо в сессии.

Как провести первую сессию?

Коротко: запускай gemini из папки проекта, доверяй только своей папке и сначала попроси агента рассказать, что в проекте. Файлы подключаются через @, команды терминала через !.

Перейди в папку проекта и запусти агента:

cd ~/projects/moy-sayt
gemini

В версии 0.61.0 проверка доверия включена: без неё у меня отказался работать даже режим без окна. В обычной сессии программа спрашивает, доверяешь ли ты этой папке. Вариантов три: доверить папку, доверить родительскую папку целиком или не доверять. Недоверенная папка работает в безопасном режиме: настройки проекта из .gemini/settings.json не читаются, файл .env не подгружается, MCP-серверы не подключаются, и на каждое действие агент спрашивает разрешение. Выбор сохраняется в ~/.gemini/trustedFolders.json, второй раз вопрос не задаётся.

Дальше пишешь задачу обычными словами, для начала хватит «расскажи, что лежит в этой папке».

Два приёма, которые экономят время:

@ перед путём вставляет файл или папку в запрос: @README.md о чём этот проект?. Файлы из .gitignore вроде node_modules и .env по умолчанию пропускаются.
! перед командой выполняет её в терминале, не выходя из сессии: !git status. Одиночный ! переключает режим, в котором всё набранное уходит прямо в терминал.

Насколько свободно агент действует, задаёт режим подтверждений. Его выбирают при запуске флагом --approval-mode:

Режим	Что происходит
`default`	агент спрашивает разрешение на каждое действие
`auto_edit`	правки файлов проходят сами, остальное со спросом
`yolo`	всё проходит без вопросов
`plan`	только чтение, агент составляет план и ничего не меняет

Для первых недель бери default или plan. Режим yolo оставь для песочницы: в нём агент выполнит любую команду, в том числе удаление. Старый флаг -y ещё работает, но в документации помечен как устаревший.

Какие команды пригодятся в первый день?

Коротко: десятка команд со слешем хватает для спокойной работы. Самые нужные - /init, /memory, /model, /stats, /rewind и /quit.

Команда	Зачем
`/help`	список всех команд
`/init`	изучить папку и написать файл правил `GEMINI.md`
`/memory show`	показать, какие правила агент сейчас видит
`/model`	посмотреть или сменить модель
`/stats model`	расход токенов и квота по моделям
`/plan`	включить режим плана, только чтение
`/rewind`	откатить разговор и правки файлов, то же по двойному Esc
`/resume`	вернуться к прошлой сессии
`/compress`	сжать длинный разговор в краткое содержание
`/quit`	выйти

Для скриптов есть режим без окна: gemini -p "текст задачи" выполняет задачу и печатает ответ. Флаг --output-format json отдаёт ответ в JSON, если результат будет читать другая программа.

Я сам плачу за подписки на нейросети картой для подписок «Плати по миру»: выпускается за пару минут, пополняется рублями через СБП. Оформить карту

Что такое GEMINI.md и зачем он нужен?

Коротко: GEMINI.md - файл с правилами проекта, который агент перечитывает при каждом запросе. Первую версию пишет команда /init, дальше ты правишь её руками.

Без файла правил ты повторяешь агенту одно и то же: «пиши по-русски», «не трогай эту папку». GEMINI.md снимает эти повторы. Устроен он так же, как CLAUDE.md у Claude Code.

Агент собирает правила из нескольких мест и склеивает их:

Общий файл ~/.gemini/GEMINI.md - правила для всех проектов.
GEMINI.md в папке проекта и в папках выше неё.
GEMINI.md во вложенных папках - подхватывается, когда агент туда заходит.

Что именно в них видит агент, покажет /memory show. Правки подхватит /memory reload.

Полезная деталь для тех, у кого несколько агентов. Имя файла меняется в настройках settings.json:

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

С такой строкой Gemini CLI прочитает тот же AGENTS.md, что и Codex, и правила не придётся дублировать в двух файлах.

Именно на правилах проекта обычно и спотыкаются: установить агента можно за десять минут, а научить его работать по-твоему - дольше. В курсе ClaudeBase этому посвящены урок «Рабочее окружение: правила проекта и разрешения» и материал «Правила агента: CLAUDE.md и AGENTS.md». Показано на Claude Code и Codex, но структура правил переносится и в GEMINI.md.

Чем Gemini CLI похож на Claude Code и чем отличается?

Коротко: устройство почти одинаковое, разница в моделях, способе оплаты и открытости кода. Навыки работы с одним агентом переносятся на другой за вечер.

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

	Gemini CLI	Claude Code
Чьи модели	Google Gemini	Anthropic Claude
Код программы	открытый, Apache 2.0	исходный код закрыт
Установка	npm, Homebrew, npx	установщик одной командой, Homebrew, npm
Нужен Node.js	да, 20+ при установке через npm	нет при установке официальным установщиком
Вход для частного лица	ключ Gemini API	подписка Claude или ключ Anthropic
Файл правил	`GEMINI.md`	`CLAUDE.md`
Создать файл правил	`/init`	`/init`
Режимы разрешений	`default`, `auto_edit`, `yolo`, `plan`	переключаются по Shift+Tab, есть режим плана
MCP, скиллы, хуки	есть	есть

Любопытная деталь: у Claude Code есть команда /import, которая забирает из Gemini CLI файлы правил, MCP-серверы, команды и скиллы. А /init в Claude Code, найдя настройки Gemini CLI в папке, сам предлагает их перенести.

Когда брать Gemini CLI, а когда Claude Code?

Коротко: Gemini CLI - если у тебя уже есть ключ Gemini API или Google Cloud и работать нужно на моделях Google. Для остальных в 2026 году проще Claude Code или Codex.

Gemini CLI уместен в трёх случаях:

компания уже платит за Google Cloud или Code Assist, и заводить ещё одну подписку незачем;
нужны именно модели Gemini, например для работы с картинками и PDF внутри проекта;
хочется агента с открытым кодом, которого можно читать и дорабатывать.

Claude Code разумнее, когда ты начинаешь с нуля и нужна подписка с понятным входом, когда важна большая база готовых скиллов и инструкций, и когда не хочется разбираться с проектами Google Cloud. Как его поставить, разобрано в статье как установить Claude Code. Если выбор между двумя самыми популярными агентами, посмотри разбор Codex или Claude Code.

И честно о будущем. Google прямо пишет, что силы уходят в Antigravity CLI, а Gemini CLI остаётся для корпоративных клиентов и работы по ключу. Строить на нём долгую личную систему сейчас рискованнее, чем год назад.

Частые ошибки Gemini CLI

Коротко: пять сообщений, которые встречаются чаще всего. Заголовки ниже совпадают с текстом в терминале, первые три я получил сам на версии 0.61.0.

Please set an Auth method

Полный текст: Please set an Auth method in your ~/.gemini/settings.json or specify one of the following environment variables before running: GEMINI_API_KEY, GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_GENAI_USE_GCA, только вместо ~ программа печатает полный путь к домашней папке. Способ входа не выбран. Задай GEMINI_API_KEY в этом же окне терминала или запусти gemini без аргументов и выбери вход в диалоге.

Gemini CLI is not running in a trusted directory

Появляется в режиме без окна, с флагом -p, когда папке ещё не доверяли. Программа сама подсказывает три выхода: флаг --skip-trust на один запуск, переменная GEMINI_CLI_TRUST_WORKSPACE=true или доверить папку в обычной сессии. Для своего проекта проще последнее: один раз запусти gemini и выбери доверие.

API key not valid. Please pass a valid API key.

Ключ не принят сервером Google. Частые причины: скопирован с пробелом или не целиком, ключ удалён в AI Studio, в окне терминала висит старое значение переменной. Проверь, что лежит в переменной, командой echo $GEMINI_API_KEY и создай ключ заново, если сомневаешься.

zsh: command not found: gemini

Терминал не находит программу. Сначала открой новое окно. Не помогло - папка глобальных пакетов npm не попала в PATH: её адрес показывает npm prefix -g, в PATH должна быть папка bin внутри неё.

Your current account is not eligible… because it is not currently available in your location

Ошибка входа через Google, если страна аккаунта или сети не поддерживается. С 18 июня 2026 года для личных аккаунтов этот вход закрыт совсем, так что чинить тут нечего: нужен ключ Gemini API или рабочий доступ через Google Cloud.

Чек-лист готовности Gemini CLI

Коротко: шесть пунктов, по которым видно, готов ли Gemini CLI к работе. Сошлись все - давай первую настоящую задачу.

node -v показывает версию 20 или новее.
gemini -v в новом окне терминала печатает номер версии.
В переменной GEMINI_API_KEY лежит ключ, или настроен вход через Vertex AI либо рабочий аккаунт.
Папка проекта отмечена как доверенная.
В корне проекта есть GEMINI.md, и /memory show показывает его содержимое.
Агент ответил на вопрос «что лежит в этой папке» и ничего не поменял без спроса.

Куда идти после настройки Gemini CLI?

Коротко: дальше три шага - подключить внешние инструменты по MCP, настроить правила и выбрать, на каком агенте строить работу.

Инструменты. Gemini CLI подключает MCP-серверы командой gemini mcp add. На примере Claude Code это расписано в материале MCP в Claude Code, принцип тот же.
Терминал. Если окно команд пока пугает, начни со статьи Claude Code в терминале: там разобраны переходы по папкам и чтение запросов разрешений, это пригодится в любом агенте.
Выбор агента. Сравнение одиннадцати вариантов собрано в аналогах Claude Code.

Если в итоге остановишься на Claude Code или Codex, готовые правила проекта, скиллы и уроки лежат в ClaudeBase. Базу подключают к агенту по MCP, и нужные материалы он находит в ней сам.

Gemini CLI: установка и первая сессия