Gemini CLI

Gemini CLI — открытый AI-агент, который предоставляет прямой доступ к возможностям Gemini прямо из терминала. Это самый короткий путь от вашего запроса до модели.

Подробная документация доступна на geminicli.com/docs/.

🚀 Почему Gemini CLI?

• 🎯 Бесплатный тариф: 60 запросов/мин и 1 000 запросов/день с личным аккаунтом Google.
• 🧠 Мощные модели Gemini 3: улучшенное рассуждение и контекстное окно в 1M токенов.
• 🔧 Встроенные инструменты: Google Search grounding, файловые операции, shell-команды, веб-запросы.
• 🔌 Расширяемость: поддержка MCP (Model Context Protocol) для кастомных интеграций.
• 💻 Terminal-first: создан для разработчиков, живущих в командной строке.
• 🛡️ Открытый исходный код: лицензия Apache 2.0.

📦 Установка

Рекомендуемые системные требования и подробное руководство по установке см. в разделе Gemini CLI installation, execution, and releases.

Быстрая установка

Запуск без установки через npx

# Через npx (установка не требуется)
npx @google/gemini-cli

Глобальная установка через npm

Глобальная установка через Homebrew (macOS/Linux)

Глобальная установка через MacPorts (macOS)

Установка через Anaconda (для ограниченных окружений)

# Создать и активировать новое окружение
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# Глобальная установка Gemini CLI через npm (внутри окружения)
npm install -g @google/gemini-cli

Каналы выпуска

Подробности см. в разделе Releases.

Preview

Новые preview-релизы публикуются еженедельно по вторникам в 23:59 UTC. Они не проходят полную проверку и могут содержать регрессии или другие проблемы. Помогите нам с тестированием — устанавливайте с тегом preview.

Stable

Новые стабильные релизы публикуются еженедельно по вторникам в 20:00 UTC — это полное продвижение прошлонедельного preview-релиза плюс исправления ошибок и валидации. Используйте тег latest.

Nightly

Новые релизы публикуются ежедневно в 00:00 UTC. Включают все изменения из основной ветки на момент выпуска. Следует считать, что валидации ещё не завершены и возможны проблемы. Используйте тег nightly.

📋 Ключевые возможности

Понимание и генерация кода

• Запросы и редактирование больших кодовых баз
• Генерация новых приложений из PDF, изображений или набросков с помощью мультимодальных возможностей
• Отладка и диагностика проблем на естественном языке

Автоматизация и интеграция

• Автоматизация операционных задач: запросы к pull request'ам, сложные rebase-операции
• Подключение новых возможностей через MCP-серверы, включая генерацию медиа с Imagen, Veo или Lyria
• Неинтерактивный запуск в скриптах для автоматизации рабочих процессов

Расширенные возможности

• Заземление запросов с помощью встроенного Google Search для получения актуальной информации
• Контрольные точки диалога для сохранения и возобновления сложных сессий
• Кастомные контекстные файлы (GEMINI.md) для настройки поведения под конкретные проекты

Интеграция с GitHub

Интегрируйте Gemini CLI напрямую в рабочие процессы GitHub с помощью Gemini CLI GitHub Action:

• Ревью pull request'ов: автоматическое ревью кода с контекстными комментариями и предложениями
• Триаж задач: автоматическая расстановка меток и приоритизация GitHub Issues на основе анализа содержимого
• Помощь по запросу: упомяните @gemini-cli в Issues и pull request'ах для помощи с отладкой, объяснениями или делегированием задач
• Кастомные рабочие процессы: создание автоматизированных, плановых и запускаемых по требованию процессов под нужды вашей команды

🔐 Варианты аутентификации

Выберите метод аутентификации, наиболее подходящий для ваших задач:

Вариант 1: Вход через Google (OAuth с аккаунтом Google)

✨ Лучший выбор для: индивидуальных разработчиков, а также всех, у кого есть лицензия Gemini Code Assist (подробности о лимитах и условиях использования см. в quota limits and terms of service).

Преимущества:

• Бесплатный тариф: 60 запросов/мин и 1 000 запросов/день
• Модели Gemini 3 с контекстным окном 1M токенов
• Без управления API-ключами — просто войдите через аккаунт Google
• Автоматическое обновление до последних моделей

Запустите Gemini CLI, выберите Sign in with Google и следуйте инструкциям браузерной аутентификации

Если вы используете платную лицензию Code Assist от организации, не забудьте указать проект Google Cloud

# Укажите ваш проект Google Cloud
export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
gemini

Вариант 2: Gemini API Key

✨ Лучший выбор для: разработчиков, которым нужен программный доступ или расширенные квоты.

Преимущества:

• Доступ к Gemini 2.5 Pro и другим моделям
• Гибкое управление квотами
• Подходит для автоматизации и CI/CD-пайплайнов

export GEMINI_API_KEY="YOUR_API_KEY"
gemini

Получить API-ключ можно в Google AI Studio.

Вариант 3: Vertex AI

✨ Лучший выбор для: корпоративных развёртываний и команд с существующей инфраструктурой Google Cloud.

Преимущества:

• Корпоративная безопасность и соответствие требованиям
• Кастомные квоты и биллинг через Google Cloud
• Региональные конечные точки для соответствия требованиям к хранению данных
• Интеграция с VPC Service Controls

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_ID"
export GOOGLE_CLOUD_LOCATION="us-central1"
export GEMINI_SANDBOX="true" # опционально: для изолированного выполнения кода
gemini

🛠️ Использование

Интерактивный режим

# Запуск интерактивного сеанса
gemini

# Запуск с начальным запросом
gemini -p "Объясни эту кодовую базу"

# Использование конкретной модели
gemini --model gemini-2.5-pro

Неинтерактивный режим (для скриптов)

# Передача запроса через stdin
echo "Что делает эта функция?" | gemini -p "$(cat myfile.js)"

# Использование в скриптах
gemini -p "Сгенерируй unit-тесты для $(cat src/utils.ts)" --output_format json

Работа с файлами и кодом

# Анализ файла
gemini -p "Проверь этот код на наличие багов" < mycode.py

# Работа с несколькими файлами
gemini -p "Сравни эти реализации" --input file1.js --input file2.js

⚙️ Конфигурация

Gemini CLI поддерживает конфигурацию через:

• Переменные окружения: GEMINI_API_KEY, GOOGLE_CLOUD_PROJECT и др.
• Файл конфигурации: ~/.gemini/config.json для глобальных настроек
• Файлы GEMINI.md: контекстные файлы для конкретных проектов
• Флаги командной строки: переопределение любых настроек на лету

Пример файла конфигурации

{
  "model": "gemini-2.5-pro",
  "sandbox": false,
  "telemetry": {
    "enabled": true,
    "target": "local"
  },
  "usageStatisticsEnabled": true
}

🔌 Поддержка MCP

Gemini CLI поддерживает MCP-серверы для расширения возможностей:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
  }
}

Подробнее об интеграции с MCP см. в документации по расширениям.

🤝 Участие в разработке

Мы приветствуем вклад сообщества! Ознакомьтесь с CONTRIBUTING.md для получения информации о:

• Настройке среды разработки
• Стандартах написания кода
• Процессе отправки pull request'ов
• Руководстве по тестированию

📄 Лицензия

Проект распространяется под лицензией Apache 2.0. Подробности см. в файле LICENSE.

🔗 Полезные ссылки

• Документация
• Gemini API
• Сообщить о проблеме
• Обсуждения
• Список изменений