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

> Узнайте, как подготовиться к отключению Gemini CLI 18 июня 2026 года и перенести конфигурацию, плагины, переменные окружения и рабочие сценарии в Antigravity CLI. В руководстве разобраны установка на macOS, Linux и Windows, авторизация, проверка и переход из России.

Source: https://ailoot.ai/blog/ru/gemini-cli-to-antigravity-cli-migration/
Canonical: https://ailoot.ai/blog/ru/gemini-cli-to-antigravity-cli-migration/
Language: ru
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-097
Revision: sha256-3a5d7c429da1cf80af0e9d3d2a071243f13be4f80428af34c413e0162fb31c79


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, — это руководство поможет перенести настройки и проверить работу за один вечер.

<div class="aside" data-semantic="ailoot-docs-link" role="note" aria-label="Документация Ailoot">

Сведения о подключении моделей и работе с API приведены в [документации Ailoot](https://ailoot.ai/docs/).

</div>

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

С 18 июня 2026 года Gemini CLI и расширение Gemini Code Assist для VS Code перестанут обрабатывать запросы для пользователей бесплатного тарифа, Google AI Pro и Google AI Ultra. Установка Gemini Code Assist на GitHub для новых пользователей станет недоступна, а уже подключённые экземпляры будут отключены в последующие недели. Платный API через Gemini Enterprise Agent Platform и корпоративные лицензии Code Assist Standard/Enterprise продолжат работать без изменений.

</div>

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

| Тариф | Сейчас | Изменения с 18 июня 2026 года |
|----|----|----|
| Бесплатный (free tier) | Gemini Code Assist и CLI с ограничениями | Доступ будет полностью отключён |
| Google AI Pro (около \$19.99/мес) | Повышенные лимиты CLI и Code Assist | Доступ будет полностью отключён |
| Google AI Ultra (от \$100/мес после I/O 2026) | Наибольшие лимиты | Доступ будет полностью отключён |
| Gemini Code Assist для GitHub | Автоматическая проверка PR в репозитории Google | Новые установки станут недоступны; имеющиеся отключат в последующие недели |
| Gemini Code Assist Standard / Enterprise (корпоративные лицензии) | Доступ через корпоративный аккаунт Google Workspace | Работа продолжится без изменений |
| Платный API через Google Cloud (paid Gemini API key) | Запросы оплачиваются из бюджета проекта | Работа продолжится без изменений |

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

<figure>
<blockquote>
<p>18 июня 2026 года Gemini CLI и расширения Gemini Code Assist для IDE перестанут обрабатывать запросы пользователей Google AI Pro, Ultra и бесплатного тарифа.</p>
</blockquote>
<figcaption>— Блог Google для разработчиков, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Gemini CLI был отдельным экспериментальным проектом Google на TypeScript/Node.js с открытым репозиторием на GitHub. Google решил объединить агентские инструменты на платформе Google Antigravity, которая включает четыре варианта: Antigravity 2.0 (настольное приложение), Antigravity CLI (терминал), Antigravity SDK (обёртка для Python) и Antigravity IDE (форк VS Code). CLI переписан с Node.js на Go. По заявлению Google, это ускоряет запуск с сотен миллисекунд до миллисекунд и снижает потребление памяти с сотен мегабайт до десятков.

</div>

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

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

<figure>
<blockquote>
<p>Antigravity CLI написан на Go, запускается быстрее и поддерживает асинхронные фоновые сценарии.</p>
</blockquote>
<figcaption>— Блог Google для разработчиков, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/</figcaption>
</figure>

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

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

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

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

<figure>
<blockquote>
<p>Репозиторий останется доступен на GitHub под лицензией Apache 2.0; мы продолжим развивать проект с открытым исходным кодом.</p>
</blockquote>
<figcaption>— Google, https://github.com/google-gemini/gemini-cli</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Установщик Google определяет операционную систему и архитектуру, загружает бинарный файл и размещает его в `~/.local/bin` на Linux и macOS либо в `C:\Users\[твоё_имя]\AppData\Local\agy\bin` на Windows. Для macOS и Linux предусмотрена команда с `curl`, для Windows — варианты PowerShell и CMD. Если установщик не добавил каталог в `PATH`, настройте путь вручную, перезапустите терминал и выполните `agy doctor`. Эта команда проверит, что бинарный файл доступен и соединение с Google устанавливается.

</div>

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

### macOS и Linux

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

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

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

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

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

```bash
which agy
agy --version
```

### Windows (PowerShell)

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

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

### Windows (CMD)

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

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

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

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

```bash
agy doctor
```

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

### Авторизация

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Antigravity CLI ищет настройки в `.agents/` в каталоге проекта и в `~/.agents/` для пользователя. Gemini CLI использовал аналогичную схему с `.gemini/`. Для переноса расширений выполните `agy plugin import gemini`: команда обработает содержимое `.gemini/extensions/`, добавит плагины Antigravity и преобразует конфигурацию. Навыки нужно переместить отдельно: `mv .gemini/skills/ .agents/skills/`. После переноса проверьте результат командами `agy doctor` и `agy inspect`: они помогут найти активные настройки и возможные дубликаты.

</div>

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

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 для общих настроек разных ИИ-инструментов](https://ailoot.ai/blog/ru/agents-md-guide-template/), его менять не нужно. Antigravity CLI, Claude Code и Codex читают `AGENTS.md` из каталога проекта.

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Проверьте CI/CD-скрипты, GitHub Actions, локальные файлы `.env` и dotfiles: если в них указаны `GEMINI_API_KEY` или другие переменные со старым префиксом, переименуйте их. В Antigravity вместо `GEMINI_` используется `AV_`. Новая версия CLI не читает прежние имена переменных.

</div>

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

| Переменная Gemini CLI | Переменная Antigravity CLI | Значение по умолчанию |
|----|----|----|
| `GEMINI_API_KEY` | `AV_API_KEY` | \- |
| `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- |
| `GEMINI_REGION` | `AV_REGION` | `us-central1` |
| `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` |
| `GEMINI_API_BASE` | `AV_API_BASE` | официальный endpoint Google |

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

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

```bash
# Найдите упоминания во всём проекте
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`:

```bash
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
```

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Чаще всего требуют проверки MCP-серверы, указанные в `~/.gemini/config.json`: автоматический импорт может их пропустить, поэтому конфигурацию нужно вручную привести к формату Antigravity. Хуки, использующие старые переменные окружения, могут перестать работать и приводить к непонятным ошибкам в тестах. Скрипты, обращающиеся непосредственно к `.gemini/`, следует перенастроить на `.agents/`. На ранних версиях Antigravity CLI загрузка файла в контекст командой `@[файл]` работала с ошибками; в более свежих сборках её исправили. Если у вас старая версия, обновите её.

</div>

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

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`, после перехода он перестанет находить переменную. Найдите такие обращения:

    ```bash
    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](https://antigravity.google), отдельный форк VS Code, или настроить `AGENTS.md` в другом ИИ-редакторе.

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Antigravity CLI запускается быстрее, работает с Gemini 3.5 Flash, поддерживает параллельных агентов и асинхронные фоновые задачи через `agy --background`. При этом стоит учитывать региональные ограничения доступа и то, что экосистема плагинов и MCP пока может быть менее зрелой, чем у Claude Code. Решение о переходе на основной инструмент зависит от ваших задач и доступности сервиса. CLI можно использовать для фоновых задач, а перед сменой основного инструмента — проверить его на реальных сценариях. Если вы выбирали Gemini CLI из-за бесплатного доступа, дата 18 июня — повод пересмотреть набор инструментов.

</div>

Antigravity 2.0 можно рассмотреть как дополнительный вариант, если основной инструмент, например Claude Code или Codex, не подходит для конкретной задачи. Подробнее о возможностях Antigravity 2.0 говорится в [руководстве по Google Antigravity 2.0](https://ailoot.ai/blog/ru/google-antigravity/).

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

| Если вы... | Что сделать к 18 июня |
|----|----|
| Использовали бесплатный Gemini CLI для экспериментов | Перейти на Antigravity CLI с аккаунтом, которому доступен сервис, либо выбрать Claude или Codex с учётом бюджета |
| Работали с Gemini Code Assist в IDE | Перейти на Antigravity IDE или использовать VS Code с Claude Code |
| Запускали ночные задачи cron через Gemini API на бесплатном тарифе | Перенести их на платный Cloud API, который продолжит работать, либо перейти на Claude API |
| Используете корпоративный Cloud (Standard/Enterprise) | Ничего менять не нужно: отключение вас не затрагивает |
| Только собирались попробовать Gemini CLI из-за бесплатного доступа | Не начинайте работу с ним; рассмотрите [Claude Code](https://ailoot.ai/blog/ru/claude-code/) или [Codex](https://ailoot.ai/blog/ru/codex-vs-claude-code-choice/) |

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Ключевой вывод">

Ключевой вывод

Если нужно быстро выполнить перенос, воспользуйтесь этим списком. В новом терминале, где не запущены скрипты Gemini, процесс обычно занимает 10–20 минут.

</div>

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 "что-то"` может вернуть ошибку авторизации.

<div class="section" role="doc-bibliography" aria-label="Официальные источники">

### Официальные источники

- [Блог Google для разработчиков — важное обновление о переходе с Gemini CLI на Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)
- [Antigravity CLI — руководство по началу работы](https://antigravity.google/docs/cli-getting-started)
- [Antigravity CLI — репозиторий Google на GitHub](https://github.com/google-antigravity/antigravity-cli)
- [Google — основные анонсы для разработчиков с Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)

</div>



<div class="aside" data-semantic="ailoot-link" role="note" aria-label="Ailoot">

Продолжить работу с ИИ можно в [Ailoot](https://ailoot.ai/).

</div>

## Вопросы и ответы

### Как проверить переименованную переменную ключа без раскрытия?

Проверьте непустое значение ${AV_API_KEY:-} и выведите только сообщение о наличии или отсутствии. Не печатайте ключ через echo и не включайте трассировку оболочки. Авторизацию отдельно проверьте через agy doctor.

### Доказывает ли успешный импорт конфигурации завершение миграции?

Нет. Сравните активные плагины, skills, hooks и субагентов с прежней конфигурацией, изучите MCP и выполните небольшую задачу. Сохраняйте .gemini/ до проверки нужного рабочего процесса и результата.


## Ailoot · Компания и портфель её проектов

Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI.

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.
