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

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

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

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

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

Пользовательская точка Antigravity CLI — Gemini-совместимая, задаётся переменной окружения GOOGLE_GEMINI_BASE_URL. OpenAI-совместимую точку он не принимает и вызывать через него модели Claude или GPT нельзя.

Для 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.

Шаг 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"

Base URL заканчивается на /gemini — не добавляйте /v1beta. Клиент сам дописывает /v1beta/models/{model}:generateContent, поэтому с ним получится /gemini/v1beta/v1beta/... и ошибка 404. Это противоположно провайдеру 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.cc/models.

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

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

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

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

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

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

Далее¶

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

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