Интеграция Google Antigravity CLI

Настройка Google Antigravity CLI с ключом API QCode.cc: отредактируйте ~/.config/antigravity/config.toml, укажите OpenAI-совместимый base_url и модель

Интеграция Google Antigravity CLI¶

⚠️ Переход с Gemini CLI на Antigravity CLI: Google Antigravity стал доступен 2026-05-19, а Gemini CLI достиг окончания поддержки (EOL) для пользователей Pro / бесплатного тарифа 2026-06-18; корпоративные платные ключи это не затрагивает — они продолжают работать с Gemini CLI после EOL. Если ранее вы настраивали всё по интеграции Gemini CLI, рекомендуем перейти на способ через Antigravity CLI, описанный на этой странице.

Google Antigravity — это командная утилита нового поколения для ИИ-программирования от Google, призванная заменить прекративший поддержку Gemini CLI. Она поддерживает пользовательские / OpenAI-совместимые эндпоинты моделей, поэтому вы можете указать QCode.cc в качестве апстрима и одним ключом QCode вызывать модели Claude, GPT, Gemini и других.

🚧 Инструмент всё ещё быстро развивается: Antigravity — новый инструмент, его параметры конфигурации и поведение продолжают меняться. На этой странице приведён известный на текущий момент рабочий подход; точные имена ключей конфигурации, пути по умолчанию и смысл полей смотрите в официальной документации: https://antigravity.google/docs. Все неопределённые места ниже отмечены явно.

Зачем ставить QCode апстримом для Antigravity¶

• Один ключ — много моделей: единый ключ QCode cr_ покрывает Claude, GPT, Gemini, модели изображений и другие
• OpenAI-совместимость: Antigravity поддерживает пользовательские / OpenAI-совместимые модели, достаточно указать эндпоинт OpenAI Chat у QCode
• Общая квота: использует ту же квоту тарифа, что и Claude Code, OpenAI Codex и другие инструменты — можно свободно переключаться
• Домены под регион: помимо api.qcode.cc доступны входы asia / us / eu; пользователям в Китае следует предпочитать asia.qcode.cc

Предварительные требования¶

• Установлен Google Antigravity (способ установки — по официальной документации)
• Есть ключ API QCode.cc (начинается с cr_), полученный в панели управления
• Знакомство с эндпоинтами и форматами API QCode

Доступные модели¶

Antigravity подключается через OpenAI-совместимый эндпоинт. Ниже — часто используемые модели QCode (вписываются в поле model конфигурации):

Полный список моделей и цен — в разделе выбор модели. Семейство Gemini тарифицируется с коэффициентом ×2.

Шаги настройки¶

Файл конфигурации Antigravity находится по пути ~/.config/antigravity/config.toml (точный путь уточните в официальной документации). Главное — направить base_url на эндпоинт OpenAI Chat у QCode и указать ключ QCode и модель.

Шаг 1: подготовьте base_url и ключ¶

Эндпоинт OpenAI Chat у QCode:

https://api.qcode.cc/openai/v1

Пользователям в Китае следует предпочитать https://asia.qcode.cc/openai/v1 (аналогично для us / eu). Не ставьте завершающий слэш / в base_url. Antigravity автоматически добавляет /chat/completions.

Шаг 2: отредактируйте config.toml¶

Откройте (или создайте) ~/.config/antigravity/config.toml и впишите примерно следующее:

# ~/.config/antigravity/config.toml
# Примечание: имена ключей ниже — известное на текущий момент использование; точные поля смотрите на https://antigravity.google/docs

# Апстрим QCode (OpenAI-совместимый эндпоинт)
base_url = "https://api.qcode.cc/openai/v1"   # в Китае можно заменить на https://asia.qcode.cc/openai/v1

# Выбранная модель (см. таблицу выше)
model = "claude-opus-4-8"

# Ключ API: рекомендуется передавать через переменную окружения, а не хранить в открытом виде
# например, читать переменную окружения OPENAI_API_KEY
api_key_env = "OPENAI_API_KEY"

Поместите ключ в переменную окружения (для постоянства пропишите в ~/.zshrc / ~/.bashrc):

export OPENAI_API_KEY="cr_xxxxxxxxxxxxxxxx"

🚧 Имена полей — по официальной документации: указанные выше base_url / model / api_key_env — это распространённые соглашения для OpenAI-совместимых инструментов, но точные имена ключей в Antigravity (например, api_key, apiKey, вложенная секция provider и т. п.) могут отличаться — следуйте официальной документации. Если какой-то ключ не распознаётся, подстройтесь под официальные примеры, а не копируйте эту страницу дословно.

Шаг 3: проверьте подключение¶

Самый прямой способ проверки — обратиться к эндпоинту QCode напрямую, минуя инструмент. Этот curl отправляет минимальный запрос с вашим ключом:

curl -s https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "messages": [{"role": "user", "content": "ping"}]
  }'

• Обычный JSON-ответ с дополнением чата → и эндпоинт, и ключ в порядке
• Ответ 401 → путь правильный, просто ключ отсутствует или указан неверно (это ожидаемый сигнал самопроверки; задайте корректный Authorization)

Убедившись, что эндпоинт работает, вернитесь в Antigravity и запустите простой диалог, чтобы подтвердить, что он действительно обращается к апстриму QCode.

Ввод изображений (чтение) против генерации изображений¶

Инструменты вроде Antigravity / Claude Code умеют читать изображения — передайте скриншот интерфейса, скриншот ошибки или архитектурную схему модели с поддержкой зрения, чтобы она написала код или нашла ошибку. Это не то же самое, что генерация изображений:

• Чтение изображений (визуальный ввод): укажите путь к файлу изображения в запросе либо вставьте / перетащите изображение. Модели с поддержкой зрения: Claude Opus 4.8 / Sonnet 4.6 и GPT-5.x. Типичные задачи: воссоздать UI по макету, найти баг по скриншоту ошибки, прочитать архитектурные схемы / диаграммы.
• Генерация изображений: для этого нужна отдельная модель изображений gpt-image-2 через эндпоинт изображений QCode — см. генерация изображений gpt-image-2.

Не путайте эти две вещи: чтобы модель «поняла изображение», используйте визуальный ввод; чтобы модель «нарисовала изображение», используйте gpt-image-2.

Устранение неполадок¶

Дальнейшие шаги¶

• Эндпоинты и форматы API — полная таблица четырёх доменов и путей по протоколам
• Интеграция Gemini CLI — старый инструмент до перехода (корпоративные ключи всё ещё работают)
• Субагенты — оркестрация нескольких фоновых агентов
• Автоматизация и CI/CD — безголовый режим и скриптинг

Ещё нет ключа QCode? Один ключ cr_ покрывает Claude, GPT, Gemini и модели изображений. Посмотрите тарифные планы, чтобы начать.