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

URL: https://agentvera.dev/ru/blog/how-to-use-antigravity-cli/ · Опубликовано: 2026-11-05

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

**Коротко:**

- Antigravity CLI (agy) — терминальный агент Google, который 18 июня 2026 года заменил Gemini CLI для Google AI Pro, Ultra и бесплатных индивидуальных пользователей.
- Ставится одним скриптом, запускается командой agy в проекте, вход — через аккаунт Google; правила проекта остаются в AGENTS.md или GEMINI.md, их он читает как есть.
- MCP-серверы переезжают из settings.json в mcp_config.json, расширения превращаются в плагины через agy plugin import gemini, а --mode заменяет --approval-mode.

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

Если вы пользовались Gemini CLI с личного аккаунта, то оказались именно здесь. Google объявила в [блоге для разработчиков 19 мая 2026 года](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ "Переход с Gemini CLI на Antigravity CLI"), что с **18 июня 2026 года** Gemini CLI перестаёт обслуживать подписчиков Google AI Pro и Ultra и бесплатных пользователей Gemini Code Assist для частных лиц. В руководстве — установка, вход, инструкции проекта, модели и effort, режимы и права, MCP, главные команды, переход с Gemini CLI и лимиты, которые называет Google. Всё основано на [документации Antigravity](https://antigravity.google/docs/getting-started?tab=cli "Быстрый старт 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;
- хотите [агента для программирования](/ru/glossary/coding-agent/ "Что такое агент для программирования") в терминале на моделях Gemini (а в зависимости от тарифа — и на других);
- уже работаете в Antigravity на десктопе и хотите того же агента по SSH или в скриптах.

Команды с лицензией Gemini Code Assist Standard или Enterprise либо с платным ключом API могут остаться на Gemini CLI — об этом наше [руководство по Gemini CLI](/ru/blog/how-to-use-gemini-cli/ "Как пользоваться Gemini CLI"). Google не скрывает разницу: в анонсе прямо сказано, что полного совпадения функций 1:1 на старте не будет.

## Установка

| Система | Команда |
| --- | --- |
| macOS, Linux | `curl -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`. Проверьте:

```bash
agy --version
```

## Вход

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

```bash
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` удаляет сохранённый вход.

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

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

Несколько сокращений пригодятся сразу: `@` подсказывает пути к файлам, `!` в начале запроса запускает команду оболочки, `?` показывает справку и 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`. Правила складываются, а не заменяют друг друга.

```markdown
# Проект: 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](/ru/blog/claude-md-agents-md/ "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` одобряет всё подряд — используйте его только в одноразовой среде. Почему — в статье о [безопасности ИИ-агентов для кода](/ru/blog/ai-coding-agent-security/ "Безопасность ИИ-агентов").

## MCP-серверы

[MCP](/ru/glossary/mcp/ "Что такое MCP")-серверы живут в отдельном файле: `~/.gemini/config/mcp_config.json` для всех проектов и `.agents/mcp_config.json` для одного workspace.

```json
{
  "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 появляется список: что перенести — расширения, глобальные настройки, токены сессии и параметры отображения. Что переносится, а что нет, по [руководству по миграции](https://antigravity.google/docs/cli/gcli-migration "Миграция с 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 нет.

## Лимиты и цены

[Страница тарифов](https://antigravity.google/docs/plans "Тарифы Antigravity") 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](/ru/blog/git-worktree-parallel-agents/ "Git worktree для параллельных агентов"), чтобы они не правили одни и те же файлы.
- **Одни и те же MCP-серверы везде.** У каждого инструмента свой конфиг, так что один сервер приходится добавлять трижды.

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

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

Сетка, worktrees, код-ревью и MCP-менеджер доступны на бесплатном тарифе. Как агенты Google соотносятся с агентами Anthropic, читайте в статье [Gemini CLI или Claude Code](/ru/blog/gemini-cli-vs-claude-code/ "Gemini CLI или Claude Code") — или [скачайте AgentVera](/ru/download/ "Скачать 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.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/