Руководство пользователя Gemini CLI - Google ИИ в вашем терминале

Gemini CLI — это открытый командный инструмент ИИ от Google, который приносит возможности Gemini прямо в ваш терминал. Он предоставляет легковесный способ доступа к Gemini, обеспечивая самый прямой путь от запроса к модели. Настроив прокси, вы можете использовать сервисы Gemini CLI даже в условиях ограниченной сети.

Почему стоит выбрать Gemini CLI?#

• Мощный Gemini 2.5 Pro: доступ к контекстному окну на 1 миллион токенов
• Встроенные инструменты: привязка к Google Search, операции с файлами, команды Shell, веб-скрейпинг
• Расширяемость: поддержка MCP (Model Context Protocol) для пользовательских интеграций
• Ориентирован на терминал: создан для разработчиков, работающих в командной строке
• Открытый исходный код: лицензия Apache 2.0

Установка#

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

Мгновенный запуск через npx (без установки)#

# Use official repository
npx https://github.com/google-gemini/gemini-cli

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

npm install -g @google/gemini-cli

Установка через Homebrew (macOS/Linux)#

brew install gemini-cli

Системные требования#

• Node.js версии 20 или выше
• macOS, Linux или Windows

Настройка прокси#

Установка переменных окружения#

Перед использованием прокси настройте следующие переменные окружения:

Linux / macOS#

# Set API Key
export GEMINI_API_KEY=sk-your-api-key-here

# Set API Proxy URL
export GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows CMD#

set GEMINI_API_KEY=sk-your-api-key-here
set GOOGLE_GEMINI_BASE_URL=https://crazyrouter.com/

Windows PowerShell#

$env:GEMINI_API_KEY = "sk-your-api-key-here"
$env:GOOGLE_GEMINI_BASE_URL = "https://crazyrouter.com/"

Совет: Добавьте эти переменные окружения в ваш файл .bashrc, .zshrc или конфигурационный файл оболочки, чтобы они автоматически устанавливались при каждом запуске терминала.

Быстрый старт#

Базовое использование#

Запуск в текущем каталоге#

gemini

Включение нескольких каталогов#

gemini --include-directories ../lib,../docs

Использование определённой модели#

gemini -m gemini-2.5-flash

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

Получить простой текстовый ответ:

gemini -p "Explain the architecture of this codebase"

Получить структурированный JSON-вывод:

gemini -p "Explain the architecture of this codebase" --output-format json

Быстрые примеры#

Начать новый проект#

cd new-project/
gemini
> Write me a Discord bot that answers questions using the FAQ.md file I provided

Анализ существующего кода#

git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all changes from yesterday

Основные возможности#

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

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

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

• Автоматизация операционных задач, таких как запрос pull request'ов или обработка сложных rebase
• Подключение новых возможностей с помощью MCP-серверов
• Запуск в неинтерактивном режиме в скриптах для автоматизации рабочих процессов

Продвинутые функции#

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

Распространённые команды и примеры#

Исследование кодовой базы#

> Describe the main components of this system architecture
> What security mechanisms are in place?
> Provide a step-by-step onboarding document for new developers

Работа с существующим кодом#

> Implement a first draft for GitHub issue #123
> Help me migrate this codebase to the latest version of Java. Start with a plan

Автоматизация рабочих процессов#

> Create a slideshow showing the git history from the past 7 days, grouped by feature and team member
> Create a full-screen web app for wall display showing our most interactive GitHub issues

Взаимодействие с системой#

> Convert all images in this directory to png and rename them using the date from exif data
> Organize my PDF invoices by spending month

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

Используйте Gemini CLI GitHub Action, чтобы встроить Gemini CLI непосредственно в ваши GitHub‑воркфлоу:

• Обзоры Pull Request'ов: автоматизированные обзоры кода с контекстной обратной связью и предложениями
• Классификация issues: автоматическая разметка и приоритизация GitHub issues на основе анализа содержимого
• Помощь по запросу: упоминайте @gemini-cli в issues и pull requests для помощи с отладкой, объяснениями или делегированием задач
• Пользовательские workflows: создавайте автоматизированные, плановые и вызываемые по запросу workflows, адаптированные под нужды вашей команды

Устранение неполадок#

Если вы столкнулись с проблемами во время использования, учтите следующее:

1. Проверьте переменные окружения#

echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

2. Проверьте сетевое подключение#

curl -I https://crazyrouter.com/

3. Проверьте сообщения об ошибках#

Сообщения об ошибках обычно указывают на проблему. Распространённые причины:

• Неверный формат API-ключа
• Проблемы с сетевым подключением
• Неправильная конфигурация прокси

4. Формат SOCKS-прокси#

Если используется SOCKS-прокси, убедитесь, что формат указан верно:

socks5://<user>:<pass>@<proxy>:<port>

5. Сообщение о багах#

Используйте встроенную команду для отправки отчётов о проблемах:

/bug

Релизные версии#

Preview#

Новые preview‑версии выходят каждый вторник в 23:59 по UTC:

npm install -g @google/gemini-cli@preview

Stable#

Новые стабильные версии выходят каждый вторник в 20:00 по UTC:

npm install -g @google/gemini-cli@latest

Nightly#

Nightly‑версии выходят каждый день в 00:00 по UTC:

npm install -g @google/gemini-cli@nightly

Использование MCP-сервера#

Настройте MCP-серверы в ~/.gemini/settings.json, чтобы расширить Gemini CLI пользовательскими инструментами:

> @github list my open pull requests
> @slack send a summary of today's commits to #dev channel
> @database run a query to find inactive users

Тарифы через Crazyrouter#

Получайте доступ к моделям Gemini по сниженным тарифам:

Все цены включают скидку 45% по сравнению с официальными тарифами.

Связанные ресурсы#

• Crazyrouter Pricing Page
• Gemini CLI GitHub Repository
• Google AI Documentation

Нужна помощь? Свяжитесь со службой поддержки или ознакомьтесь с документацией Crazyrouter для получения дополнительной информации.