Подключение Google Antigravity CLI

Настройка Google Antigravity CLI (agy) с ключом QCode.cc: modelProvider в settings.json, переменные GEMINI_API_KEY и GOOGLE_GEMINI_BASE_URL на точку Gemini у QCode

Последняя проверка: 2026-09-18 · 📄 По официальной документации (Antigravity CLI 1.2.x (манифест автообновления 1.2.6, проверено 2026-09))

Кратко¶

⚠️ Переходите с Gemini CLI? В официальном посте от 2026-05-19 дословно сказано, что с 2026-06-18 Gemini CLI и расширения Gemini Code Assist для IDE «will stop serving requests» — для Google AI Pro и Ultra, а также для тех, кто бесплатно использует их с личного аккаунта. Корпоративные платные ключи не затронуты: там же указано, что Gemini CLI остаётся доступным через платные ключи Gemini и Gemini Enterprise Agent Platform. В тот день вышли Antigravity CLI и Antigravity 2.0; сама IDE Antigravity появилась раньше — 2025-11-18. Кто настраивал всё по интеграции с Gemini CLI, переходит на способ отсюда.

Google Antigravity — это то, чем Google заменило Gemini CLI для личных аккаунтов. Состоит из трёх частей: настольная IDE, командная строка Antigravity CLI (agy, написана на Go) и SDK. Эта страница посвящена только CLI: как указать QCode.cc в качестве источника моделей.

🔴 Сначала главное: только протокол Gemini¶

Пользовательская точка Antigravity CLI — Gemini-совместимая, задаётся переменной окружения GOOGLE_GEMINI_BASE_URL. В официальной таблице устранения неполадок дословно про modelProvider: «gemini — единственное допустимое значение». Поэтому этот путь не принимает OpenAI-совместимую точку, а через QCode отдаёт только семейство Gemini.

Для Claude или GPT выберите другой клиент — Claude Code, Codex CLI, Cline, Zed. Какие модели доступны по какому протоколу — в Точках доступа и форматах API.

🔴 IDE Antigravity (настольная версия 2.0) подключить нельзя¶

У настольной IDE Antigravity сейчас нет официального BYOK или точки подключения своего провайдера, поэтому заменить модель встроенного агента на стороннюю точку невозможно. В сообществе есть обходные решения через локальный перехватывающий прокси, но это результат обратной разработки без официальной поддержки, и эта страница их не рекомендует.

К QCode подключается CLI (agy), а не IDE.

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

• API-ключ QCode.cc (начинается с cr_) из консоли
• Знакомство с Точками доступа и форматами API

Шаг 1: установка Antigravity CLI¶

Ориентируйтесь на официальную документацию:

curl -fsSL https://antigravity.google/cli/install.sh | bash
# устанавливается в ~/.local/bin/agy

curl -fsSL https://antigravity.google/cli/install.sh | bash
# устанавливается в ~/.local/bin/agy

irm https://antigravity.google/cli/install.ps1 | iex
# устанавливается в C:\Users\<пользователь>\AppData\Local\agy\bin

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

На официальной странице установки упомянуты --skip-aliases и --skip-path, но это поведение Windows: install.ps1 / install.cmd передают аргументы команде agy install, тогда как install.sh в macOS / Linux понимает только -d, --dir <путь> и -h, --help и завершается на неизвестном аргументе. Не переносите эти два флага на macOS / Linux.

Шаг 2: перейти на авторизацию по API-ключу (без входа в Google)¶

По умолчанию agy читает системное хранилище ключей или открывает браузер для входа в аккаунт Google. Чтобы использовать API-ключ, отредактируйте (или создайте) ~/.gemini/antigravity-cli/settings.json:

{
  "modelProvider": "gemini"
}

С этой настройкой agy пропускает экран входа и сразу открывает основной интерфейс, читая переменную GEMINI_API_KEY.

🔴 Если "modelProvider": "gemini" задан, а GEMINI_API_KEY отсутствует, CLI не запустится. Нужны обе части.

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

export GEMINI_API_KEY="cr_ваш_ключ_QCode"
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"

Добавьте в ~/.zshrc / ~/.bashrc для постоянного действия. Windows PowerShell:

$env:GEMINI_API_KEY = "cr_ваш_ключ_QCode"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"

GOOGLE_GEMINI_BASE_URL — до /gemini, /v1beta не добавляйте: официальный пример — это голый адрес (export GOOGLE_GEMINI_BASE_URL="https://your-endpoint.example.com"), а версию и путь клиент дописывает сам. agy — закрытый Go-клиент; Google не описала ни правило склейки, ни то, нормализуется ли завершающий / (SDK на стороне Gemini CLI один такой слэш снимает). Поэтому держимся официальной формы и не гадаем про граничные случаи. Это противоположно провайдеру google в OpenCode (там /v1beta нужен); разница описана в Точках доступа и форматах API.

Из материкового Китая замените хост на https://asia.qcode.cc/gemini (узел в Гонконге); ключ тот же. us / eu работают аналогично.

При авторизации через GEMINI_API_KEY команда /logout ничего не делает — сохранённой сессии просто нет.

Шаг 4: проверка связи¶

Сначала обратитесь к точке Gemini у QCode напрямую, минуя инструмент:

# Список моделей Gemini, доступных сейчас
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: $GEMINI_API_KEY"

# Минимальный запрос (имя модели возьмите из списка выше)
curl -s "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}],"generationConfig":{"maxOutputTokens":16}}'

• JSON с полем candidates → точка и ключ в порядке
• 401 → путь верный, ключ отсутствует или указан неправильно

Источником истины о наборе моделей считайте живой запрос, а не фиксированный список из какого-либо документа, включая этот. Идентификаторы из первого curl — это и есть то, что отдаёт данная ветка QCode; полный каталог и цены — на qcode.cc/models.

Одна оговорка: панель /model в agy и agy --model=... оперируют отображаемыми именами продукта (вида Gemini 3.5 Flash). Google не описала, как сопоставить id из API с пунктом панели при настроенной пользовательской точке, и берётся ли этот список из вашей точки. Если нужной модели в панели нет — официальных дальнейших шагов нет; мы это не проверяли, поэтому описываем как есть.

Убедившись, что точка работает, запустите диалог в agy.

Чтение изображений (визуальный ввод) и генерация изображений¶

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

• Визуальный ввод: укажите путь к файлу изображения в запросе либо вставьте / перетащите картинку. Модели Gemini обладают зрением. Типичные задачи: воспроизвести UI по макету, найти ошибку по скриншоту, прочитать схему архитектуры.

• Генерация изображений: требуется отдельная модель gpt-image-2 на графической точке QCode — см. Генерация изображений gpt-image-2.

Диагностика¶

Далее¶

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

Ещё нет ключа QCode? Один ключ cr_ покрывает Claude, GPT, Gemini и модели изображений (по разным протоколам — см. таблицу выше). См. тарифы.