Как перейти с Gemini CLI на Antigravity CLI до 18 июня 2026 года

19 мая 2026 года Google сообщил, что 18 июня прекратит обработку запросов в Gemini CLI для пользователей бесплатного тарифа, Google AI Pro и Google AI Ultra. После этой даты команда gemini перестанет работать для этих подписчиков. Чтобы продолжить пользоваться инструментами Google, можно перейти на Antigravity CLI с командой agy. Утилита написана на Go и запускается заметно быстрее.

Если Gemini CLI задействован в ваших сценариях — например, в CI, ночных задачах cron или расширении Gemini Code Assist для IDE, — это руководство поможет перенести настройки и проверить работу за один вечер.

Каких пользователей Gemini CLI затрагивает изменение 18 июня 2026 года?#

Речь идёт не о полном закрытии проекта: изменения затронут три популярных тарифных варианта. Вот кого они коснутся:

В блоге Google для разработчиков указана дата изменения:

Если вы пользовались бесплатным тарифом и считали, что платный аккаунт защищает от отключения, уточните, какой именно способ оплаты используется для API. AI Pro — персональная подписка Google AI, и её затронут изменения. Платный проект с биллингом Google Cloud продолжит работать.

Почему Google прекращает работу Gemini CLI?#

Старому процессу gemini требовались сотни миллисекунд на запуск из-за подготовки Node.js. Новый agy поставляется как единый статический бинарный файл на Go и начинает работу за миллисекунды. Это может быть заметно в CI и скриптах, где CLI запускается сотни раз за один прогон.

Google описывает преимущества новой версии так:

Основные возможности Gemini CLI перенесены:

• Agent Skills — навыки из .gemini/skills/ теперь располагаются в .agents/skills/.
• Hooks — поддерживаются те же события (PreToolUse, PostToolUse и другие), а синтаксис изменился незначительно.
• Subagents — продолжают работать; их конфигурация переносится автоматически.
• Extensions — теперь называются Antigravity plugins и импортируются одной командой.

Некоторые настройки могут потребовать ручного переноса: в частности, MCP-серверы и скрипты, которые напрямую обращаются к .gemini/config.json. MCP-конфигурация может нарушиться, и её потребуется переписать вручную. Этому посвящён отдельный раздел ниже.

Репозиторий Gemini CLI останется открытым:

Таким образом, проект можно ответвить и продолжить использовать с собственным ключом Gemini API. Такой вариант требует платного биллинга Google Cloud; бесплатный доступ через Code Assist завершится.

Установка Antigravity CLI на macOS, Linux и Windows#

Перед установкой проверьте, какой у вас тариф. Если вы используете платный проект Google Cloud, на который дата 18 июня не влияет, переход можно выполнить без спешки. Если вы работаете на бесплатном тарифе, Pro или Ultra и запускаете Gemini CLI, начните перенос заранее. Пока оба варианта доступны, можно сравнить их на одной и той же задаче.

macOS и Linux

Установите CLI одной командой через curl:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Скрипт определит платформу, загрузит бинарный файл agy, проверит контрольную сумму и поместит его в ~/.local/bin. Если каталога нет в PATH, добавьте его:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Затем убедитесь, что команда доступна:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

Бинарный файл будет установлен в C:\Users\[твоё_имя]\AppData\Local\agy\bin. Установщик сам обновит PATH. Откройте новое окно PowerShell, чтобы загрузить обновлённые переменные окружения.

Windows (CMD)

Если корпоративные ограничения запрещают запуск PowerShell, используйте CMD:

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

Проверка установки

На любой из поддерживаемых операционных систем выполните:

agy doctor

Команда проверит версию бинарного файла, наличие конфигурации, авторизацию и доступ к сети antigravity.google. Если подключиться к Google не удаётся, проверьте региональную доступность и настройки прокси.

Авторизация

При первом запуске agy без аргументов откроется мастер настройки:

1. Выберите тему интерфейса.
2. Укажите способ авторизации: Google OAuth для персональных аккаунтов или API-ключ.
3. При необходимости сразу импортируйте конфигурацию из .gemini/.

При выборе OAuth откроется браузер и страница accounts.google.com. Подтвердите согласие на передачу данных, после чего CLI будет готов к работе.

Перенос конфигурации и плагинов из .gemini в .agents#

Выполните перенос по шагам:

1. agy plugin import gemini

   Команду можно запускать из любой папки. Чтобы перенести глобальные плагины из ~/.gemini/ в ~/.agents/, выполните её один раз. Для импорта плагинов проекта запустите команду в его каталоге.

2. mv .gemini/skills/ .agents/skills/

   Переместите каталог навыков вручную. Формат файлов внутри не меняется, поэтому переписывать Markdown не требуется.

3. agy inspect

   Команда покажет активные плагины, навыки, хуки и subagents. Сопоставьте результат с прежней конфигурацией Gemini CLI и проверьте, что ничего не пропущено.

4. agy config --edit

   Откройте конфигурацию в стандартном редакторе, указанном в $EDITOR. Если автоматический импорт не перенёс нужные параметры, добавьте их вручную.

5. agy doctor

   В завершение проверьте бинарный файл, авторизацию, плагины и сетевое соединение. Если все четыре проверки пройдены, перенос конфигурации завершён.

Сохраните каталог .gemini/ как резервную копию на месяц, чтобы при необходимости восстановить настройки. Когда Antigravity проработает у вас неделю и вы убедитесь, что всё перенесено, старый каталог можно удалить.

Если в проекте используется AGENTS.md для общих настроек разных ИИ-инструментов, его менять не нужно. Antigravity CLI, Claude Code и Codex читают AGENTS.md из каталога проекта.

Какие переменные окружения заменить#

Сопоставление старых и новых имён:

Если секреты используются в GitHub Actions, откройте Settings -> Secrets -> Actions и измените имена. Значения оставьте прежними: сам API-ключ Google при миграции не меняется.

Найдите все оставшиеся упоминания GEMINI_:

# Найдите упоминания во всём проекте
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# Проверьте dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

После замены перезапустите терминал и проверьте наличие ключа без печати секрета. Не включайте трассировку оболочки и не копируйте значения в журналы. Наличие переменной не доказывает авторизацию: отдельно изучите agy doctor:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor

Частые проблемы после перехода и способы их устранения#

Проверьте следующие возможные проблемы:

1. MCP-серверы. Если в .gemini/config.json были настройки mcp_servers, после agy plugin import gemini они могут не появиться автоматически. Запустите agy inspect и найдите раздел mcp. Если он пустой или содержит ошибки, откройте agy config --edit и перенесите параметры вручную. Формат конфигурации описан в официальной документации Antigravity в разделе о MCP.

2. Пользовательские хуки. Если bash-скрипт в .gemini/hooks/ считывал $GEMINI_API_KEY, после перехода он перестанет находить переменную. Найдите такие обращения:

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Затем замените имена переменных.

3. CI/CD. В GitHub Actions и GitLab CI замените команду gemini на agy. Поскольку имя бинарного файла в установщике может различаться, для запуска удобно использовать переменную $CLI_CMD.

4. Расширение IDE. Gemini Code Assist для VS Code отключится вместе с CLI. В качестве замены можно использовать Antigravity IDE, отдельный форк VS Code, или настроить AGENTS.md в другом ИИ-редакторе.

5. Загрузка файла через @[файл]. В ранних сборках Antigravity CLI команда @src/file.ts для добавления файла в контекст могла работать некорректно. Обновите утилиту командой agy update.

Если критичный сценарий не удаётся восстановить за час, временно продолжайте пользоваться Gemini CLI до 18 июня, а переход проверяйте в отдельной ветке репозитория. На миграцию отведите не более 14 дней.

Стоит ли продолжать пользоваться инструментами Google после 18 июня?#

Antigravity 2.0 можно рассмотреть как дополнительный вариант, если основной инструмент, например Claude Code или Codex, не подходит для конкретной задачи. Подробнее о возможностях Antigravity 2.0 говорится в руководстве по Google Antigravity 2.0.

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

Краткий план миграции на 15 минут#

1. Установите Antigravity CLI

   На macOS или Linux выполните curl -fsSL https://antigravity.google/cli/install.sh | bash. В Windows PowerShell используйте irm https://antigravity.google/cli/install.ps1 | iex.

2. Запустите agy и войдите в аккаунт

   Запустите agy без аргументов и выберите OAuth или API-ключ.

3. Импортируйте плагины из .gemini

   Выполните agy plugin import gemini, чтобы перенести глобальные расширения. Для импорта плагинов проекта повторите команду из его каталога.

4. Переместите навыки

   Выполните mv .gemini/skills/ .agents/skills/. Сами файлы менять не нужно.

5. Замените переменные окружения

   В ~/.zshrc, ~/.bashrc и файлах .env замените GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID и GEMINI_REGION → AV_REGION. Затем перезапустите терминал.

6. Проверьте установку

   Выполните agy doctor. Все четыре пункта — бинарный файл, авторизация, плагины и сеть — должны пройти проверку.

7. Запустите CLI на тестовой задаче

   Введите agy "напиши README для проекта в текущей папке" и сравните результат с тем, что выдавал Gemini CLI.

8. Обновите GitHub Actions и GitLab CI

   Замените команду и имена секретов с GEMINI_* на AV_*.

9. Сохраните .gemini/ как резервную копию

   Удалите каталог через 1–2 недели, когда убедитесь, что новая конфигурация работает.

Дата 18 июня не означает, что перестанут работать все ваши проекты. Отключается бесплатный канал для определённых пользователей; платный Cloud API и репозиторий Gemini CLI останутся доступны, а проект можно будет ответвить. Если вы используете бесплатный тариф, примите решение о переходе до этой даты: после неё команда gemini "что-то" может вернуть ошибку авторизации.