Antigravity CLI

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

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

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

macOS / LinuxКопировать ссылку на якорь

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

Windows (PowerShell)Копировать ссылку на якорь

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

Windows (CMD)Копировать ссылку на якорь

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

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

agy --version

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

Включение режима API KeyКопировать ссылку на якорь

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

{
  "modelProvider": "gemini"
}

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

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

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.

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

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