# Antigravity

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

Language: ru

> Google Antigravity пока не поддерживает кастомный Base URL — об ограничении и доступных альтернативах

Antigravity — агентская IDE от Google. Сначала важная оговорка: **официальная версия Antigravity Desktop IDE не поддерживает кастомные API-эндпоинты и не предоставляет BYOK (собственный ключ)**; в селекторе моделей — фиксированный список, поддерживаемый Google, и направить его на aicentos сейчас невозможно.

В этом документе разбираются основания для такого ограничения, способ его проверить и три доступных обходных пути.

## Почему прямое подключение невозможно

В официальной документации по аккаунтам Google прямо сказано, что Antigravity пока не поддерживает собственные модели или собственные эндпоинты. Ходящие по сообществу параметры конфигурации (например, `antigravity.ai.provider` и `antigravity.openai-compatible.endpoint` в `~/.antigravity/settings.json`) официальными ключами не являются: на практике запросы либо не маршрутизируются на кастомный эндпоинт, либо молча откатываются к модели по умолчанию, а в селекторе моделей кастомные записи не появляются.

Иначе говоря, дело не в «ошибке в конфигурации», а в том, что текущая версия просто не открывает эту возможность. В `Settings → Models` IDE тоже нет поля для Base URL.

## Конфигурация для заполнения

| Поле     | Значение                                  |
| -------- | ----------------------------------------- |
| API Key  | ключ, созданный в консоли                 |
| Base URL | `https://aicentos.com/v1`                 |
| Модель   | имя модели из «витрины моделей» в консоли |

В таблице выше — общие параметры на стороне aicentos; они пригодятся для любого из обходных путей ниже.

## Альтернативные варианты

### Вариант 1: перейти на Antigravity CLI (рекомендуется, только протокол Gemini)

Одноимённая консольная утилита `agy` поддерживает переопределение эндпоинта: подключение выполняется через `GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY`, но принимается только протокол Gemini и доступны только модели семейства Gemini. Подробные шаги см. в документе [Подключение Antigravity CLI](https://docs.aicentos.com/ru/clients/antigravity-cli).

Если ваша задача — «взаимодействовать с Antigravity в терминале», это самый простой путь.

### Вариант 2: обернуть локальные модели или сторонние сервисы в инструменты MCP

Панель Customizations в Antigravity поддерживает регистрацию MCP-серверов. Можно обернуть локальный сервис в MCP-инструмент и подключить его — как **вызываемый инструмент**. Учтите: это не заменит модель рассуждений IDE, а лишь добавит агенту ещё один инструмент.

### Вариант 3: форк сообщества или локальный прокси

* Форк сообщества `open-antigravity` поддерживает любые OpenAI-совместимые эндпоинты и кастомные модели — самый чистый путь вне официальной версии.
* Некоторые переписывают исходящий трафик IDE через локальный перехватывающий прокси. У этого пути нет официальной поддержки: конфигурация хрупкая и ломается при каждом обновлении, использовать его в продакшене не рекомендуется.

## Проверка

Какой бы путь вы ни выбрали, сначала убедитесь в связности простым коротким промптом и только потом переходите к полноценной работе. Для агентских задач рекомендуется начать с небольшого репозитория.

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

* **Не принимайте «параметр вроде бы существует» за «функция работает»**. Ключи `antigravity.*` в IDE — в основном догадки сообщества: при записи ошибок не возникает, но и эффекта нет.
* Если вам нужен OpenAI-совместимый протокол или доступ к моделям серий Claude / GPT, десктопная версия Antigravity сейчас этого не обеспечит — обратите внимание на клиенты с поддержкой кастомного Base URL, например [Cursor](https://docs.aicentos.com/ru/clients/cursor) или [Windsurf](https://docs.aicentos.com/ru/clients/windsurf).
* Antigravity CLI и десктопная IDE — две отдельные конфигурации; переопределение эндпоинта в CLI не влияет на IDE.
* Перед использованием любого стороннего форка или прокси самостоятельно оцените их безопасность и дальнейшую сопровождаемость.

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

* [Подключение Antigravity CLI](https://docs.aicentos.com/ru/clients/antigravity-cli)