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

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 GEMINI_API_KEY=ваш_ключ (на Windows используйте set GEMINI_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 расширений.

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