Подключение 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: проверка связи
- Чтение изображений (визуальный ввод) и генерация изображений
- Диагностика
- Далее
Последняя проверка: 2026-09-18 · 📄 По официальной документации (Antigravity CLI 1.2.x (манифест автообновления 1.2.6, проверено 2026-09))
Кратко¶
| Параметр | Описание |
|---|---|
| Доступные модели | Через QCode: Gemini ✅ (нативный протокол, GOOGLE_GEMINI_BASE_URL) · Claude / GPT / китайские ❌. Это ограничение эндпоинта, а не самого инструмента: при входе через аккаунт Google на официальной странице моделей есть и другие семейства, но это квота Google, а не наша |
| Протокол и Base URL | Gemini: https://api.qcode.cc/gemini (материковый Китай — asia.qcode.cc) |
| Где настраивается | ~/.gemini/antigravity-cli/settings.json + переменные GEMINI_API_KEY / GOOGLE_GEMINI_BASE_URL |
| Официальная документация | antigravity.google |
⚠️ Переходите с 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.
| Параметр | Значение |
|---|---|
| Файл конфигурации | ~/.gemini/antigravity-cli/settings.json |
| Ключевое поле | "modelProvider": "gemini" |
| Учётные данные | Переменная GEMINI_API_KEY (ваш ключ QCode cr_) |
| Переопределение точки | Переменная GOOGLE_GEMINI_BASE_URL |
| Что он не читает | Официально: agy не загружает файлы .env, а GOOGLE_API_KEY не действует — ключ берётся только из переменной окружения GEMINI_API_KEY. Gemini CLI подхватывает .env автоматически, так что поведение противоположное; в CI это запоминается с первого раза |
| Доступные модели | Через 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
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, но это поведение 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.
Диагностика¶
| Симптом | Вероятная причина | Решение |
|---|---|---|
| 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 и модели изображений (по разным протоколам — см. таблицу выше). См. тарифы.