Gemini CLI: как установить бесплатный AI-агент Google в терминале

ВАЖНО: Gemini CLI был закрыт 18 июня 2026 года. Если вы ещё используете Gemini CLI, переходите на Antigravity CLI. Gemini CLI принимал запросы до 18 июня 2026 года. После этой даты доступ прекращён для пользователей Google AI Pro и Google AI Ultra. Корпоративные планы Gemini Code Assist Standard и Enterprise сохраняют доступ на условиях корпоративного соглашения. Мигрируйте сейчас: npm install -g @google/agy.

Официальное объявление (19 мая 2026, Google I/O): Google объявила о переходе Gemini CLI на Antigravity CLI. Дедлайн для миграции -- 18 июня 2026 года.

Правильная команда установки Antigravity CLI:

npm install -g @google/agy

Важно: правильный пакет -- @google/agy, а НЕ @google/antigravity. Пакет @google/antigravity является неофициальным и не рекомендован Google.

Ключевые отличия Antigravity CLI от Gemini CLI:

Исключение: подписчики Code Assist Standard и Enterprise (корпоративные планы Google) не затронуты дедлайном 18 июня. Для них поддержка Gemini CLI продолжается на условиях корпоративного соглашения. Уточняйте детали в документации вашего плана.

Шаги миграции:

Gemini CLI -- это бесплатный open-source AI-агент для терминала от компании Google. Он приносит возможности Gemini 2.5 Pro прямо в командную строку, позволяя писать код, отлаживать проекты, управлять файлами и выполнять сложные многошаговые задачи -- всё через диалог на естественном языке. По своей концепции Gemini CLI похож на Claude Code от Anthropic, но полностью бесплатен для личного использования с обычным Google-аккаунтом. Инструмент открытый: исходный код доступен на GitHub под открытой лицензией, что позволяет сообществу разработчиков улучшать его и адаптировать под конкретные нужды.

Ключевое отличие Gemini CLI от обычного чата с Gemini на сайте gemini.google.com -- это возможность работать с файловой системой вашего компьютера, запускать команды в терминале, читать и изменять код, создавать файлы и папки. AI-агент не просто отвечает на вопросы -- он действует. Попросите его отладить Python-скрипт, и он сам найдет файл, прочитает код, определит ошибку и предложит исправление.

Кому нужен Gemini CLI? Прежде всего разработчикам -- как начинающим, так и опытным -- кто хочет ускорить рутинные задачи: написание тестов, рефакторинг, документирование кода, создание шаблонных структур проектов. Также его оценят DevOps-инженеры для автоматизации сценариев: создания конфигурационных файлов, написания shell-скриптов, настройки CI/CD пайплайнов. Студенты и самоучки, изучающие программирование, получают AI-наставника прямо в рабочей среде, а не в отдельном чате. Полезен инструмент и аналитикам данных, работающим с Python и скриптами для обработки данных -- Gemini CLI значительно ускоряет написание ETL-скриптов и трансформаций данных.

Почему Gemini CLI привлёк широкое внимание? Главная причина -- цена. Gemini 2.5 Pro -- одна из лучших моделей для работы с кодом на рынке по состоянию на 2026 год, и доступ к ней через CLI полностью бесплатен при использовании с личным Google-аккаунтом (в пределах суточных лимитов). Это редкость: обычно мощные агентские инструменты стоят от 10 до 20 долларов в месяц. Открытый исходный код на GitHub (репозиторий google-gemini/gemini-cli) позволяет проверить, что именно делает инструмент, и адаптировать его под свои нужды.

Gemini CLI устанавливается через npm (менеджер пакетов Node.js). Это значит, что для начала нужен Node.js версии 18 или выше.

Шаг 1: проверьте или установите Node.js. Откройте терминал (Terminal на macOS/Linux, PowerShell или Windows Terminal на Windows) и введите команду node --version. Если увидите версию v18 или выше -- Node.js уже установлен, переходите к следующему шагу. Если команда не найдена, зайдите на nodejs.org и скачайте LTS-версию для своей операционной системы. Установка стандартная.

Шаг 2: установите Gemini CLI. В терминале выполните команду: npm install -g @google/gemini-cli. Флаг -g означает глобальную установку, после которой команда gemini будет доступна из любой папки. Установка занимает около 30 секунд.

Шаг 3: авторизация. После установки выполните команду: gemini. При первом запуске CLI предложит авторизоваться. Выберите Sign in with Google. В браузере откроется страница Google-авторизации -- войдите в свой аккаунт и разрешите доступ. После успешной авторизации вернитесь в терминал -- вы увидите приветственное сообщение и строку ввода.

Альтернативный способ через API-ключ: Если вы хотите использовать Gemini CLI в автоматизированных сценариях или CI/CD-пайплайнах без интерактивной авторизации, получите API-ключ на сайте aistudio.google.com (бесплатная регистрация). В разделе API Keys создайте новый ключ. Установите переменную окружения: export AV_API_KEY=ваш_ключ (на Windows используйте set AV_API_KEY=ваш_ключ). Затем запустите: gemini -- CLI подхватит ключ автоматически. Для постоянного хранения ключа добавьте строку export в файл ~/.bashrc или ~/.zshrc.

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

После успешной авторизации вы находитесь в интерактивном режиме Gemini CLI. Это похоже на чат, но с доступом к вашей файловой системе и возможностью выполнять команды.

Задача 1: анализ кода. Перейдите в папку с любым проектом командой cd путь/к/проекту. Затем в строке Gemini CLI напишите: Проанализируй структуру этого проекта и объясни, как он работает. Агент прочитает файлы в папке, проанализирует структуру и даст развернутое объяснение. Это особенно полезно при знакомстве с чужим кодом.

Задача 2: написание кода. Попросите: Создай Python-скрипт, который читает CSV-файл, считает среднее значение столбца price и сохраняет результат в новый файл result.txt. Gemini CLI напишет скрипт, создаст файл и объяснит логику -- без копирования кода из чата в редактор.

Задача 3: отладка. Если у вас есть файл с ошибкой, напишите: Найди ошибки в файле script.py и исправь их. Агент прочитает файл, определит проблему, предложит исправления и -- с вашего разрешения -- применит их автоматически.

Задача 4: документирование. Попросите: Добавь docstrings ко всем функциям в файле utils.py. Gemini CLI обновит файл, добавив документацию к каждой функции в соответствии со стандартами Python. Это задача, которая занимает часы при ручном выполнении и минуты с AI-агентом.

Задача 5: поиск информации. Gemini CLI может искать информацию в интернете в реальном времени. Напишите: Найди последние изменения в API OpenAI за последний месяц и кратко изложи, что изменилось. Агент выполнит поиск и вернёт актуальный ответ. Также можно задавать вопросы, требующие понимания текущего состояния технологий: Какие лучшие практики использования Docker Compose в 2026 году? Это особенно удобно, когда нужна информация, которая могла измениться после обучения модели.

ReAct loop -- действуй и рассуждай: Gemini CLI работает по принципу ReAct (Reason and Act): перед каждым действием агент объясняет, что собирается сделать и зачем. Это делает работу прозрачной -- вы всегда понимаете, что происходит. Каждое действие с файлами или командами требует подтверждения с вашей стороны, что исключает случайные изменения.

Контекстное окно 1 миллион токенов: Gemini 2.5 Pro имеет одно из самых больших контекстных окон среди доступных моделей. Это означает, что Gemini CLI может одновременно держать в памяти огромные кодовые базы -- сотни файлов, тысячи строк кода -- и работать с ними как с единым целым. Для крупных проектов это принципиально важно.

Поддержка MCP (Model Context Protocol): Gemini CLI поддерживает открытый стандарт MCP, разработанный Anthropic. Это позволяет подключать внешние инструменты и источники данных: базы данных, внешние API, корпоративные системы. Через MCP можно значительно расширить возможности агента под конкретные задачи.

Открытый исходный код: Весь код Gemini CLI доступен на GitHub по адресу github.com/google-gemini/gemini-cli под открытой лицензией. Это значит, что сообщество может вносить изменения, исправлять ошибки и добавлять новые функции. Также открытость кода позволяет убедиться, что инструмент не делает ничего лишнего с вашими файлами.

Интеграция с Gemini Code Assist: Для пользователей VS Code и других редакторов Gemini CLI интегрируется с расширением Gemini Code Assist, что позволяет использовать терминального агента прямо из IDE без переключения между окнами.

Нет привязки к конкретному языку: Gemini CLI работает с любыми языками программирования и фреймворками -- Python, JavaScript, TypeScript, Go, Rust, Java, C++, Bash и другими. Агент понимает специфику каждого языка и следует соответствующим конвенциям при написании кода.

Gemini CLI полностью бесплатен для использования с личным Google-аккаунтом через интерактивный вход. Это не пробный период -- постоянный бесплатный доступ к Gemini 2.5 Pro с суточными лимитами запросов. По данным Google, лимит составляет 1000 запросов в день для бесплатных аккаунтов, что для индивидуального разработчика с избытком покрывает повседневные нужды. Для сравнения: Claude Code предоставляет от 10 до 20 запросов в час на бесплатном плане, а у Gemini CLI лимит значительно выше.

Для тех, кому нужно больше: при использовании API-ключа из Google AI Studio базовый уровень также бесплатен, но с более строгими ограничениями на количество запросов в минуту. Платный доступ через Vertex AI или Google AI Studio Pro убирает лимиты и гарантирует приоритетную обработку запросов -- это актуально для корпоративного использования или интенсивных рабочих нагрузок.

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

Сравнение с альтернативами: Claude Code от Anthropic мощнее как агент, но стоит от 10 долларов в месяц. GitHub Copilot в терминале (через CLI) дешевле, но ограничен в агентских возможностях. Gemini CLI выигрывает по соотношению возможностей и цены для большинства задач.

Gemini CLI работает с серверами Google, которые в целом доступны из России. Google не заблокирован Роскомнадзором по состоянию на май 2026 года, поэтому базовый доступ к CLI должен работать без VPN. Авторизация через Google-аккаунт также не требует VPN -- это стандартный вход в аккаунт Google, который работает в России без ограничений. В отличие от многих западных AI-сервисов, Gemini CLI не проверяет геолокацию при авторизации и не блокирует российские IP-адреса намеренно.

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

Практические рекомендации: установите Gemini CLI и попробуйте без VPN -- с высокой вероятностью всё будет работать. Если при авторизации или в процессе работы появляются ошибки подключения, включите VPN с европейским или американским сервером. Для большинства разработческих задач -- написание и отладка кода, работа с файлами, документирование -- VPN не нужен.

Важный момент для корпоративного использования: некоторые компании ограничивают передачу кода в облачные сервисы. Перед использованием Gemini CLI с рабочими проектами уточните политику информационной безопасности вашей организации. Альтернативно рассмотрите возможность запуска через Vertex AI с включённым режимом Data Residency, который гарантирует, что данные не выходят за пределы выбранного региона.

Переход на Gemini 3 Pro (2026): В 2026 году Gemini CLI перешёл с Gemini 2.5 Pro на Gemini 3 Pro в качестве базовой модели. По данным Google, Gemini 3 Pro показывает результаты на 35% лучше, чем 2.5 Pro, в задачах, связанных с программированием. Контекстное окно сохранилось на уровне 1 миллиона токенов. Для пользователей, использующих бесплатный интерактивный режим, обновление модели произошло автоматически без изменения условий доступа.

Обновление v0.40.0 (28 апреля 2026): Последний стабильный релиз Gemini CLI добавил несколько важных улучшений. Offline Search: теперь агент использует встроенный ripgrep для быстрого поиска по локальной кодовой базе без обращения к интернету -- это ускоряет работу с большими проектами. GitHub-Style Colorblind Themes: новые цветовые схемы интерфейса для людей с нарушением цветового восприятия. MCP Resource & Memory Management: расширенное управление внешними контекстами и инструментами через протокол MCP. Agent Skills включены по умолчанию с версии v0.25.0, каталог содержит более 100 расширений.

Бесплатный тариф Antigravity CLI (Gemini CLI закрыт). Antigravity CLI использует недельный лимит запросов (не дневной, как был в Gemini CLI). Бесплатный доступ включает Flash-модели Gemini. Если отображается Flash -- вы на бесплатном тарифе. Для доступа к Gemini 3 Pro нужен платный Google AI Pro или Ultra.

С июня 2026 года действует недельный лимит на вычисления вместо дневного лимита в 1000 запросов. Точный размер недельного лимита зависит от типа аккаунта Google.

Для доступа к Gemini 2.5 Pro нужен платный тариф. Gemini 2.5 Pro -- лучшая модель для работы с кодом -- доступна через Google AI Pro или через Vertex AI. Обновите аккаунт в settings или используйте GOOGLE_AI_API_KEY с Pro-тарифом.

Оффлайн-поиск (v0.40.0, апрель 2026). Версия v0.40.0 добавила оффлайн-поиск с встроенным ripgrep. Gemini CLI теперь может искать по файлам без подключения к интернету. Обновите до актуальной версии: npm update -g @google/gemini-cli.

8 мая 2026 года вышел Gemini CLI v0.41.0 с режимом голосового взаимодействия в реальном времени -- теперь можно говорить с CLI вместо набора команд. По умолчанию CLI использует модели Gemma 4 для локальных задач. Auto Memory: новый inbox-поток для управления автоматически сохранёнными данными сессий. API resilience: CLI автоматически повторяет запросы при временных сбоях сети.

Предпросмотр v0.43.0 (13 мая 2026): Хирургические правки кода (surgical code edits) -- агент вносит точечные изменения без перезаписи блоков; экспорт и импорт сессий между устройствами; улучшенные проверки безопасности для shell-команд, минимизирующие риск непреднамеренного выполнения опасных операций.

Обновление v0.42.0 (12 мая 2026): Enhanced Auto Memory Inbox с canonical-patch контрактом для извлечения навыков (skill extraction) -- агент теперь надёжнее запоминает пользовательские предпочтения и кодирует их в структурированные патчи памяти. Модели Gemma 4 стали доступны по умолчанию через Gemini API.

ВАЖНО: 18 июня 2026 года Gemini CLI был закрыт (переход завершён). Сообщество разработчиков выразило недовольство закрытием исходного кода в Antigravity CLI (был open-source в Gemini CLI). Шаги миграции: 1) установите Antigravity CLI командой npm install -g @google/agy; 2) импортируйте настройки: agy plugin import gemini; 3) ваши Google AI Studio API-ключи работают без переоформления.

Google переводит Gemini CLI в Antigravity CLI как часть платформы Antigravity 2.0, анонсированной на Google I/O 19 мая 2026 года. Antigravity - это не просто переименование: это полноценная платформа оркестрации агентов, поглощающая Gemini CLI и расширяющая его возможности.

Установка Antigravity CLI: npm install -g @google/agy или brew install google-antigravity на macOS. Проверка: antigravity --version. Авторизация: antigravity auth login.

Основные изменения команд: команда gemini теперь antigravity. Флаг --model gemini-pro теперь --model gemini-3-pro. Файл конфигурации .gemini/config.yaml заменяется .antigravity/config.yaml - скопируйте ваши настройки.

Что остается без изменений: API ключи Google AI Studio работают без переоформления. Файлы GEMINI.md распознаются как контекстные файлы. Все модели из Gemini CLI доступны в Antigravity CLI плюс Claude Sonnet 4.5 и GPT-OSS.

Новые возможности Antigravity 2.0: мультиагентная оркестрация (несколько специализированных агентов параллельно), улучшенный контроль агентов, нативная интеграция с Google Cloud сервисами. Бесплатно для физических лиц в публичном preview, кросс-платформенный (macOS, Windows, Linux).

Важно об установке Antigravity CLI: Antigravity CLI написан на Go (в отличие от Gemini CLI, который был на Node.js). Официальная установка через Go binary: go install google.golang.org/antigravity/cmd/agy@latest. Альтернативно через npm: npm install -g @google/agy (пакет @google/agy является официальным оберточным пакетом). Для установки Go-бинарника напрямую требуется Go 1.21+. Свободный тариф: 20 запросов в день к Gemini Flash моделям.

Feature parity при запуске: Antigravity CLI не имел полного функционального паритета с Gemini CLI на момент запуска 18 июня 2026 года. Ряд функций, доступных в Gemini CLI, пока недоступен в Antigravity CLI. Если вы зависите от конкретных возможностей -- проверьте их наличие в Antigravity CLI перед полной миграцией.

Реакция сообщества: До закрытия Gemini CLI разработчики внесли более 6 000 pull request в открытый репозиторий google-gemini/gemini-cli на GitHub. После того как Google заменил его проприетарным Antigravity CLI с закрытым исходным кодом, часть сообщества выразила недовольство -- переход от open-source инструмента к проприетарному вызвал споры. Antigravity CLI написан на Go (Gemini CLI был на Node.js) и является закрытым продуктом.

Для корпоративных пользователей: Подписчики Gemini Code Assist Standard и Enterprise могут продолжать использовать Gemini CLI на условиях своего корпоративного соглашения и не обязаны немедленно переходить на Antigravity CLI. Это даёт время дождаться полного функционального паритета.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.