# Antigravity CLI

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

Language: ru

> Использование aicentos в Antigravity CLI — подключение в режиме API Key

Antigravity CLI — консольный инструмент от Google, поддерживающий в режиме API Key подключение к сервисам, совместимым с Gemini API. В этом документе описано, как настроить Antigravity CLI на использование кастомного API-эндпоинта.

## Установка

Выберите способ установки под свою операционную систему:

### macOS / Linux

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
```

### Windows (PowerShell)

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
```

### Windows (CMD)

```cmd
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

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

```bash
agy --version
```

## Настройка

### Включение режима API Key

Отредактируйте `~/.gemini/antigravity-cli/settings.json`, добавив в существующий JSON:

```json
{
  "modelProvider": "gemini"
}
```

⚠️ **Внимание**: одной установки `GEMINI_API_KEY` недостаточно для переключения способа аутентификации. `modelProvider` обязательно должен быть строчным `"gemini"`.

### Задание переменных окружения

```bash
export GOOGLE_GEMINI_BASE_URL="https://aicentos.com"
export GEMINI_API_KEY="your_api_key_here"
```

**Важные пояснения:**

* В `GOOGLE_GEMINI_BASE_URL` указывайте корневой адрес сервиса, без конкретных путей к методам. Эндпоинт должен быть совместим с Gemini API.
* В `GEMINI_API_KEY` укажите ваш API Key.
* Выполняйте эти команды в том же shell, из которого запускается `agy`. CLI не читает `.env` и `GOOGLE_API_KEY`.

Для постоянного действия запишите оба `export` в `~/.zshrc` или `~/.bashrc`.

## Запуск и проверка

```bash
agy --model gemini-2.0-flash
```

Когда вверху отобразится `Gemini API key`, отправьте одно сообщение.

### Устранение типичных проблем

* **Всё ещё требует входа**: проверьте `"modelProvider": "gemini"`, выйдите и запустите `agy` заново.
* **При запуске сообщается об отсутствии Key**: заново задайте `GEMINI_API_KEY` в текущем shell.
* **Запросы завершаются ошибкой**: проверьте API Key, корневой адрес сервиса и права доступа к выбранной модели.

## Примечания

* Чтобы режим API Key работал, необходимо одновременно задать и параметр конфигурации `modelProvider`, и переменные окружения
* Переменные окружения нужно задавать в той сессии shell, где запускается CLI, либо прописать в конфигурационном файле shell для постоянного действия
* Эндпоинт сервиса должен соответствовать спецификации Gemini API

## Полезные ссылки

* Официальная документация: [https://docs.aicentos.com/clients/antigravity-cli.html](https://docs.aicentos.com/clients/antigravity-cli.html)