Полное руководство по параметрам конфигурации

Что вы научитесь делать

✅ Создавать файлы конфигурации в правильном месте
✅ Выбирать подходящую конфигурацию в зависимости от сценария использования
✅ Понимать назначение и значения по умолчанию всех параметров
✅ Использовать переменные окружения для временного переопределения настроек
✅ Настраивать поведение моделей, ротацию аккаунтов и поведение плагина

Ваша текущая проблема

Слишком много параметров конфигурации и непонятно, с чего начать? Конфигурация по умолчанию работает, но хотите её оптимизировать? Не знаете, какую стратегию ротации использовать при работе с несколькими аккаунтами?

Основная идея

Файл конфигурации — это как «инструкция по эксплуатации» для плагина: вы указываете, как он должен работать, и он выполняет ваши требования. Плагин Antigravity Auth предоставляет множество параметров конфигурации, но большинству пользователей достаточно настроить лишь несколько ключевых опций.

Приоритет файлов конфигурации

Приоритет параметров конфигурации (от высшего к низшему):

Переменные окружения (временное переопределение)
Конфигурация уровня проекта .opencode/antigravity.json (текущий проект)
Конфигурация уровня пользователя ~/.config/opencode/antigravity.json (глобальная)

INFO

Переменные окружения имеют наивысший приоритет и подходят для временного тестирования. Файлы конфигурации предназначены для постоянных настроек.

Расположение файлов конфигурации

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

Система	Путь
Linux/macOS	`~/.config/opencode/antigravity.json`
Windows	`%APPDATA%\opencode\antigravity.json`

Файл конфигурации уровня проекта всегда находится в .opencode/antigravity.json в корневой директории проекта.

Категории параметров конфигурации

Параметры конфигурации делятся на четыре основные категории:

Поведение моделей: блоки размышлений, восстановление сессий, Google Search
Ротация аккаунтов: управление несколькими аккаунтами, стратегии выбора, смещение PID
Поведение приложения: отладочные журналы, автообновление, отключение уведомлений
Расширенные настройки: восстановление после ошибок, управление токенами, оценка состояния

🎒 Подготовка перед началом

[x] Установка плагина завершена (см. Быстрая установка)
[x] Настроен хотя бы один аккаунт Google
[x] Базовое понимание синтаксиса JSON

Пошаговая инструкция

Шаг 1: Создание файла конфигурации

Зачем: Файл конфигурации позволяет плагину работать согласно вашим требованиям

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

macOS/LinuxWindows

bash

cat > ~/.config/opencode/antigravity.json << 'EOF'
{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
}
EOF

powershell

## Использование PowerShell
$env:APPDATA\opencode\antigravity.json = @{
  '$schema' = "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json"
} | ConvertTo-Json -Depth 10

Set-Content -Path "$env:APPDATA\opencode\antigravity.json" -Value $json

Ожидаемый результат: Файл успешно создан, содержит только поле $schema.

TIP

После добавления поля $schema VS Code автоматически предоставит интеллектуальные подсказки и проверку типов.

Шаг 2: Настройка базовых параметров

Зачем: Оптимизировать поведение плагина в соответствии с вашим сценарием использования

Выберите одну из следующих конфигураций в зависимости от вашей ситуации:

Сценарий A: Один аккаунт + нужен Google Search

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "sticky",
  "web_search": {
    "default_mode": "auto"
  }
}

Сценарий B: 2-3 аккаунта + интеллектуальная ротация

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "hybrid",
  "web_search": {
    "default_mode": "auto"
  }
}

Сценарий C: Несколько аккаунтов + параллельные агенты

json

{
  "$schema": "https://raw.githubusercontent.com/NoeFabris/opencode-antigravity-auth/main/assets/antigravity.schema.json",
  "account_selection_strategy": "round-robin",
  "switch_on_first_rate_limit": true,
  "pid_offset_enabled": true,
  "web_search": {
    "default_mode": "auto"
  }
}

Ожидаемый результат: Файл конфигурации успешно сохранён, OpenCode автоматически перезагрузит конфигурацию плагина.

Шаг 3: Проверка конфигурации

Зачем: Убедиться, что конфигурация применена

Отправьте запрос к модели в OpenCode и проверьте:

При использовании стратегии sticky с одним аккаунтом: все запросы используют один и тот же аккаунт
При использовании стратегии hybrid с несколькими аккаунтами: запросы интеллектуально распределяются между аккаунтами
При включённом web_search для моделей Gemini: модель выполняет поиск в интернете при необходимости

Ожидаемый результат: Поведение плагина соответствует вашим настройкам.

Подробное описание параметров конфигурации

Поведение моделей

Эти параметры влияют на процесс размышления и формирования ответов модели.

keep_thinking

Значение	По умолчанию	Описание
`true`	-	Сохранять блоки размышлений Claude, поддерживая связность между раундами
`false`	✓	Удалять блоки размышлений для большей стабильности и меньшего контекста

Внимание

Включение keep_thinking может привести к снижению стабильности модели и ошибкам подписи. Рекомендуется оставить false.

session_recovery

Значение	По умолчанию	Описание
`true`	✓	Автоматически восстанавливать сессии, прерванные во время вызова инструментов
`false`	-	Не восстанавливать автоматически при возникновении ошибок

auto_resume

Значение	По умолчанию	Описание
`true`	-	После восстановления автоматически отправлять "continue"
`false`	✓	После восстановления только показывать подсказку, продолжение вручную

resume_text

Пользовательский текст, отправляемый при восстановлении. По умолчанию "continue", можно изменить на любой текст.

web_search

Параметр	По умолчанию	Описание
`default_mode`	`"off"`	`"auto"` или `"off"`
`grounding_threshold`	`0.3`	Порог поиска (0=всегда искать, 1=никогда не искать)

INFO

grounding_threshold действует только при default_mode: "auto". Чем выше значение, тем консервативнее модель в отношении поиска.

Ротация аккаунтов

Эти параметры управляют распределением запросов между несколькими аккаунтами.

account_selection_strategy

Стратегия	По умолчанию	Применение
`sticky`	-	Один аккаунт, сохранение кэша промптов
`round-robin`	-	4+ аккаунтов, максимальная пропускная способность
`hybrid`	✓	2-3 аккаунта, интеллектуальная ротация

TIP

Рекомендуемые стратегии в зависимости от количества аккаунтов:

1 аккаунт → sticky
2-3 аккаунта → hybrid
4+ аккаунтов → round-robin
Параллельные агенты → round-robin + pid_offset_enabled: true

switch_on_first_rate_limit

Значение	По умолчанию	Описание
`true`	✓	При первой ошибке 429 немедленно переключиться на другой аккаунт
`false`	-	Сначала повторить попытку с текущим аккаунтом, переключиться только при второй ошибке 429

pid_offset_enabled

Значение	По умолчанию	Описание
`true`	-	Разные сессии (PID) используют разные начальные аккаунты
`false`	✓	Все сессии начинают с одного и того же аккаунта

TIP

Для одной сессии оставьте false для сохранения кэша промптов Anthropic. Для параллельных сессий рекомендуется включить true.

quota_fallback

Значение	По умолчанию	Описание
`true`	-	Резервный пул квот для моделей Gemini
`false`	✓	Не использовать резервный пул

INFO

Применимо только к моделям Gemini. При исчерпании основного пула квот пытается использовать резервный пул того же аккаунта.

Поведение приложения

Эти параметры управляют поведением самого плагина.

quiet_mode

Значение	По умолчанию	Описание
`true`	-	Отключить большинство всплывающих уведомлений (кроме уведомлений о восстановлении)
`false`	✓	Показывать все уведомления

debug

Значение	По умолчанию	Описание
`true`	-	Включить отладочные журналы
`false`	✓	Не записывать отладочные журналы

TIP

Для временного включения отладочных журналов не нужно изменять файл конфигурации, используйте переменные окружения:

bash

OPENCODE_ANTIGRAVITY_DEBUG=1 opencode   # Базовые журналы
OPENCODE_ANTIGRAVITY_DEBUG=2 opencode   # Подробные журналы

log_dir

Пользовательская директория для отладочных журналов. По умолчанию ~/.config/opencode/antigravity-logs/.

auto_update

Значение	По умолчанию	Описание
`true`	✓	Автоматически проверять и обновлять плагин
`false`	-	Не обновлять автоматически

Расширенные настройки

Эти параметры предназначены для граничных случаев, большинству пользователей не требуется их изменять.

Развернуть расширенные настройки

Восстановление после ошибок

Параметр	По умолчанию	Описание
`empty_response_max_attempts`	`4`	Количество повторных попыток при пустом ответе
`empty_response_retry_delay_ms`	`2000`	Интервал между попытками (миллисекунды)
`tool_id_recovery`	`true`	Исправление несоответствия ID инструментов
`claude_tool_hardening`	`true`	Предотвращение галлюцинаций параметров инструментов
`max_rate_limit_wait_seconds`	`300`	Максимальное время ожидания при ограничении скорости (0=бесконечно)

Управление токенами

Параметр	По умолчанию	Описание
`proactive_token_refresh`	`true`	Проактивное обновление токенов до истечения срока
`proactive_refresh_buffer_seconds`	`1800`	Обновление за 30 минут до истечения
`proactive_refresh_check_interval_seconds`	`300`	Интервал проверки обновления (секунды)

Кэш подписей (действует при `keep_thinking: true`)

Параметр	По умолчанию	Описание
`signature_cache.enabled`	`true`	Включить дисковый кэш
`signature_cache.memory_ttl_seconds`	`3600`	TTL кэша в памяти (1 час)
`signature_cache.disk_ttl_seconds`	`172800`	TTL дискового кэша (48 часов)
`signature_cache.write_interval_seconds`	`60`	Интервал фоновой записи (секунды)

Оценка состояния (используется стратегией `hybrid`)

Параметр	По умолчанию	Описание
`health_score.initial`	`70`	Начальный балл состояния
`health_score.success_reward`	`1`	Награда за успех
`health_score.rate_limit_penalty`	`-10`	Штраф за ограничение скорости
`health_score.failure_penalty`	`-20`	Штраф за неудачу
`health_score.recovery_rate_per_hour`	`2`	Восстановление баллов в час
`health_score.min_usable`	`50`	Минимальный балл для использования аккаунта
`health_score.max_score`	`100`	Максимальный балл состояния

Token Bucket (используется стратегией `hybrid`)

Параметр	По умолчанию	Описание
`token_bucket.max_tokens`	`50`	Максимальная ёмкость корзины
`token_bucket.regeneration_rate_per_minute`	`6`	Скорость восстановления в минуту
`token_bucket.initial_tokens`	`50`	Начальное количество токенов

Типичные ошибки

❌ Ошибка: Изменения конфигурации не применяются

Причина: OpenCode мог не перезагрузить файл конфигурации.

Решение: Перезапустите OpenCode или проверьте правильность синтаксиса JSON.

❌ Ошибка: Неверный формат JSON в файле конфигурации

Причина: Синтаксическая ошибка JSON (отсутствует запятая, лишняя запятая, комментарии и т.д.).

Решение: Используйте инструмент валидации JSON или добавьте поле $schema для включения интеллектуальных подсказок в IDE.

❌ Ошибка: Переменные окружения не применяются

Причина: Опечатка в имени переменной окружения или OpenCode не был перезапущен.

Решение: Убедитесь, что имя переменной OPENCODE_ANTIGRAVITY_* (все заглавные буквы, правильный префикс), перезапустите OpenCode.

❌ Ошибка: Частые ошибки после включения `keep_thinking: true`

Причина: Несоответствие подписи блока размышлений.

Решение: Оставьте keep_thinking: false (значение по умолчанию) или настройте параметры signature_cache.

Итоги урока

Приоритет расположения файлов конфигурации: переменные окружения > уровень проекта > уровень пользователя.

Ключевые параметры конфигурации:

Поведение моделей: keep_thinking, session_recovery, web_search
Ротация аккаунтов: account_selection_strategy, pid_offset_enabled
Поведение приложения: debug, quiet_mode, auto_update

Рекомендуемые конфигурации для разных сценариев:

Один аккаунт: sticky
2-3 аккаунта: hybrid
4+ аккаунтов: round-robin
Параллельные агенты: round-robin + pid_offset_enabled: true

Анонс следующего урока

В следующем уроке мы изучим Отладочные журналы.
Вы узнаете:
Как включить отладочные журналы
Как интерпретировать содержимое журналов
Как диагностировать типичные проблемы

Приложение: Ссылки на исходный код

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

Дата обновления: 2026-01-23

Функция	Путь к файлу	Строки
Определение схемы конфигурации	`src/plugin/config/schema.ts`	12-323
Значения по умолчанию	`src/plugin/config/schema.ts`	325-373
Логика загрузки конфигурации	`src/plugin/config/loader.ts`	1-100

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

DEFAULT_CONFIG: значения по умолчанию для всех параметров конфигурации

Ключевые типы:

AntigravityConfig: тип объекта конфигурации
AccountSelectionStrategy: тип стратегии выбора аккаунта
SignatureCacheConfig: тип конфигурации кэша подписей

Полное руководство по параметрам конфигурации ​

Что вы научитесь делать ​

Ваша текущая проблема ​

Основная идея ​

Приоритет файлов конфигурации ​

Расположение файлов конфигурации ​

Категории параметров конфигурации ​

🎒 Подготовка перед началом ​

Пошаговая инструкция ​

Шаг 1: Создание файла конфигурации ​

Шаг 2: Настройка базовых параметров ​

Шаг 3: Проверка конфигурации ​

Подробное описание параметров конфигурации ​

Поведение моделей ​

keep_thinking ​

session_recovery ​

auto_resume ​

resume_text ​

web_search ​

Ротация аккаунтов ​

account_selection_strategy ​

switch_on_first_rate_limit ​

pid_offset_enabled ​

quota_fallback ​

Поведение приложения ​

quiet_mode ​

debug ​

log_dir ​

auto_update ​

Расширенные настройки ​

Восстановление после ошибок ​

Управление токенами ​

Кэш подписей (действует при keep_thinking: true) ​

Оценка состояния (используется стратегией hybrid) ​

Token Bucket (используется стратегией hybrid) ​

Рекомендуемые конфигурации ​

Конфигурация для одного аккаунта ​

Конфигурация для 2-3 аккаунтов ​

Конфигурация для нескольких аккаунтов + параллельных агентов ​

Типичные ошибки ​

❌ Ошибка: Изменения конфигурации не применяются ​

❌ Ошибка: Неверный формат JSON в файле конфигурации ​

❌ Ошибка: Переменные окружения не применяются ​

❌ Ошибка: Частые ошибки после включения keep_thinking: true ​

Итоги урока ​

Анонс следующего урока ​

Приложение: Ссылки на исходный код ​

Полное руководство по параметрам конфигурации

Что вы научитесь делать

Ваша текущая проблема

Основная идея

Приоритет файлов конфигурации

Расположение файлов конфигурации

Категории параметров конфигурации

🎒 Подготовка перед началом

Пошаговая инструкция

Шаг 1: Создание файла конфигурации

Шаг 2: Настройка базовых параметров

Шаг 3: Проверка конфигурации

Подробное описание параметров конфигурации

Поведение моделей

keep_thinking

session_recovery

auto_resume

resume_text

web_search

Ротация аккаунтов

account_selection_strategy

switch_on_first_rate_limit

pid_offset_enabled

quota_fallback

Поведение приложения

quiet_mode

debug

log_dir

auto_update

Расширенные настройки

Восстановление после ошибок

Управление токенами

Кэш подписей (действует при `keep_thinking: true`)

Оценка состояния (используется стратегией `hybrid`)

Token Bucket (используется стратегией `hybrid`)

Рекомендуемые конфигурации

Конфигурация для одного аккаунта

Конфигурация для 2-3 аккаунтов

Конфигурация для нескольких аккаунтов + параллельных агентов

Типичные ошибки

❌ Ошибка: Изменения конфигурации не применяются

❌ Ошибка: Неверный формат JSON в файле конфигурации

❌ Ошибка: Переменные окружения не применяются

❌ Ошибка: Частые ошибки после включения `keep_thinking: true`

Итоги урока

Анонс следующего урока

Приложение: Ссылки на исходный код