Подключение Google Antigravity CLI
Настройка Google Antigravity CLI (agy) с ключом QCode.cc: modelProvider в settings.json, переменные GEMINI_API_KEY и GOOGLE_GEMINI_BASE_URL на точку Gemini у QCode
Содержание
- 🔴 Сначала главное: только протокол Gemini
- 🔴 IDE Antigravity (настольная версия 2.0) подключить нельзя
- Предварительные требования
- Шаг 1: установка Antigravity CLI
- Шаг 2: перейти на авторизацию по API-ключу (без входа в Google)
- Шаг 3: направить ключ и точку на QCode
- Шаг 4: проверка связи
- Чтение изображений (визуальный ввод) и генерация изображений
- Диагностика
- Далее
⚠️ Переход с 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 нельзя.
| Параметр | Значение |
|---|---|
| Файл конфигурации | ~/.gemini/antigravity-cli/settings.json |
| Ключевое поле | "modelProvider": "gemini" |
| Учётные данные | Переменная GEMINI_API_KEY (ваш ключ QCode cr_) |
| Переопределение точки | Переменная GOOGLE_GEMINI_BASE_URL |
| Доступные модели | Только семейство 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
PowerShell:
irm https://antigravity.google/cli/install.ps1 | iex
# устанавливается в C:\Users\<пользователь>\AppData\Local\agy\bin
CMD:
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.
Диагностика¶
| Симптом | Вероятная причина | Решение |
|---|---|---|
| CLI не запускается | Задан modelProvider: "gemini", но нет GEMINI_API_KEY |
Добавьте переменную либо уберите поле и вернитесь к входу по аккаунту |
| 401 | Ключ не передан или неверен | Проверьте GEMINI_API_KEY: префикс cr_, без пробелов |
| 404 | В GOOGLE_GEMINI_BASE_URL есть /v1beta или слеш в конце |
Заканчивайте на /gemini, без завершающего / |
model_not_available_on_endpoint |
Запрошена модель Claude / GPT | Этот протокол обслуживает только Gemini; смените клиент или модель |
| Ошибка имени модели | Снятый с продажи или неверно набранный id | Выполните curl из шага 4 и посмотрите реальный набор |
| Медленно / таймауты из Китая | Используется основной домен api |
Перейдите на https://asia.qcode.cc/gemini |
/logout не действует |
Используется авторизация по API-ключу | Это ожидаемо: сессии нет |
Далее¶
- Точки доступа и форматы API — таблица «протокол × семейство моделей»
- Интеграция с Gemini CLI — предшественник (корпоративные ключи ещё работают)
- Субагенты — оркестрация фоновых агентов
- Автоматизация и CI/CD — headless-режим и скрипты
Ещё нет ключа QCode? Один ключ
cr_покрывает Claude, GPT, Gemini и модели изображений (по разным протоколам — см. таблицу выше). См. тарифы.