Урок 1: Установка Antigravity CLI

Чему вы научитесь

• Поймёте, почему модуль больше не учит бесплатный Gemini CLI
• Поставите Antigravity CLI (agy) на macOS, Linux или Windows
• Войдёте через браузер или ключ Gemini API
• Перенесёте навыки и MCP со старого Gemini CLI, если они были
• Сравните установку с Claude Code

Что такое Antigravity CLI?

Antigravity CLI — терминальный агент Google. Тот же «движок», что у приложения Antigravity 2.0, только в терминале: читает проект, правит файлы, запускает команды, поднимает несколько агентов в фоне.

Команда в терминале: agy.

19 мая 2026 Google написал: потребительский Gemini CLI уходит, ему на смену — Antigravity CLI. 18 июня 2026 Gemini CLI перестал отвечать на бесплатных аккаунтах и на Google AI Pro / Ultra. Источник: блог разработчиков Google.

┌─────────────────────────────────────────┐
│          Antigravity CLI (agy)          │
├─────────────────────────────────────────┤
│ • Тот же harness, что у Antigravity 2.0 │
│ • Модели линейки Gemini 3.x (Flash/Pro) │
│ • Бинарь Go, не npm-пакет               │
│ • Skills, hooks, MCP, плагины           │
│ • Читает GEMINI.md и AGENTS.md          │
│ • macOS / Linux / Windows               │
└─────────────────────────────────────────┘

Требования

• Терминал (macOS / Linux / Windows)
• Интернет
• Google-аккаунт или ключ из Google AI Studio
• Node.js не нужен (это не npm-пакет)

Шаг 1: Установка

Официальная инструкция: antigravity.google/docs/cli/install.

macOS и Linux

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

Бинарь: ~/.local/bin/agy. Если команда не находится — добавьте ~/.local/bin в PATH и откройте терминал заново.

Windows (PowerShell)

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

Бинарь: C:\Users\<вы>\AppData\Local\agy\bin. Закройте и откройте PowerShell.

Проверка:

agy --help

Шаг 2: Вход

Вариант А: Google-аккаунт (по умолчанию)

agy

На своей машине откроется браузер. По SSH агент напечатает ссылку: откройте её локально, войдите, вставьте код обратно в терминал.

Вариант Б: ключ Gemini API (CI, без браузера)

Ключ — в Google AI Studio. Одного export GEMINI_API_KEY=... мало: в ~/.gemini/antigravity-cli/settings.json нужно "modelProvider": "gemini".

{
  "modelProvider": "gemini"
}

export GEMINI_API_KEY="ваш-ключ"
agy

В шапке будет «Gemini API key», не почта. GOOGLE_API_KEY и файлы .env агент не читает.

Шаг 3: Если раньше стоял Gemini CLI

При первом запуске agy сам предложит перенести расширения и настройки. Вручную:

agy plugin import gemini

Что остаётся как было:

• в проекте — GEMINI.md и AGENTS.md;
• глобально — ~/.gemini/GEMINI.md.

Что переезжает:

Источник: миграция.

Шаг 4: Первый запрос

В папке с кодом:

agy

Напишите: «Кратко опиши структуру этой папки». Агент должен перечислить файлы, не выдумывая репозиторий.

Выход: /logout сбрасывает сохранённый вход.

Сравнение с Claude Code на старте

Из России

Вход в Google и Anthropic с российских адресов часто не открывается. Не советуем конкретные марки VPN: в 2026 их режут. Модели рублями без подписки вендора — arckep.ru, стартовый баланс 100 ₽.

Если что-то сломалось

Страница типичных ошибок старого бинаря: troubleshooting/gemini-cli. Для нового агента смотрите официальный troubleshooting и команду agy --help.

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

• Для ученика Google в терминале — agy, не gemini
• Старый Gemini CLI жив для компаний и платного ключа, не как бесплатный старт
• Установка — официальный скрипт, Node.js не нужен
• GEMINI.md агент читает; скиллы проекта — в .agents/skills/