Быстрая установка Antigravity Auth: настройка плагина за 5 минут

Быстрая установка Antigravity Auth позволяет настроить плагин OpenCode всего за 5 минут и начать использовать продвинутые модели Claude и Gemini 3. Это руководство предлагает два способа установки (с помощью AI/вручную), охватывая установку плагина, OAuth-аутентификацию, определение моделей и шаги проверки.

Что вы сможете после изучения

✅ Установить плагин Antigravity Auth за 5 минут
✅ Настроить доступ к моделям Claude и Gemini 3
✅ Выполнить Google OAuth-аутентификацию и проверить успешность установки

Ваша текущая ситуация

Вы хотите попробовать мощные функции Antigravity Auth (Claude Opus 4.5, Sonnet 4.5, Gemini 3 Pro/Flash), но не знаете, как установить плагин и настроить модели, опасаясь запутаться.

Когда использовать это руководство

При первом использовании плагина Antigravity Auth
При установке OpenCode на новой машине
При необходимости перенастроить плагин

🎒 Подготовка к началу

Предварительная проверка

Перед началом убедитесь, что:

[ ] Установлен OpenCode CLI (команда opencode доступна)
[ ] Есть действующий Google-аккаунт (для OAuth-аутентификации)
[ ] Вы ознакомились с базовыми концепциями Antigravity Auth (прочитали Что такое Antigravity Auth?)

Основная концепция

Процесс установки Antigravity Auth состоит из 4 шагов:

Установка плагина → Включение плагина в конфигурации OpenCode
OAuth-аутентификация → Вход через Google-аккаунт
Настройка моделей → Добавление определений моделей Claude/Gemini
Проверка установки → Тестирование первым запросом

Важное примечание: Путь к файлу конфигурации одинаков на всех системах: ~/.config/opencode/opencode.json (на Windows ~ автоматически разрешается в пользовательскую директорию, например C:\Users\YourName).

Следуйте инструкциям

Шаг 1: Выберите способ установки

Antigravity Auth предлагает два способа установки, выберите любой.

Рекомендуемый способ

Если вы используете LLM Agent (например, Claude Code, Cursor, OpenCode), рекомендуется использовать установку с помощью AI — быстрее и проще.

Способ 1: Установка с помощью AI (рекомендуется)

Просто скопируйте следующий промпт и вставьте в любой LLM Agent:

Install opencode-antigravity-auth plugin and add Antigravity model definitions to ~/.config/opencode/opencode.json by following: https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/dev/README.md

AI автоматически выполнит:

Редактирование ~/.config/opencode/opencode.json
Добавление конфигурации плагина
Добавление полных определений моделей
Выполнение opencode auth login для аутентификации

Вы должны увидеть: AI выводит сообщение "Плагин успешно установлен" или аналогичное.

Способ 2: Ручная установка

Если предпочитаете ручной контроль, следуйте этим шагам:

Шаг 1.1: Добавление плагина в файл конфигурации

Отредактируйте ~/.config/opencode/opencode.json (создайте файл, если не существует):

json

{
  "plugin": ["opencode-antigravity-auth@latest"]
}

Бета-версия: Чтобы опробовать новейшие функции, используйте opencode-antigravity-auth@beta вместо @latest.

Вы должны увидеть: Файл конфигурации содержит поле plugin со значением-массивом.

Шаг 2: Выполнение Google OAuth-аутентификации

В терминале выполните:

bash

opencode auth login

Система автоматически:

Запустит локальный OAuth-сервер (прослушивает localhost:51121)
Откроет браузер и перенаправит на страницу авторизации Google
Получит OAuth callback и обменяет на токен
Автоматически получит ID проекта Google Cloud

Вам нужно сделать:

В браузере нажать "Разрешить" для авторизации доступа
Если используете WSL или Docker, возможно, потребуется вручную скопировать callback URL

Вы должны увидеть:

✅ Authentication successful
✅ Account added: [email protected]
✅ Project ID resolved: cloud-project-id-xxx

Поддержка нескольких аккаунтов

Нужно добавить больше аккаунтов для увеличения квоты? Просто снова выполните opencode auth login. Плагин поддерживает до 10 аккаунтов с автоматическим балансированием нагрузки.

Шаг 3: Настройка определений моделей

Скопируйте следующую полную конфигурацию и добавьте в ~/.config/opencode/opencode.json (без замены существующего поля plugin):

json

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-antigravity-auth@latest"],
  "provider": {
    "google": {
      "models": {
        "antigravity-gemini-3-pro": {
          "name": "Gemini 3 Pro (Antigravity)",
          "limit": { "context": 1048576, "output": 65535 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingLevel": "low" },
            "high": { "thinkingLevel": "high" }
          }
        },
        "antigravity-gemini-3-flash": {
          "name": "Gemini 3 Flash (Antigravity)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "minimal": { "thinkingLevel": "minimal" },
            "low": { "thinkingLevel": "low" },
            "medium": { "thinkingLevel": "medium" },
            "high": { "thinkingLevel": "high" }
          }
        },
        "antigravity-claude-sonnet-4-5": {
          "name": "Claude Sonnet 4.5 (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "antigravity-claude-sonnet-4-5-thinking": {
          "name": "Claude Sonnet 4.5 Thinking (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
            "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
          }
        },
        "antigravity-claude-opus-4-5-thinking": {
          "name": "Claude Opus 4.5 Thinking (Antigravity)",
          "limit": { "context": 200000, "output": 64000 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] },
          "variants": {
            "low": { "thinkingConfig": { "thinkingBudget": 8192 } },
            "max": { "thinkingConfig": { "thinkingBudget": 32768 } }
          }
        },
        "gemini-2.5-flash": {
          "name": "Gemini 2.5 Flash (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-2.5-pro": {
          "name": "Gemini 2.5 Pro (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-3-flash-preview": {
          "name": "Gemini 3 Flash Preview (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65536 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        },
        "gemini-3-pro-preview": {
          "name": "Gemini 3 Pro Preview (Gemini CLI)",
          "limit": { "context": 1048576, "output": 65535 },
          "modalities": { "input": ["text", "image", "pdf"], "output": ["text"] }
        }
      }
    }
  }
}

Категории моделей

Квота Antigravity (Claude + Gemini 3): antigravity-gemini-*, antigravity-claude-*
Квота Gemini CLI (независимая): gemini-2.5-*, gemini-3-*-preview

Подробнее о конфигурации моделей см. в полном списке доступных моделей.

Вы должны увидеть: файл конфигурации содержит полное определение provider.google.models, и JSON-формат корректен (без синтаксических ошибок).

Шаг 4: Проверка установки

Выполните следующую команду для тестирования работы плагина:

bash

opencode run "Hello" --model=google/antigravity-claude-sonnet-4-5-thinking --variant=max

Вы должны увидеть:

Используется: google/antigravity-claude-sonnet-4-5-thinking (max)
...

Claude: Привет! Я Claude Sonnet 4.5 Thinking.

Контрольная точка ✅

Если вы видите нормальный ответ от AI, поздравляем! Плагин Antigravity Auth успешно установлен и настроен.

Распространённые проблемы

Проблема 1: Ошибка OAuth-аутентификации

Симптомы: при выполнении opencode auth login появляется сообщение об ошибке, например invalid_grant или страница авторизации не открывается.

Причина: изменение пароля Google-аккаунта, инцидент безопасности или неполный callback URL.

Решение:

Проверьте, открылась ли в браузере страница авторизации Google
Если используете WSL/Docker, вручную скопируйте callback URL из терминала в браузер
Удалите ~/.config/opencode/antigravity-accounts.json и повторите аутентификацию

Проблема 2: Модель не найдена (ошибка 400)

Симптомы: при выполнении запроса возвращается 400 Unknown name 'xxx'.

Причина: ошибка в написании имени модели или проблема с форматом конфигурационного файла.

Решение:

Проверьте, точно ли параметр --model совпадает с ключом в конфигурации (с учётом регистра)
Убедитесь, что opencode.json является корректным JSON (проверьте с помощью cat ~/.config/opencode/opencode.json | jq)
Убедитесь, что в поле provider.google.models присутствует соответствующее определение модели

Проблема 3: Неправильный путь к файлу конфигурации

Симптомы: сообщение "конфигурационный файл не существует" или изменения не применяются.

Причина: использование неправильного пути на разных системах.

Решение: на всех системах используйте единый путь ~/.config/opencode/opencode.json, включая Windows (~ автоматически разрешается в пользовательскую директорию).

Система	Правильный путь	Неправильный путь
macOS/Linux	`~/.config/opencode/opencode.json`	`/usr/local/etc/...`
Windows	`C:\Users\YourName\.config\opencode\opencode.json`	`%APPDATA%\opencode\...`

Резюме урока

В этом уроке мы выполнили:

✅ Два способа установки (с помощью AI / ручная настройка)
✅ Процесс Google OAuth-аутентификации
✅ Полную настройку моделей (Claude + Gemini 3)
✅ Проверку установки и решение распространённых проблем

Ключевые моменты:

Единый путь к файлу конфигурации: ~/.config/opencode/opencode.json
OAuth-аутентификация автоматически получает Project ID, ручная настройка не требуется
Поддержка нескольких аккаунтов для увеличения квоты
Используйте параметр variant для управления глубиной размышления моделей Thinking

Следующий урок

В следующем уроке мы изучим Первый вход: глубокое понимание OAuth 2.0 PKCE.
Вы узнаете:
Принцип работы OAuth 2.0 PKCE
Механизм обновления токенов
Процесс автоматического разрешения Project ID
Формат хранения аккаунтов

Приложение: справочник по исходному коду

Нажмите, чтобы развернуть расположение исходного кода

Обновлено: 2026-01-23

Функция	Путь к файлу	Строки
Генерация URL авторизации OAuth	`src/antigravity/oauth.ts`	91-113
Генерация ключей PKCE	`src/antigravity/oauth.ts`	1-2
Обмен токенами	`src/antigravity/oauth.ts`	201-270
Автоматическое получение Project ID	`src/antigravity/oauth.ts`	131-196
Получение информации о пользователе	`src/antigravity/oauth.ts`	231-242

Ключевые константы:

ANTIGRAVITY_CLIENT_ID: ID клиента OAuth (для Google-аутентификации)
ANTIGRAVITY_REDIRECT_URI: Callback-адрес OAuth (фиксированный http://localhost:51121/oauth-callback)
ANTIGRAVITY_SCOPES: Список областей доступа OAuth

Ключевые функции:

authorizeAntigravity(): Формирует URL авторизации OAuth с PKCE challenge
exchangeAntigravity(): Обменивает код авторизации на access token и refresh token
fetchProjectID(): Автоматически разрешает ID проекта Google Cloud
encodeState() / decodeState(): Кодирует/декодирует параметр state OAuth (содержит PKCE verifier)

Быстрая установка Antigravity Auth: настройка плагина за 5 минут ​

Что вы сможете после изучения ​

Ваша текущая ситуация ​

Когда использовать это руководство ​

🎒 Подготовка к началу ​

Основная концепция ​

Следуйте инструкциям ​

Шаг 1: Выберите способ установки ​

Шаг 2: Выполнение Google OAuth-аутентификации ​

Шаг 3: Настройка определений моделей ​

Шаг 4: Проверка установки ​

Распространённые проблемы ​

Проблема 1: Ошибка OAuth-аутентификации ​

Проблема 2: Модель не найдена (ошибка 400) ​

Проблема 3: Неправильный путь к файлу конфигурации ​

Резюме урока ​

Следующий урок ​

Приложение: справочник по исходному коду ​