Gemini CLI

Gemini CLI — официальная консольная утилита Google. Она поддерживает настройку кастомного шлюза через переменные окружения для подключения сервиса Codex Proxy, что позволяет общаться с моделями Gemini прямо в терминале.

ПодготовкаКопировать ссылку на якорь

Gemini CLI устанавливается глобально через npm, поэтому сначала нужно подготовить окружение Node.js 18+ и npm.

Установка Node.jsКопировать ссылку на якорь

• Страница загрузки Node.js: https://nodejs.org/en/download
• macOS/Windows: скачайте и установите LTS-версию
• Linux: установите способом для своего дистрибутива, указанным на странице
• macOS (пользователи Homebrew): выполните brew install node

Проверка установкиКопировать ссылку на якорь

node -v
npm -v

Установка Gemini CLIКопировать ссылку на якорь

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

npm install -g @google/gemini-cli

Проверка установки:

gemini --version

Настройка переменных окруженияКопировать ссылку на якорь

Gemini CLI поддерживает подключение кастомного шлюза через три переменные окружения:

Пример настройкиКопировать ссылку на якорь

export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
export GEMINI_MODEL="gemini-2.0-flash"

ПримечанияКопировать ссылку на якорь

• В GOOGLE_GEMINI_BASE_URL указывайте корневой адрес сервиса, без конкретных путей к методам
• Быстрая проверка: выполните export-команды прямо в текущей сессии shell
• Постоянное действие: добавьте export-строки в ~/.zshrc или ~/.bashrc, затем выполните source ~/.zshrc, чтобы они вступили в силу

Запуск Gemini CLIКопировать ссылку на якорь

Когда конфигурация готова, просто выполните:

gemini

После запуска можно общаться с моделями Gemini прямо в терминале.

Проверка подключенияКопировать ссылку на якорь

Отправьте в Gemini CLI одно сообщение: если ответ приходит нормально, подключение выполнено успешно.

Устранение типичных проблемКопировать ссылку на якорь

• При ошибке аутентификации убедитесь, что GEMINI_API_KEY указан верно
• Проверьте, указывает ли GOOGLE_GEMINI_BASE_URL на правильный адрес сервиса

ПримечанияКопировать ссылку на якорь

• Текущий сервис уже поддерживает Gemini-совместимый интерфейс и подходит для Gemini CLI напрямую
• Для постоянного действия переменные окружения рекомендуется прописать в конфигурационном файле shell
• Gemini CLI сам собирает пути API, добавлять конкретные пути к методам в BASE_URL не нужно

Полезные ссылкиКопировать ссылку на якорь

• Официальная документация: https://docs.aicentos.com/clients/gemini-cli.html