Crazyrouter
Руководство пользователя 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 по сниженным тарифам:
| Model | Input Price | Output Price |
|---|---|---|
| gemini-2.5-pro | $0.625/1M tokens | $2.50/1M tokens |
| gemini-2.5-flash | $0.038/1M tokens | $0.15/1M tokens |
| gemini-2.5-flash-lite | $0.019/1M tokens | $0.075/1M tokens |
Все цены включают скидку 45% по сравнению с официальными тарифами.
Связанные ресурсы#
Нужна помощь? Свяжитесь со службой поддержки или ознакомьтесь с документацией Crazyrouter для получения дополнительной информации.
