Gemini CLI или Claude Code — это терминальный агент Google против терминального агента Anthropic. Gemini CLI — AI-агент с открытым исходным кодом (Apache 2.0), который запускает модели Gemini в вашем терминале: он читает и правит файлы, запускает команды оболочки, ищет в интернете, подключается к MCP-серверам и берёт инструкции проекта из GEMINI.md. Claude Code делает ту же работу на моделях Claude и с CLAUDE.md. Главная новость — не функция: с 18 июня 2026 года Gemini CLI больше не обслуживает бесплатные личные аккаунты. Пользователей бесплатного уровня и Google One перевели на Antigravity CLI, а Gemini CLI теперь для платных API-ключей, Vertex AI и бизнес-лицензий Code Assist.
В статье объясняется, что такое Gemini CLI сегодня, как его установить и войти, как работают GEMINI.md, MCP и песочница и как он соотносится с Claude Code. Баллов бенчмарков нет: они меняются с каждым релизом модели. О другом крупном сравнении читайте в статье Claude Code или Codex.
Что такое Gemini CLI?
Gemini CLI — это консольный кодинг-агент Google. Вы запускаете gemini в папке проекта и разговариваете с ним. Встроенные инструменты позволяют ему читать и писать файлы, запускать команды оболочки, загружать веб-страницы и искать в Google. Он работает интерактивно или без интерфейса через -p, так что его можно вызывать из скриптов и CI.
# interactive
gemini
# one-shot, with JSON output for scripts
gemini -p "summarize the changes in the last commit" --output-format json
# pick a model and add another directory to the context
gemini -m gemini-2.5-flash --include-directories ../shared
Исходный код лежит на GitHub под лицензией Apache 2.0. Стабильные релизы выходят еженедельно, а для тех, кому нужны изменения раньше, есть каналы preview и nightly.
Изменение июня 2026: Antigravity CLI
Google объявила, что Gemini CLI для обычных пользователей заменяется на Antigravity CLI. По блогу разработчиков Google и README Gemini CLI:
- С 18 июня 2026 года Gemini CLI перестал обслуживать запросы пользователей Google AI Pro и Ultra и пользователей бесплатного Gemini Code Assist for individuals. В README это сформулировано так: «Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI.»
- Доступ сохраняется для организаций на Gemini Code Assist Standard или Enterprise, для Code Assist for GitHub через Google Cloud и для платных API-ключей Gemini.
- В README также сказано, что Gemini CLI не оптимизирован под новейшие модели Google, и для них предлагается Antigravity.
Antigravity CLI запускается как agy. Он находит существующие настройки Gemini CLI, читает GEMINI.md и AGENTS.md, сохраняет agent skills, hooks и субагентов и преобразует расширения Gemini CLI в плагины Antigravity командой agy plugin import gemini. Google предупреждает, что полного соответствия функций один к одному не будет, так что перед переходом команды изучите руководство по миграции.
Если вы использовали Gemini CLI потому, что он был бесплатным, важна именно эта часть. Остальная часть статьи относится к Gemini CLI с платным ключом или бизнес-лицензией, и многое переносится и на Antigravity.
Установка
Gemini CLI — пакет Node.js:
# try it without installing
npx @google/gemini-cli
# install globally
npm install -g @google/gemini-cli
# or with Homebrew
brew install gemini-cli
Каналы релизов — это теги npm: @latest (стабильный, еженедельный), @preview (еженедельный) и @nightly.
Способы входа
При первом запуске gemini спрашивает, как проходить аутентификацию. Документированные варианты:
| Способ | Что задать | Статус после 18 июня 2026 |
|---|---|---|
| Sign in with Google | Вход через браузер; для платной лицензии Code Assist нужен ещё GOOGLE_CLOUD_PROJECT | Работает для Code Assist Standard и Enterprise; личные аккаунты и Google One переведены на Antigravity |
| API-ключ Gemini | GEMINI_API_KEY из Google AI Studio | Платные ключи продолжают работать |
| Vertex AI | GOOGLE_CLOUD_PROJECT и GOOGLE_CLOUD_LOCATION, а также ADC (gcloud auth application-default login), сервисный аккаунт или GOOGLE_API_KEY | Продолжает работать |
export GEMINI_API_KEY="your-key"
gemini
Аккаунтам Workspace и организаций нужен проект Google Cloud. На странице квот Google раньше приводились суточные числа запросов для каждого типа аутентификации; часть этих цифр появилась до июньского изменения, поэтому смотрите актуальную страницу и консоль Cloud, а не число из блога.
GEMINI.md: инструкции проекта
GEMINI.md — ответ Gemini CLI на CLAUDE.md. Он загружается слоями:
- Глобальный:
~/.gemini/GEMINI.mdдля правил, которые нужны везде. - Рабочая область: файлы
GEMINI.mdв каталогах вашей рабочей области и в их родителях. - Just in time: когда инструмент обращается к пути, Gemini CLI подхватывает и файлы
GEMINI.mdрядом с этим путём.
Длинный файл можно разбить и подключать части через @file.md. Внутри сессии /memory show выводит объединённый контекст, а /memory reload перечитывает файлы.
Чтобы делиться одним файлом с другими агентами, измените имя файла, которое он ищет, в ~/.gemini/settings.json или в .gemini/settings.json проекта:
{
"context": {
"fileName": ["AGENTS.md", "GEMINI.md"]
}
}
Claude Code читает CLAUDE.md и может импортировать AGENTS.md через @AGENTS.md. Когда настроены оба, один AGENTS.md управляет обоими агентами. О том, что в него класть, читайте в статье как писать CLAUDE.md и AGENTS.md.
MCP в Gemini CLI
Gemini CLI подключается к MCP-серверам, объявленным в mcpServers в settings.json. Сервер может быть локальной командой (command, args, env, cwd) или удалённым (url для SSE, httpUrl для потокового HTTP).
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": { "GITHUB_TOKEN": "$GITHUB_TOKEN" }
}
}
}
Или добавьте сервер из командной строки:
gemini mcp add -s user -t http docs https://example.com/mcp
-s выбирает область (project по умолчанию или user), а -t — транспорт (stdio, sse или http). В сессии /mcp показывает серверы и их инструменты, а /mcp auth обрабатывает OAuth для серверов, которым он нужен. У Claude Code всё выглядит почти так же: claude mcp add, а серверы проекта хранятся в .mcp.json. Только знакомитесь с протоколом? Начните со статьи что такое MCP-сервер.
Песочница и подтверждения
Здесь Gemini CLI сильнее всего. Песочница по умолчанию выключена, и включается она через --sandbox (-s), переменную окружения GEMINI_SANDBOX или "sandbox": true в разделе tools настроек.
- macOS: Seatbelt (
sandbox-exec) с профилемpermissive-openпо умолчанию; другие профили черезSEATBELT_PROFILE. - Контейнеры: Docker или Podman с образом
ghcr.io/google/gemini-cli. - Другое: нативная песочница Windows, gVisor (
runsc) и LXC (экспериментально).
gemini --sandbox
GEMINI_SANDBOX=docker gemini
Режимы подтверждений отделены от песочницы. default спрашивает перед правками и командами, auto_edit применяет правки файлов без вопросов, а plan работает только на чтение. YOLO (одобрять всё) доступен только из командной строки через --yolo или --approval-mode=yolo. Если включить в настройках контрольные точки, /restore вернёт файлы к снимку, сделанному до запуска инструмента.
У Claude Code есть режимы разрешений (спрашивать, принимать правки, plan, обход) и необязательная песочница для инструмента Bash. У Gemini CLI больше бэкендов песочницы на выбор. Что бы вы ни использовали, безопасное правило одно: никогда не давайте агенту полный доступ вне контейнера или одноразового worktree. Об угрозах читайте в статье безопасность AI-агентов для программирования.
Gemini CLI и Claude Code в таблице
| Gemini CLI | Claude Code | |
|---|---|---|
| Разработчик, модели | Google, модели Gemini | Anthropic, модели Claude |
| Исходный код | Открытый, Apache 2.0 | Проприетарный |
| Установка | npm install -g @google/gemini-cli, brew install gemini-cli | curl -fsSL https://claude.ai/install.sh | bash, Homebrew, WinGet |
| Кто может пользоваться сейчас | Платные API-ключи Gemini, Vertex AI, Code Assist Standard/Enterprise | Платные тарифы Claude или API Anthropic |
| Файл инструкций | GEMINI.md (настраивается через context.fileName) | CLAUDE.md |
| MCP | mcpServers в settings.json, gemini mcp add | .mcp.json, claude mcp add |
| Песочница | Seatbelt, Docker/Podman, Windows, gVisor, LXC | Необязательная песочница для инструмента Bash |
| Режимы подтверждений | default, auto_edit, plan, YOLO по флагу | Default, accept edits, plan, bypass |
| Отмена | Контрольные точки с /restore | Контрольные точки с rewind |
| Без интерфейса | gemini -p, вывод JSON и stream-JSON | claude -p, вывод JSON и stream-JSON |
| Дополнительно | Расширения, встроенный веб-поиск | Hooks, skills, субагенты, плагины |
Что и когда использовать
Используйте Gemini CLI, когда:
- Ваша компания уже покупает Gemini через Google Cloud или у неё есть Code Assist Standard либо Enterprise.
- Вам нужен настоящий бэкенд песочницы (Docker, gVisor, профили Seatbelt), встроенный в агента.
- Вы хотите читать или менять исходный код агента; он открытый.
- Вам нужна встроенная привязка к поиску Google.
Используйте Claude Code, когда:
- У вас подписка Claude и вы хотите агента, настроенного под модели Claude.
- Вы полагаетесь на режим plan, hooks, skills или субагентов.
- Вы хотите запускать его в терминале, расширении IDE, настольном приложении и вебе с одной и той же настройкой.
Присмотритесь к Antigravity CLI, если вы были личным пользователем Gemini CLI или пользователем Google One. Именно туда Google вас сейчас направляет.
Запуск обоих
Запускать двух агентов от двух вендоров принято по тем же причинам, что и любую пару: второе мнение по важным изменениям, второй пул использования, когда один кончился, и выбор модели под задачу. Схема, которая работает:
- Один файл правил. Положите общие правила в
AGENTS.md, добавьте его вcontext.fileNameу Gemini и импортируйте изCLAUDE.md. - Отдельные папки. Дайте каждому агенту свой git worktree и ветку, чтобы они никогда не правили один и тот же файл.
- Отдельная настройка MCP. Каждый инструмент хранит свои настройки MCP; добавьте одни и те же серверы в оба или зарегистрируйте их один раз в AgentVera, который передаст их обоим.
- Один проверяющий. Пусть один агент проверяет ветку другого, прежде чем вы сольёте.
Gemini CLI, Antigravity и Claude Code в AgentVera
AgentVera — настольное приложение для macOS, Windows и Linux, которое запускает терминальных кодинг-агентов в настоящих терминалах, в сетке на проект, с вашими существующими входами. Gemini CLI, Antigravity CLI и Claude Code есть в диалоге New agent; ещё не установленный CLI отображается как Not installed.
| Задача | В AgentVera |
|---|---|
| Вход | Gemini CLI использует собственный вход Google или GEMINI_API_KEY; AgentVera его не заменяет |
| Выбор модели | Оставьте пустым для значения по умолчанию Gemini CLI или выберите, и она передастся через --model |
| Разрешения | Ask, Auto или Full access для каждого агента; для Gemini CLI Auto — это --approval-mode auto_edit, а Full access — --approval-mode yolo |
| Сохранение сессий | Каждый агент Gemini стартует со своим --session-id и открывается снова через --resume |
| Проверка работы | Автоматическое код-ревью по окончании хода |
| Цепочки агентов | Flows: Gemini CLI может быть источником или целью (Pro и Team) |
Нужно сказать и об ограничениях. MCP-серверы AgentVera и его браузер до Gemini CLI доходят: они подключаются при каждом запуске и сливаются по имени с вашими собственными mcpServers. У Gemini CLI нет флага дополнительных инструкций, поэтому поле Role and instructions до него не доходит; используйте AGENTS.md или GEMINI.md. А Full access никогда не спрашивает, так что оставьте его для агентов в worktree или контейнере.
Сетка, worktree и код-ревью доступны на бесплатном тарифе. Скачайте AgentVera, откройте агента Gemini CLI или Antigravity рядом с Claude Code в двух worktree и сравните их на своём репозитории.
Короткий ответ
Gemini CLI — способный терминальный агент с открытым кодом и широким выбором бэкендов песочницы, но с июня 2026 года это инструмент для платных API-ключей и клиентов Google Cloud. Claude Code — более сильный выбор, если вы на тарифе Claude и хотите hooks, skills и субагентов. Если вы сидели на бесплатном уровне Gemini CLI, посмотрите на Antigravity CLI. И по возможности держите один AGENTS.md и запускайте двух агентов.