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

> **Последняя проверка**: 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](https://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](/docs/ide/gemini), переходит на способ отсюда.

[Google Antigravity](https://antigravity.google/) — это то, чем 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](/docs/getting-started/installation),
> [Codex CLI](/docs/ide/codex), [Cline](/docs/ide/cline), [Zed](/docs/ide/zed).
> Какие модели доступны по какому протоколу — в
> [Точках доступа и форматах API](/docs/getting-started/endpoints-and-api-paths).

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

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

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

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

- API-ключ QCode.cc (начинается с `cr_`) из [консоли](https://qcode.cc/dashboard)
- Знакомство с [Точками доступа и форматами API](/docs/getting-started/endpoints-and-api-paths)

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

Ориентируйтесь на [официальную документацию](https://antigravity.google/docs/cli/install):

<div data-os="macos" markdown="1">

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

</div>

<div data-os="linux" markdown="1">

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

</div>

<div data-os="windows" markdown="1">

PowerShell:

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

CMD:

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

</div>

На официальной странице установки упомянуты `--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`:

```json
{
  "modelProvider": "gemini"
}
```

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

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

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

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

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

```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](/docs/getting-started/endpoints-and-api-paths).

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

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

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

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

```bash
# Список моделей 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](https://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](/docs/usage/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](/docs/getting-started/endpoints-and-api-paths) — таблица «протокол × семейство моделей»
- [Интеграция с Gemini CLI](/docs/ide/gemini) — предшественник (корпоративные ключи ещё работают)
- [Субагенты](/docs/advanced/subagents) — оркестрация фоновых агентов
- [Автоматизация и CI/CD](/docs/advanced/headless) — headless-режим и скрипты

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