Миграция с Gemini CLI на Antigravity CLI до 18 июня 2026: пошаговая инструкция

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

Если у тебя что-то крутится на Gemini CLI - скрипты на CI, ночные крон-задачи, IDE-расширение Gemini Code Assist - этот гайд про то, как переехать за один вечер и ничего не сломать. С отдельным разделом про то, что делать из России: тут у Google свои нюансы.

Каждый день в Telegram-канале - что нового в вайб-кодинге: инструменты, разборы, ошибки. Подпишись, чтобы быть в курсе.

Что именно перестанет работать с 18 июня 2026?

Это не «полное закрытие проекта», а отрезание трёх самых популярных тарифов. Кого касается:

Из официального блога Google для разработчиков:

Если ты сидел на бесплатном тарифе, как большинство индивидуальных разработчиков, и думаешь «у меня же платный аккаунт» - проверь, через что именно идёт API-ключ. AI Pro - это не Cloud-биллинг, это персональная подписка Google AI, она отключится. 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 руками. По обсуждению на GitHub - часть пользователей сообщает, что MCP-конфиги ломаются и их нужно переписывать вручную. Об этом отдельный раздел ниже.

Открытый код Gemini CLI Google не закрывает:

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

Как установить Antigravity CLI: команды для macOS, Linux, Windows

Перед запуском - короткая самопроверка: ты на каком тарифе? Если на платном Cloud-проекте, у которого нет крайнего срока 18 июня, миграция полезна, но не срочная. Если на бесплатном/Pro/Ultra и у тебя что-то крутится на CLI - переходи сейчас, пока тарифы ещё активны и можно сравнить поведение на одной и той же задаче.

macOS и Linux

Однострочник через 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 у тебя закрыт корпоративной политикой:

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/. Workspace-плагины (рядом с проектом) - запускай команду внутри папки проекта.

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 читает AGENTS.md из той же папки, что и Claude Code или Codex.

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

Полная таблица замен:

Если есть 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

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

echo $AV_API_KEY  # должно вернуть ключ
agy doctor        # должно показать «authorized»

Что делать пользователям Gemini CLI из России?

Конкретные блокеры:

1. Регион аккаунта. Если в Google-аккаунте основной телефон или восстановление - российский номер, API будет возвращать «not available in your region» вне зависимости от того, через какой IP ты идёшь. Это серверная проверка.
2. Биллинг. Чтобы перейти на платный Cloud-API (тот, который НЕ отключается 18 июня), нужна валидная карта НЕ российского банка. Mastercard/Visa, выпущенные в РФ, Google не принимает.
3. VPN не помогает. В отличие от ChatGPT, где VPN решает 90% случаев, Google проверяет регион через несколько каналов: IP, аккаунт, телефон, карта. Достаточно одного «российского» сигнала.

Что реально работает:

• Зарубежный Google-аккаунт. Зарегистрировать новый Google-аккаунт с зарубежным номером (Казахстан, Сербия, Турция, Армения - SIM-карта, не e-SIM), привязать зарубежную карту, через этот аккаунт получить API-ключ. С таким ключом Antigravity CLI работает из РФ через VPN.
• Корпоративный Cloud-проект. Если есть юрлицо в Армении/Казахстане/Сербии - заводишь Google Cloud-проект на него, получаешь Cloud API-ключ. Он попадёт под платный тариф и НЕ отключится 18 июня.
• Уход с Google-инструментов. Самый прагматичный вариант для большинства. Если у тебя нет зарубежного аккаунта и заводить его дорого/долго - переходи на Claude Code из России (там подробно про обход) или на Codex от OpenAI. У обоих доступ из РФ проще, чем у Google.

Я держу Antigravity CLI как запасной канал для фоновых задач (через зарубежный аккаунт), но основная работа всё равно в Claude Code. Подробнее про эту связку - в разборе Google Antigravity и Claude Code.

Что чаще всего ломается при переходе и как чинить

Чек-лист первых проблем:

1. MCP-серверы. Если ты использовал mcp_servers в .gemini/config.json - после agy plugin import gemini они могут не подхватиться. Проверь через agy inspect - там будет раздел mcp. Если пусто или с ошибками - перепиши вручную через agy config --edit. Формат описан в официальной документации Antigravity (ищи раздел про MCP).
2. Свои хуки. Если в .gemini/hooks/ лежал bash-скрипт, который читал $GEMINI_API_KEY - он сломается. Найди такие места:
   bash

   Скопировать

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

   Замени переменные.
3. CI/CD. В GitHub Actions или GitLab CI шаги, использующие gemini команду, нужно поменять на agy. Имя бинаря в установщике может отличаться, поэтому сделай абстракцию через переменную $CLI_CMD.
4. IDE Extension. Расширение Gemini Code Assist для VS Code отключается вместе с CLI. Замена - Antigravity IDE (отдельный VS Code-fork) или AGENTS.md в любом другом ИИ-редакторе.
5. @[файл] загрузка. На ранних сборках Antigravity CLI команда @src/file.ts для подгрузки файла в контекст работала с багами. Обнови до последней версии: agy update.

Если что-то критичное ломается и не лечится за час - временное решение для бесплатного тарифа: оставайся на Gemini CLI до 18 июня, параллельно поднимай миграцию на отдельной ветке репозитория. Лимит времени - 14 дней.

Стоит ли вообще оставаться на Google-инструментах после 18 июня?

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

Короткая декомпозиция, что делать в зависимости от ситуации:

Универсальный совет: если ты ещё не пробовал нашу связку «ИИ-клон + Второй мозг + Контекст-инжиниринг» и думаешь, в чём вообще разница между Claude Code и Antigravity - это именно та задача, под которую сделан практикум. За один вечер получаешь рабочую связку и понимаешь, какой инструмент под какой класс задач брать.

Чек-лист миграции за 15 минут

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

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) или irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Запусти agy и авторизуйся

   Без аргументов: agy. Выбери OAuth или API-ключ.

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

   agy plugin import gemini - перенесёт extensions глобально. Запусти ещё раз внутри папки проекта для workspace-плагинов.

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

   mv .gemini/skills/ .agents/skills/. Содержимое файлов остаётся как есть.

5. Замени env-переменные

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

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

   agy doctor - все четыре пункта (бинарь, авторизация, плагины, сеть) должны быть в зелёном.

7. Прогон на тестовой задаче

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

8. Поправь GitHub Actions / GitLab CI

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

9. Оставь .gemini/ как бэкап

   Удалить можно через 1-2 недели после того, как убедишься, что всё работает.

И последнее: 18 июня - это не «все твои проекты лягут». Это отключение бесплатного канала. Платный Cloud-API остаётся, репозиторий Gemini CLI остаётся, форки возможны. Если ты сидел на бесплатном тарифе - решение нужно принять до 18 июня, иначе следующее gemini "что-то" вернёт ошибку авторизации.

Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира, 2 000 ₽. Записи остаются у тебя.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 17–19 ноября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email