Пригласите друга и получите 1 месяц Pro бесплатноКак это работает

Antigravity CLI: практическое руководство по agy от Google

Antigravity CLI: установка agy, вход, AGENTS.md, выбор модели и effort, режимы и права, MCP-серверы и переход с Gemini CLI — что переносится, а что нет.

Solviera Teknoloji 8 мин чтения

Antigravity CLI — агент Google для программирования в терминале. Вы ставите его одним скриптом, запускаете командой agy в папке проекта, входите через аккаунт Google и описываете задачу. Агент читает файлы, предлагает правки и команды, а в режиме по умолчанию спрашивает разрешения, прежде чем что-то менять.

Если вы пользовались Gemini CLI с личного аккаунта, то оказались именно здесь. Google объявила в блоге для разработчиков 19 мая 2026 года, что с 18 июня 2026 года Gemini CLI перестаёт обслуживать подписчиков Google AI Pro и Ultra и бесплатных пользователей Gemini Code Assist для частных лиц. В руководстве — установка, вход, инструкции проекта, модели и effort, режимы и права, MCP, главные команды, переход с Gemini CLI и лимиты, которые называет Google. Всё основано на документации Antigravity по состоянию на ноябрь 2026 года.

Что такое Antigravity CLI и кому он нужен

Antigravity CLI — терминальный клиент Google Antigravity, платформы разработки Google, построенной вокруг агентов. По словам Google, он написан на Go и использует тот же движок агента, что и десктопное приложение Antigravity 2.0, так что улучшения агента приходят в оба. Знакомые по Gemini CLI элементы остались: agent skills, хуки, субагенты и расширения, которые теперь называются плагинами.

Он для вас, если вы:

  • пользовались Gemini CLI с личным аккаунтом Google, Google AI Pro или Ultra;
  • хотите агента для программирования в терминале на моделях Gemini (а в зависимости от тарифа — и на других);
  • уже работаете в Antigravity на десктопе и хотите того же агента по SSH или в скриптах.

Команды с лицензией Gemini Code Assist Standard или Enterprise либо с платным ключом API могут остаться на Gemini CLI — об этом наше руководство по Gemini CLI. Google не скрывает разницу: в анонсе прямо сказано, что полного совпадения функций 1:1 на старте не будет.

Установка

СистемаКоманда
macOS, Linuxcurl -fsSL https://antigravity.google/cli/install.sh | bash
Windows (PowerShell)irm https://antigravity.google/cli/install.ps1 | iex
Windows (CMD)curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

На macOS и Linux бинарник окажется в ~/.local/bin/agy, на Windows — в AppData\Local\agy\bin. Проверьте:

agy --version

Вход

Перейдите в проект и запустите:

cd my-project
agy

При первом запуске agy спросит цветовую схему, режим отображения (Alt-Screen или Inline) и доверяете ли вы папке. Затем откроется браузер для входа через аккаунт Google. Работают личные аккаунты на тарифах Free, Pro и Ultra; рабочие аккаунты входят через Gemini Enterprise. Токен хранится в системном хранилище ключей (Keychain, Secret Service или диспетчер учётных данных Windows), поэтому при следующих запусках браузер не нужен.

Другие варианты:

  • По SSH: agy выведет ссылку. Откройте её на своём компьютере, войдите и вставьте код в терминал.
  • Ключ Gemini API: укажите "modelProvider": "gemini" в ~/.gemini/antigravity-cli/settings.json и задайте GEMINI_API_KEY. Без этой настройки ключ сам по себе ничего не делает.
  • Учётные данные Google Cloud: выполните gcloud auth application-default login и задайте AGY_ADC_AUTH=true.

/logout удаляет сохранённый вход.

Первая задача

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

Несколько сокращений пригодятся сразу: @ подсказывает пути к файлам, ! в начале запроса запускает команду оболочки, ? показывает справку и slash-команды. Для скриптов agy -p "кратко опиши README.md" выполняет один запрос без интерфейса и печатает ответ; добавьте --output-format json, если результат читает другая программа. agy -i "запрос" открывает интерактивный интерфейс сразу с первым запросом.

Инструкции проекта: AGENTS.md или GEMINI.md

Antigravity читает AGENTS.md или GEMINI.md в папке, где вы запускаете agy, и в родительских папках до корня репозитория. Оба файла всегда активны и не требуют frontmatter. Глобальные правила кладут в ~/.gemini/AGENTS.md или ~/.gemini/GEMINI.md. Правила складываются, а не заменяют друг друга.

# Проект: billing-service

## Команды
- Установка: npm ci
- Тесты: npm test (запускать, прежде чем сказать, что задача готова)

## Нельзя
- Не править файлы в src/generated.

Для тонкой настройки положите Markdown-файлы в .agents/rules/. Каждому нужен frontmatter с полем trigger: always_on, model_decision, glob (срабатывает, когда агент трогает подходящие файлы) или manual. Без корректного trigger правило молча отбрасывается, а правила manual в CLI не работают: упоминаний правил там нет. Держите файлы короткими: каждый обрезается после 24 000 байт, а глобальные правила и правила always_on делят общий бюджет в 20 000 токенов.

Если Codex или другой агент уже читает ваш AGENTS.md, Antigravity возьмёт тот же файл. Как держать один набор правил вместе с Claude Code, рассказано в статье CLAUDE.md и AGENTS.md.

Модели и effort

Модель на один запуск задаётся через --model (список выдаёт agy models), в сессии — через /model. На странице моделей Google рядом с моделями Gemini, например Gemini 3.8 Flash и Gemini 3.1 Pro, перечислены модели Claude и GPT-OSS; какие из них доступны, зависит от тарифа.

Effort определяет, насколько глубоко модель рассуждает. /effort открывает шкалу и сохраняет выбор как значение по умолчанию; --effort low действует только на один запуск. Уровни — low, medium, high, xhigh и max, но большинство моделей предлагает только от low до high, а модели с фиксированным бюджетом этот параметр игнорируют.

Режимы и права

РежимЧто происходит
defaultПоказывает diff перед созданием или изменением файлов и спрашивает перед командами терминала
accept-editsОдобряет правки внутри workspace, но перед командами по-прежнему спрашивает
autoОдобряет правки и выполняет команды в песочнице терминала; рискованные действия всё равно требуют подтверждения
planАнализирует и расписывает шаги до написания кода

Запускайте с --mode=accept-edits (или auto, plan), переключайтесь через Shift+Tab или задайте "agentMode" в ~/.gemini/antigravity-cli/settings.json. Для auto нужны песочница и личный аккаунт (v1.3.5+ на macOS и Linux, v1.4.4+ на Windows); у рабочих аккаунтов этого режима нет. --sandbox запускает сессию в песочнице терминала.

Точные правила хранятся в том же файле списками allow, ask и deny, например command(git) или mcp(sql/execute_mutation). Deny важнее ask, ask важнее allow. /permissions редактирует их в интерфейсе. --dangerously-skip-permissions одобряет всё подряд — используйте его только в одноразовой среде. Почему — в статье о безопасности ИИ-агентов для кода.

MCP-серверы

MCP-серверы живут в отдельном файле: ~/.gemini/config/mcp_config.json для всех проектов и .agents/mcp_config.json для одного workspace.

{
  "mcpServers": {
    "local-db": { "command": "node", "args": ["/path/to/server.js"] },
    "docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
  }
}

Удалённые серверы должны работать по Streamable HTTP; старый транспорт HTTP+SSE и поле httpUrl не поддерживаются. /mcp открывает менеджер со статусом, перезагрузкой и логами. Инструменты, которые вы не разрешили, работают в режиме Ask.

Команды, которые стоит знать

КомандаЧто делает
/model, /effortМеняет модель и глубину рассуждений
/permissionsУправляет правилами allow, ask и deny
/config или /settingsОткрывает настройки
/mcpМенеджер MCP-серверов
/planИзучает код, задаёт вопросы, пишет план для проверки
/resumeВыбирает прошлый разговор из этой папки
/rewind, /undoОткатывает разговор назад
/fork, /clearОтветвляет разговор или начинает заново
/usage, /creditsКвоты моделей и AI-кредиты
/pluginУстанавливает, включает или показывает плагины

Из оболочки agy -c продолжает последний разговор в папке, а --conversation <id> открывает конкретный. --add-dir добавляет в workspace ещё одну папку.

Переход с Gemini CLI

При первом запуске agy на машине с настройками Gemini CLI появляется список: что перенести — расширения, глобальные настройки, токены сессии и параметры отображения. Что переносится, а что нет, по руководству по миграции от Google:

  • Без изменений: GEMINI.md и AGENTS.md в проекте, ~/.gemini/GEMINI.md и глобальные skills в ~/.gemini/skills/.
  • Конвертируется: расширения становятся плагинами через agy plugin import gemini, а их команды — skills.
  • Вручную: skills из workspace переносятся из .gemini/skills/ в .agents/skills/; MCP-серверы — из ~/.gemini/settings.json в mcp_config.json, а url или httpUrl переименовываются в serverUrl.
  • Без гарантий: часть пользовательских тем и визуальных надстроек.
  • Флаги: --approval-mode больше нет, вместо него --mode. Режима yolo нет.

Лимиты и цены

Страница тарифов Google включает CLI во все тарифы и описывает квоты без цифр: у Ultra самая большая квота, обновляется каждые пять часов; у Pro — большая квота, обновляется каждые пять часов до недельного лимита; у остальных тарифов квота обновляется раз в неделю. Лимиты зависят от объёма работы агента. На Pro и Ultra после исчерпания квоты могут расходоваться AI-кредиты по ценам потребления Gemini Enterprise, и это можно отключить в настройках. /usage и /credits показывают текущее состояние.

Рядом с Claude Code и Codex

Antigravity часто лишь один из нескольких агентов. Несколько привычек помогают не запутаться:

  • Один общий файл правил. Antigravity и Codex читают AGENTS.md; Claude Code читает CLAUDE.md, который может на него ссылаться.
  • Отдельный worktree на агента. Дайте каждому агенту свой git worktree, чтобы они не правили одни и те же файлы.
  • Одни и те же MCP-серверы везде. У каждого инструмента свой конфиг, так что один сервер приходится добавлять трижды.

Мы делаем AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Antigravity CLI рядом с Claude Code, Codex, Gemini CLI и другими агентами, каждого в настоящем терминале с вашей установкой и вашим входом. Что касается Antigravity (подробнее):

  • Рабочее пространство: Antigravity — одна ячейка в сетке агентов проекта; после перезапуска приложения он возвращается к своему разговору.
  • Права: для каждого агента — Спрашивать, Авто (--mode=accept-edits) или Полный доступ (--dangerously-skip-permissions).
  • Модель и effort: при создании агента выберите модель и effort low, medium или high.
  • Инструкции: у agy нет флага для дополнительных инструкций, поэтому правила держите в AGENTS.md или GEMINI.md.
  • MCP-менеджер: серверы, настроенные один раз, добавляются в Antigravity при запуске рядом с вашим mcp_config.json.
  • Worktrees: создайте worktree в Git-панели и запустите в нём Antigravity, а Claude Code — в другом.

Сетка, worktrees, код-ревью и MCP-менеджер доступны на бесплатном тарифе. Как агенты Google соотносятся с агентами Anthropic, читайте в статье Gemini CLI или Claude Code — или скачайте AgentVera.

Итого

Установите скриптом, запустите agy, войдите через Google и оставьте свой AGENTS.md или GEMINI.md. Перенесите MCP-серверы в mcp_config.json, импортируйте расширения через agy plugin import gemini, начните в режиме default или accept-edits и перед долгими сессиями проверяйте /usage.

Вопросы

Antigravity CLI бесплатный?

Войти можно с личным аккаунтом Google на тарифе Free, Pro или Ultra. По странице тарифов Google, у остальных тарифов квота обновляется раз в неделю, у Pro и Ultra она больше и обновляется каждые пять часов. Точных цифр Google не публикует.

Antigravity CLI читает мой GEMINI.md?

Да. Он читает AGENTS.md и GEMINI.md в папке, где вы запускаете agy, и в родительских папках до корня репозитория, а также глобальные файлы вроде ~/.gemini/GEMINI.md. При переходе с Gemini CLI ничего менять не нужно.

Где настраиваются MCP-серверы в Antigravity CLI?

В отдельном mcp_config.json: ~/.gemini/config/mcp_config.json для всех проектов или .agents/mcp_config.json для одного workspace. Удалённые серверы задаются через serverUrl и должны работать по Streamable HTTP.

Что заменило --approval-mode и yolo?

Флаг --mode со значениями default, accept-edits, auto и plan. Shift+Tab переключает режимы в сессии. Чтобы пропускать все подтверждения, есть --dangerously-skip-permissions — только для изолированной среды.

Можно остаться на Gemini CLI?

Да, если у вас лицензия Gemini Code Assist Standard или Enterprise либо платный ключ Gemini API. Пользователей Google AI Pro, Ultra и бесплатных индивидуальных пользователей перевели на Antigravity CLI 18 июня 2026 года.

Соберите своих агентов за одним столом.

Скачайте AgentVera бесплатно; ваши установленные CLI уже готовы к работе.

Другие статьи