# Gemini CLI

Источник: https://docs.aicentos.com/ru/clients/gemini-cli

Language: ru

> Использование aicentos в Gemini CLI — настройка кастомного шлюза через переменные окружения

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

## Подготовка

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

### Установка Node.js

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

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

```bash
node -v
npm -v
```

## Установка Gemini CLI

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

```bash
npm install -g @google/gemini-cli
```

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

```bash
gemini --version
```

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

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

| Переменная окружения     | Описание                                                    |
| ------------------------ | ----------------------------------------------------------- |
| `GOOGLE_GEMINI_BASE_URL` | Корневой адрес шлюза, заменяет эндпоинт Google по умолчанию |
| `GEMINI_API_KEY`         | Ваш API Key                                                 |
| `GEMINI_MODEL`           | Модель, используемая по умолчанию                           |

### Пример настройки

```bash
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

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

```bash
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](https://docs.aicentos.com/clients/gemini-cli.html)