Google Antigravity CLI: что это, как установить, пользоваться и исправить ошибки

Что такое Google Antigravity CLI

Google Antigravity CLI — это терминальный интерфейс для работы с AI-агентами Google Antigravity. Через него разработчик может запускать агентные задачи прямо из командной строки: анализировать проект, редактировать код, запускать команды, работать с файлами, подключать инструменты и управлять несколькими агентами.

Google описывает Antigravity как agent-first development platform, а Antigravity CLI — как новый терминальный опыт внутри этой платформы. Google также объявил переход от Gemini CLI к Antigravity CLI, объясняя это тем, что современные задачи разработки требуют нескольких агентов, общего backend и сложных фоновых сценариев.

Antigravity CLI подходит, если вы хотите:

• работать с кодом через естественный язык;
• запускать AI-агента из терминала;
• просить агента объяснить проект или отдельный файл;
• генерировать функции, тесты и рефакторинг;
• управлять subagents и фоновыми задачами;
• использовать MCP, hooks, skills и plugins;
• заменить или дополнить Gemini CLI.

Что такое CLI простыми словами

CLI — это Command Line Interface, командный интерфейс. Способ управлять программой через текстовые команды в терминале, а не через кнопки и окна.

Пример обычного CLI:

git status
npm install
python script.py

Пример AI CLI — вы запускаете агента одной командой:

agy

После запуска пишете задачу обычным языком:

Найди причину ошибки в проекте и предложи минимальный фикс.

Главное отличие CLI от обычного приложения — работа внутри терминала, который уже связан с проектом, Git, npm, Python, Docker, тестами и локальными файлами. В контексте Antigravity CLI слово CLI означает не просто «командную строку», а терминальную среду для управления AI-агентом.

Gemini CLI и Antigravity CLI: в чём разница

Gemini CLI — open-source AI-агент, который давал доступ к Gemini прямо из терминала с циклом Reason and Act, встроенными инструментами и MCP-серверами.

Antigravity CLI — новый CLI-инструмент Google для agent-first платформы Antigravity. Закрывает более сложные сценарии: multi-agent workflow, фоновые задачи, subagents, hooks, skills и plugins.

Важно: Google сообщил, что 18 июня 2026 года Gemini CLI перестанет обслуживать запросы для Google AI Pro, Ultra и бесплатных индивидуальных пользователей. Для Standard и Enterprise клиентов доступ к Gemini CLI сохраняется.

Как установить Antigravity CLI

Перед установкой проверьте официальный раздел загрузки Google Antigravity — команды установки могут меняться.

Linux / Ubuntu

sudo apt update
sudo apt install antigravity

После установки проверьте:

agy --version

macOS

Установите через официальный установщик с сайта Google Antigravity, затем проверьте:

which agy
agy --version

Если команда не найдена — проверьте, добавлен ли каталог установки в переменную PATH.

Windows

Используйте официальный installer. После установки откройте новый терминал PowerShell или Windows Terminal:

agy --version

Если agy не найден — путь к CLI не добавился в системный PATH или терминал был открыт до завершения установки.

Обновление CLI

agy update

Как запустить Antigravity CLI

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

agy

При первом запуске CLI может попросить авторизоваться. CLI пытается использовать secure keyring ОС, а если сохранённой сессии нет — переходит к browser-based authentication.

Базовый сценарий запуска

1. Открыть терминал.
2. Перейти в папку проекта.
3. Выполнить agy.
4. Пройти авторизацию через Google Account или Google Cloud.
5. Выбрать настройки первого запуска.
6. Написать первую задачу агенту.

Примеры первых запросов

Проанализируй структуру проекта и объясни, из каких частей он состоит.

Найди, почему падают тесты, и предложи минимальный безопасный фикс.

Команды Antigravity CLI

Antigravity CLI — не только строка для промпта. Внутри есть slash-команды, настройки, агенты и инструменты.

Основные команды

Slash-команды внутри CLI

Что можно просить у агента

Объясни, что делает файл src/api/client.ts.
Найди потенциальные ошибки в авторизации.
Сгенерируй unit-тесты для функции calculatePrice.
Сделай refactor этого модуля, но сначала покажи план изменений.
Проверь README и обнови инструкции запуска проекта.
Найди все места, где используется deprecated API.

Как пользоваться Antigravity CLI на практике

1. Быстро понять чужой проект

Объясни архитектуру проекта: основные папки, точки входа, зависимости и как запустить локально.

2. Найти баг

В проекте падает авторизация. Изучи код, найди вероятную причину и предложи фикс без больших изменений.

Лучше просить агента сначала показать план:

Сначала покажи план диагностики, не меняй файлы без подтверждения.

3. Написать функцию

Добавь функцию экспорта заказов в CSV. Сначала найди подходящее место в проекте, затем предложи план.

4. Сгенерировать тесты

Найди непокрытые тестами функции в модуле billing и предложи unit-тесты.

5. Code review

Проведи code review текущих изменений в Git. Найди баги, риски безопасности и проблемы производительности.

6. Работать с несколькими агентами

Antigravity CLI ориентирован на multi-agent workflow. Пример запроса:

Раздели задачу на несколько подзадач: анализ backend, анализ frontend, тесты и документация.

Ошибки Antigravity CLI и способы исправления

Что делать в первую очередь

agy update

Проверить команду:

agy --version

Если agy не найден (Linux/macOS):

which agy
echo $PATH

На Windows:

where agy

Универсальный чеклист

• Обновить Antigravity CLI: agy update.
• Перезапустить терминал.
• Проверить авторизацию и аккаунт.
• Проверить доступ к папке проекта.
• Уменьшить размер задачи.
• Повторить с более точным промптом.
• Проверить лимиты и тариф аккаунта.
• Посмотреть официальный changelog и known issues.

Лимиты, quota, Pro, Ultra и бесплатный доступ

Если вы видите antigravity quota, antigravity 429 или похожие ошибки — проблема чаще всего в лимитах использования.

Перед покупкой подписки проверьте: поддерживается ли Antigravity в вашем регионе, какой аккаунт используется в CLI, нет ли ограничений Google Cloud project.

Не стоит покупать «готовые аккаунты для Antigravity» у третьих лиц — риск блокировки, потери доступа и утечки данных проекта.

Работает ли Google Antigravity CLI в России

Доступность зависит от Google-сервисов, аккаунта, региона, сети и тарифов. Если сайт не открывается, авторизация зависает или появляется quota/error — это не всегда означает «сервис заблокирован».

Корректный подход

• проверить официальную доступность сервиса;
• использовать только свой Google Account;
• не вводить данные на неофициальных сайтах;
• не устанавливать patcher, unlocker и сомнительные сборки;
• проверять статус сети, billing и настройки аккаунта;
• читать официальную документацию и changelog.

Возможные обычные причины проблем: лимиты, сбой версии, проблема keyring, неправильный аккаунт, WSL-окружение, конфликт PATH или временный backend-сбой.

Antigravity CLI и Google Cloud CLI — не одно и то же

Google Antigravity CLI, Gemini CLI, Google Cloud CLI и Google Workspace CLI — разные инструменты с разными задачами.

Если вы ищете google cloud cli — вам нужен gcloud, а не Antigravity CLI. Если ищете google gemini cli — важно учитывать переход на Antigravity CLI для индивидуальных пользователей.

Аналоги Antigravity CLI

Antigravity CLI конкурирует не с обычными CLI-утилитами, а с AI coding agents и agentic development tools.

Если нужен именно Google-стек — логичный выбор Antigravity CLI. Если важна независимость от одного вендора — стоит сравнивать с Claude Code, Codex CLI и Qwen Code CLI.

FAQ по Google Antigravity CLI

Что такое Google Antigravity CLI?

Google Antigravity CLI — терминальный интерфейс для работы с AI-агентами Google Antigravity. Позволяет запускать агентные задачи, работать с кодом, файлами, командами и subagents прямо из терминала.

Чем Antigravity CLI отличается от Gemini CLI?

Gemini CLI был open-source AI-агентом для доступа к Gemini из терминала. Antigravity CLI — новый CLI для agent-first платформы Antigravity, рассчитанный на multi-agent workflow, фоновые задачи, plugins, hooks и subagents.

Как запустить Antigravity CLI?

После установки откройте терминал в папке проекта и выполните agy. При первом запуске CLI может попросить авторизоваться через Google Account или Google Cloud.

Что делать, если команда agy не найдена?

Проверьте, установлен ли CLI и добавлен ли путь к бинарному файлу в PATH. Перезапустите терминал. На Linux/macOS: which agy, на Windows: where agy.

Что значит ошибка antigravity 429?

Обычно превышение лимита запросов или rate limit. Проверьте quota, тариф, аккаунт и повторите запрос позже.

Почему появляется agent terminated due to error?

Причина может быть в лимитах, сбое инструмента, проблемах с доступом к файлам, большой задаче или временной проблеме backend. Начните с agy update и уменьшения задачи.

Можно ли пользоваться Antigravity CLI бесплатно?

Доступность и лимиты зависят от аккаунта и текущих правил Google. Pro и Ultra дают более высокие лимиты. Конкретные условия стоит проверять в официальной документации Google Antigravity.

Antigravity CLI — это Google Cloud CLI?

Нет. Google Cloud CLI (gcloud) нужен для управления Google Cloud. Antigravity CLI (agy) нужен для работы с AI-агентами Antigravity.

Работает ли Antigravity CLI в России?

Зависит от доступности Google-сервисов, аккаунта, региона и тарифов. Лучше проверять официальные страницы Google Antigravity и не использовать неофициальные сборки или чужие аккаунты.