Gemini CLI: настройка и подключение через OfoxAI — полное руководство

Что такое Gemini CLI

Gemini CLI — инструмент командной строки для работы с моделями Gemini от Google. Через OfoxAI вы можете использовать нативный протокол Gemini, получая при этом преимущества API-шлюза: аварийное переключение при сбоях, оптимизацию маршрутизации и более широкий выбор моделей.

В этом руководстве — установка, два способа настройки (файл конфигурации и переменные окружения), доступные модели и практические сценарии использования.

Установка

npm install -g @google/gemini-cli

После установки команда gemini станет доступна в терминале.

Настройка через файл конфигурации

Gemini CLI использует нативный протокол Gemini. Создайте или отредактируйте файл конфигурации:

// ~/.gemini/settings.json
{
  "apiKey": "<Ваш OFOXAI_API_KEY>",
  "baseUrl": "https://api.ofox.ai/gemini"
}

В поле apiKey укажите ваш ключ OfoxAI, а baseUrl направит запросы на Gemini-совместимый эндпоинт OfoxAI.

Настройка через переменные окружения

Альтернативный способ — задать API Key через переменную окружения:

# Добавьте в ~/.zshrc (или ~/.bashrc)
export GEMINI_API_KEY=<Ваш OFOXAI_API_KEY>

Примените изменения:

source ~/.zshrc

Способ настройки base URL в Gemini CLI может меняться в зависимости от версии. Если указанный выше способ через settings.json не работает, обратитесь к актуальной документации Gemini CLI.

Проверка

gemini "Здравствуйте, расскажите о себе"

Если ответ получен — подключение настроено успешно.

Доступные модели

Выбор модели зависит от задачи. Для повседневной работы подойдёт Gemini 3.1 Flash Lite — быстрый и экономичный. Для сложных задач, требующих глубокого рассуждения, используйте Gemini 3.1 Pro.

Сценарии использования

Генерация и ревью кода

Модели Gemini хорошо понимают код. Опишите задачу на естественном языке, и Gemini CLI сгенерирует решение или проведёт ревью существующего кода.

gemini "Проведи ревью файла server.js и предложи улучшения"

Анализ длинных файлов

Контекстное окно моделей Gemini достигает 1M токенов — это позволяет загружать объёмные файлы целиком и задавать вопросы по их содержимому.

gemini "Проанализируй зависимости в package.json и предложи обновления"

Мультимодальные задачи

Модели Gemini поддерживают анализ изображений, PDF и других типов файлов. Можно передавать файлы в контекст и задавать вопросы по их содержимому.

Преимущества OfoxAI для Gemini CLI

Используя Gemini CLI через OfoxAI, вы получаете:

• Аварийное переключение (failover) — при сбое основного узла запросы автоматически перенаправляются на резервный
• Оптимизация маршрутизации — выбор оптимального пути для минимизации задержки
• Единый биллинг — все провайдеры (Google, OpenAI, Anthropic) на одном счёте
• Упрощённый доступ — не нужен аккаунт Google Cloud с привязкой международной карты

Подробнее об аварийном переключении — в документации расширенных функций.

Решение типичных проблем

Ошибка подключения

Проверьте, что baseUrl в ~/.gemini/settings.json указан как https://api.ofox.ai/gemini (без завершающего слеша). Убедитесь, что API Key активен.

Модель недоступна

Убедитесь, что используете полный ID модели с префиксом google/. Правильно: google/gemini-3.1-pro-preview. Неправильно: gemini-3.1-pro-preview.

Изменения в конфигурации не работают

Gemini CLI активно развивается, и параметры конфигурации могут меняться между версиями. Всегда сверяйтесь с актуальной документацией на GitHub.

Итог

Gemini CLI через OfoxAI — это доступ к моделям Gemini с аварийным переключением и оптимизацией маршрутизации. Настройка занимает минуту: создайте ~/.gemini/settings.json с apiKey и baseUrl: https://api.ofox.ai/gemini, или задайте переменную GEMINI_API_KEY. Три модели на выбор: Pro для сложных задач, Flash Lite для скорости, и мультимодальная Gemini 3 Pro.

Подробнее — в документации по интеграции Gemini CLI. API Key можно создать на ofox.ai.