Gemini CLI: агент Google в терминале — обзор для вайбкодера

Ты слышал про Claude Code и Cursor, но не хочешь сразу платить за подписку? Или уже пробуешь агентный режим работы с кодом и ищешь бесплатную альтернативу, чтобы потренироваться? Google выпустил собственного терминального агента — Gemini CLI. Это бесплатный инструмент с открытым исходным кодом, который умеет читать файлы проекта, править код, искать информацию в интернете и выполнять команды прямо в консоли. Ниже разберём, что такое Gemini CLI, как его установить, в чём его сильные стороны и где он уступает Claude Code. Без воды, с упором на реальный опыт вайбкодера.

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

Gemini CLI — это программа от Google, которая превращает обычный терминал в интеллектуального помощника для работы с кодом. Её часто ищут по запросам вроде google gemini cli или просто gemini cli. Она работает на базе модели Gemini, общается с тобой текстом и умеет выполнять рутинные задачи разработчика: читать проект, искать ошибки, предлагать исправления, запускать команды и искать актуальную информацию в интернете.

Скажем, ты собираешь браузерную игру «Змейку» по курсу skillmake, и в какой-то момент код перестаёт работать. Вместо того чтобы вручную перебирать файлы и гадать, где ошибка, ты пишешь в терминал:

почему змейка не растёт после поедания яблока?

Gemini CLI сам находит нужные файлы, смотрит логику игры, находит строчку, где пропущен вызов увеличения длины, и предлагает исправление. Ты либо соглашаешься, либо уточняешь задачу. Это и есть агентный режим работы с кодом: ты ставишь цель обычными словами, а ИИ сам ходит по проекту, использует инструменты и возвращается с результатом.

Что умеет Gemini CLI на практике:

• Читать и анализировать файлы проекта. Он видит структуру папок, открывает нужные файлы и понимает контекст.
• Править код. Может изменять отдельные строки, добавлять функции, рефакторить или переписывать целые модули.
• Выполнять команды в терминале. Запускать скрипты, собирать проект, устанавливать зависимости, проверять результат.
• Искать информацию в интернете. Если в проекте нужна свежая документация или решение проблемы, агент может сам найти ответ.
• Работать в диалоге. Ты можешь уточнять, откатывать изменения и давать новые указания, как будто общаешься с живым помощником.

Как это выглядит на примере «Змейки»

Скажем, ты собираешь игру по модулю 2 курса skillmake. У тебя есть файл game.js, в котором описана логика движения змейки, поедания яблок и столкновений со стенками. В какой-то момент ты замечаешь, что после съедения яблока змейка не удлиняется, хотя счёт увеличивается.

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

после поедания яблока счёт растёт, а змейка не удлиняется. Найди причину и предложи исправление.

Агент открывает game.js, видит, что в обработчике столкновения со яблоком вызывается увеличение счёта, но не вызывается метод добавления сегмента к змейке. Он показывает тебе строчку с ошибкой и предлагает добавить вызов snake.grow() или аналогичный. Ты соглашаешься, агент вносит правку, и ты сразу проверяешь результат в браузере.

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

Главное отличие от обычного чата в браузере — Gemini CLI живёт внутри твоего проекта. Он видит реальные файлы, может их менять и запускать реальные команды. Это не просто собеседник, а рабочий инструмент, встроенный в твой процесс разработки.

Чем Gemini CLI отличается от Claude Code

Если ты проходишь курс skillmake, основным инструментом там является Claude Code — терминальный агент от Anthropic. Оба инструмента решают похожие задачи, но у них разная философия, разные сильные стороны и разные ограничения. Сравним честно и без маркетинговой шумихи.

Открытый исходный код

Gemini CLI распространяется с открытым исходным кодом. Это значит, что любой может посмотреть, как устроена программа, предложить улучшения или даже собрать свой вариант. Для новичка это не слишком важно на старте, но создаёт прозрачность: сообщество видит, как работает инструмент, и может быстро находить проблемы.

Claude Code — проприетарный продукт Anthropic. Его исходный код закрыт, но при этом он обычно стабильнее и предсказуемее в сложных сценариях.

Бесплатный доступ на личном Google-аккаунте

Самое заметное преимущество Gemini CLI — возможность работать бесплатно на обычном Google-аккаунте. Google даёт щедрый дневной лимит запросов для личного использования без оформления платной подписки. Для первых экспериментов, обучения и простых задач этого обычно достаточно.

Claude Code требует подписки Anthropic Pro или Team. Это не огромные деньги, но для человека, который только пробует агентный подход, любая плата может стать барьером. Gemini CLI позволяет бесплатно почувствовать, что такое «дирижировать кодом голосом», прежде чем принимать решение о платных инструментах.

Качество на длинных многошаговых задачах

Вот здесь начинаются нюансы. На практике, при прохождении курса и работе над «Змейкой», Claude Code часто оказывается надёжнее на сложных многошаговых задачах. Он лучше держит контекст, реже забывает промежуточные договорённости и более предсказуемо выполняет длинные цепочки действий.

Gemini CLI справляется с отдельными командами, простыми правками и поиском информации. Но когда задача требует последовательно пройти через несколько файлов, сохранить архитектурные ограничения и не сломать соседние модули, он может начать «плавать»: забывать детали, предлагать половинчатые решения или уходить в сторону.

Это не значит, что Gemini CLI плохой. Это значит, что он лучше подходит для:

• быстрых вспомогательных задач;
• первого знакомства с агентным режимом;
• поиска и исправления простых ошибок;
• ситуаций, когда нужно сэкономить на подписке.

А Claude Code остаётся более уверенным выбором для основной разработки, особенно если проект растёт и задачи становятся сложнее. Подробнее о выборе между Claude Code и Cursor читай в статье «Claude Code или Cursor: что выбрать вайбкодеру».

Скорость и отзывчивость

Gemini CLI часто отвечает быстро, особенно на простые вопросы. Модель Gemini хорошо оптимизирована под скорость, и для коротких запросов это приятно. Однако на сложных задачах, где нужно проанализировать много файлов, скорость может падать, а ответы становиться менее точными.

Claude Code обычно медленнее думает, но зато реже ошибается в архитектурных решениях. Это классический выбор между «быстро и иногда приблизительно» и «медленнее, но аккуратнее».

Экосистема и интеграции

Claude Code тесно интегрирован с экосистемой Anthropic и хорошо работает в связке с различными инструментами. Gemini CLI, будучи продуктом Google, естественно дружит с Google-аккаунтом, Google AI Studio и другими сервисами компании. Если у тебя уже есть Google-аккаунт, вход и настройка займут буквально минуту.

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

Установка Gemini CLI простая, особенно если у тебя уже стоит Node.js. В курсе skillmake Node.js всё равно понадобится для сборки проектов, так что один инструмент закроет сразу две потребности.

Что понадобится перед установкой

• Компьютер на Windows, macOS или Linux.
• Установленный Node.js версии 18 или новее. Node.js — это среда выполнения JavaScript, которая позволяет запускать JavaScript-программы вне браузера. В курсе она используется для сборки игры и установки вспомогательных инструментов.
• Обычный Google-аккаунт. Если у тебя есть Gmail, Google Диск или YouTube — значит, аккаунт уже есть.
• Стабильный интернет и VPN, если доступ к сервисам Google ограничен из твоего региона.

Шаг 1. Установи Node.js

Если Node.js ещё не установлен, скачай его с официального сайта nodejs.org и установи по инструкции для своей системы. После установки проверь, что всё работает, введя в терминале:

node --version
npm --version

Терминал должен показать номера версий. Если видишь ошибку — значит, установка не завершилась или терминал нужно перезапустить.

Шаг 2. Установи Gemini CLI через npm

Если ты искал в поиске gemini cli install, знай: отдельной команды gemini cli install не существует. Установка происходит через npm — менеджер пакетов для Node.js. Через него устанавливаются миллионы готовых программ и библиотек. Для установки Gemini CLI выполни в терминале:

npm install -g @google/gemini-cli

Флаг -g означает «глобально», то есть программа станет доступной из любой папки, а не только из той, где её установили.

После завершения установки проверь, что всё получилось:

gemini --version

Если терминал показывает версию — поздравляем, Gemini CLI установлен.

Шаг 3. Авторизуйся через Google-аккаунт

При первом запуске Gemini CLI попросит авторизоваться. Введи в терминале:

gemini

Программа откроет браузер или выдаст ссылку, по которой нужно перейти. Войди под своим Google-аккаунтом и разреши доступ. Это стандартная процедура OAuth — так Google понимает, кто использует инструмент и какой лимит запросов применять.

После авторизации возвращайся в терминал. Gemini CLI готов к работе.

Шаг 4. Открой проект и начни диалог

Перейди в папку со своим проектом. Например, если «Змейка» лежит в папке snake-game:

cd snake-game
gemini

Теперь ты внутри агентного интерфейса. Можешь писать запросы по-русски или по-английски. Например:

объясни структуру этого проекта

или

добавь счётчик очков в правый верхний угол экрана

Gemini CLI проанализирует файлы и предложит действия.

Как выглядит этот цикл целиком:

flowchart TB
    A[Задача обычными словами] --> B[Gemini CLI читает проект]
    B --> C[Агент предлагает план]
    C --> D[Ты проверяешь и подтверждаешь]
    D --> E[Изменения в файлах]
    E --> F[Проверка результата в браузере]

Частые проблемы при установке

Иногда установка не проходит с первого раза. Вот типичные ситуации и способы их решить.

Команда gemini не найдена. Обычно это означает, что npm установил программу в папку, которая не прописана в переменной среды PATH. Попробуй перезапустить терминал. Если не помогло — проверь, куда именно ставятся глобальные пакеты npm, и добавь этот путь в PATH вручную. На Windows это часто папка внутри AppData\Roaming\npm.

Ошибка прав доступа. На macOS и Linux иногда npm требует прав администратора для глобальной установки. Лучше не использовать sudo без необходимости, а настроить npm так, чтобы глобальные пакеты ставились в домашнюю папку пользователя. Это безопаснее и избавляет от постоянного ввода пароля.

Авторизация не открывает браузер. Если терминал не может сам открыть браузер, Gemini CLI выведет ссылку. Скопируй её, вставь в браузер вручную, войди в Google-аккаунт и подтверди доступ. После этого вернись в терминал — сессия подхватится.

Запросы не идут после авторизации. Проверь VPN и интернет. Также убедись, что в Google-аккаунте включён доступ к сервисам Gemini. Иногда новые аккаунты или аккаунты с ограниченным регионом требуют дополнительного подтверждения через Google AI Studio.

Первые шаги после запуска

После установки полезно пройти несколько простых команд, чтобы почувствовать, как работает агент:

расскажи, из каких файлов состоит этот проект

какая версия Node.js используется в проекте?

покажи содержимое файла package.json

Такие запросы не меняют ничего в проекте, но помогают понять, как Gemini CLI видит твою папку и как формулировать задачи. Когда почувствуешь уверенность, переходи к правкам кода.

Бесплатный лимит и когда он реально выручает

Одна из главных причин попробовать Gemini CLI — бесплатный доступ. На личном Google-аккаунте Google предоставляет щедрый дневной лимит запросов. Этого хватает для:

• изучения интерфейса агентного режима;
• решения простых задач по проекту;
• поиска ошибок в небольших файлах;
• экспериментов с промптами;
• параллельной работы, когда хочется что-то быстро уточнить, не тратя лимит другого инструмента.

Сколько реально нужно для обучения

На практике новичок тратит большую часть запросов не на сам код, а на уточнения, повторные попытки и разбор ошибок. Это нормально: в начале пути ты ещё не знаешь, как правильно формулировать задачи. Поэтому бесплатный лимит в Gemini CLI особенно ценен — он даёт возможность учиться без страха «сжечь» платные запросы.

Примерный сценарий первого вечера:

1. Ты устанавливаешь Gemini CLI и авторизуешься.
2. Просишь агента объяснить структуру проекта.
3. Пробуешь сделать первую правку — например, поменять цвет змейки.
4. Агент что-то меняет не так, и ты уточняешь запрос.
5. После пары итераций получаешь нужный результат.

На всё это может уйти десяток запросов. Если бы каждый из них был платным, экспериментировать было бы страшно. А в Gemini CLI можно спокойно учиться.

Как не потратить лимит впустую

Бесплатный лимит — не повод раскидывать запросы направо и налево. Вот несколько привычек, которые помогут использовать его эффективно:

• Формулируй задачу целиком. Вместо «исправь ошибку» лучше написать «игра не запускается после добавления звука, в консоли ошибка про audio context».
• Давай контекст. Если правка касается конкретного файла, укажи его: «в файле game.js строка 45».
• Проверяй предложенные изменения перед подтверждением. Агент иногда предлагает править лишнее. Лишние правки = лишние итерации = лишние запросы.
• Разбивай сложную задачу на части. Не проси сразу «сделай магазин, таблицу лидеров и звук». Сначала магазин, потом таблица, потом звук.

Про бесплатный лимит:

• Он не бесконечен. Если ты будешь гонять агента целый день на сложных задачах, лимит может закончиться.
• Он может меняться. Google периодически корректирует условия использования своих моделей. Поэтому не стоит строить бизнес-процессы на текущих цифрах без проверки.
• Он привязан к аккаунту. Не пытайся обходить лимиты созданием множества аккаунтов — это нарушает правила Google и может привести к блокировке.

Для вайбкодера-новичка бесплатный лимит — это шанс бесконечно не платя понять: а нужен ли мне вообще агентный режим? Понравилось дирижировать кодом текстом — значит, инвестиция в Claude Code или Cursor окупится. Не понравилось — ты ничего не потерял, кроме пары вечеров.

Когда бесплатность превращается в ограничение

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

• Качество на сложных задачах. Как уже говорилось, на длинных многошаговых цепочках Gemini CLI может уступать платным конкурентам.
• Приоритет скорости. В периоды высокой нагрузки бесплатные запросы могут обрабатываться медленнее.
• Отсутствие некоторых функций. Платные инструменты часто получают новые возможности раньше и имеют более тонкие настройки.

Поэтому Gemini CLI — отличная стартовая площадка, но не универсальное решение на все случаи жизни.

Интеграция с MCP: подключение внешних инструментов

Одна из самых интересных возможностей современных терминальных агентов — поддержка MCP. MCP расшифровывается как Model Context Protocol, то есть протокол контекста модели. Проще говоря, это стандарт, который позволяет ИИ-агенту подключаться к внешним инструментам: базам данных, поисковикам, системам контроля версий, облачным сервисам и многому другому.

Скажем, твой агент — это повар на кухне. Без MCP он может работать только с тем, что лежит в его ящиках: нож, доска, сковорода. С MCP к нему можно подключить целый ресторанный склад: холодильник с продуктами, посудомойку, кофемашину, термометр для мяса. Агент получает доступ к большему количеству инструментов и может решать более сложные задачи.

Gemini CLI тоже поддерживает MCP-серверы. Это значит, что ты можешь подключить к нему те же внешние инструменты, что и к Claude Code. Например:

• Поисковые MCP-серверы помогают находить актуальную документацию и примеры кода.
• Серверы для работы с Git позволяют агенту смотреть историю коммитов, создавать ветки и оформлять пул-реквесты.
• Серверы баз данных дают возможность читать и записывать данные в базу прямо из диалога.
• Серверы для браузера позволяют агенту открывать страницы, тестировать веб-приложения и проверять вёрстку.

Подробнее о том, что такое MCP и как его использовать, читай в статье «Что такое MCP: простыми словами».

Как это работает на практике

Когда Gemini CLI подключён к MCP-серверу, ты можешь задавать более мощные запросы. Например:

найди в интернете актуальный способ сохранять рекорды игры в браузере

Агент использует поисковый MCP, находит информацию про localStorage, объясняет, как это работает, и предлагает добавить соответствующий код в проект.

Или:

закоммить текущие изменения и создай ветку для нового уровня

При подключённом Git MCP агент сам выполнит команды git add, git commit и git branch.

Когда стоит попробовать Gemini CLI

Gemini CLI не заменит Claude Code для серьёзной разработки, но он отлично решает несколько конкретных задач. Вот ситуации, когда его стоит попробовать.

Перед покупкой платного агента

Если ты ещё не уверен, нужен ли тебе агентный режим работы с кодом, Gemini CLI — идеальный способ проверить это бесплатно. Ты поймёшь, как формулировать задачи, как агент читает проект, какие ошибки он делает и как их контролировать. Этот опыт сильно ускорит работу с платными инструментами, если решишь перейти.

Для простых вспомогательных задач

Иногда нужно быстро что-то уточнить, не открывая полноценный проект в Claude Code. Например:

• объяснить, что делает непонятная функция;
• найти опечатку в конфиге;
• сгенерировать простой скрипт;
• преобразовать формат данных;
• написать текст для интерфейса игры.

Для таких задач Gemini CLI часто справляется не хуже платных аналогов, а иногда даже быстрее.

Когда закончился лимит другого инструмента

Если ты платишь за Claude Code или Cursor и вдруг достиг дневного лимита запросов, Gemini CLI может выручить. Он позволит доделать мелочи, не прерывая рабочий процесс.

Для экспериментов с промптами

Умение правильно ставить задачи ИИ — ключевой навык вайбкодера. Gemini CLI даёт безопасную площадку для тренировки: можно пробовать разные формулировки, смотреть, что работает, и улучшать свои промпты без финансовых потерь.

Для работы с открытыми проектами

Если ты хочешь внести вклад в open-source проект или разобраться в чужом коде, Gemini CLI поможет быстро получить обзор структуры и найти точки входа. Открытый исходный код самого инструмента также привлекает тех, кто ценит прозрачность.

Когда лучше не использовать Gemini CLI

Есть ситуации, где Gemini CLI может принести больше вреда, чем пользы:

• Сложная архитектура. Если проект уже большой и взаимосвязанный, Claude Code обычно справляется надёжнее.
• Критичные задачи. Важные изменения, от которых зависит работа приложения, лучше делать в более предсказуемом инструменте.
• Длинные сессии. Если задача требует десятков шагов и постоянного удержания контекста, Gemini CLI может устать и начать ошибаться.

Честный вывод: стоит ли использовать в курсе

Давай подведём итог без прикрас. Gemini CLI — это хороший, щедрый и доступный инструмент для первого знакомства с агентным программированием. Он бесплатный, с открытым исходным кодом, прост в установке и умеет всё основное: читать код, править код, выполнять команды и искать информацию.

Для новичка в курсе skillmake он может стать отличным тренировочным полигоном. Ты поймёшь, каково это — управлять кодом текстом, как агент интерпретирует твои слова и где нужно быть особенно внимательным. Эти навыки пригодятся независимо от того, каким инструментом ты будешь пользоваться в будущем.

Однако для основной работы над курсом, особенно на сложных многошаговых задачах, Claude Code остаётся более надёжным выбором. Он лучше держит длинный контекст, реже теряет нить разговора и более предсказуемо ведёт проект от начала до конца. Если ты всерьёз хочешь собрать приложение и не тратить время на борьбу с непредсказуемым поведением агента, инвестиция в Claude Code оправдана.

Gemini CLI хорош как:

• бесплатный старт;
• вспомогательный инструмент;
• способ экономить запросы в платных агентах;
• площадка для обучения.

Claude Code хорош как:

• основной рабочий инструмент;
• помощник в сложных проектах;
• надёжный партнёр на длинной дистанции.

Если хочешь больше узнать про бесплатные возможности Google для вайбкодинга, загляни в статью «Google AI Studio: бесплатный Gemini для новичка».

Частые вопросы

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

Это бесплатная программа от Google, которая работает в терминале и помогает писать, читать и исправлять код с помощью искусственного интеллекта. Ты пишешь задачу обычными словами, а агент сам анализирует файлы проекта, предлагает решение и может выполнить нужные команды.

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

Да, на личном Google-аккаунте Google предоставляет щедрый бесплатный дневной лимит запросов без подписки. Конкретные лимиты могут меняться, поэтому актуальные условия лучше проверять на официальном сайте Google.

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

Установка выполняется через npm: npm install -g @google/gemini-cli. После установки нужно авторизоваться через Google-аккаунт командой gemini в терминале. Подробнее об установке Node.js и настройке окружения читай в материалах курса.

В чём главное отличие Gemini CLI от Claude Code?

Gemini CLI бесплатен и имеет открытый исходный код, что делает его удобным для первых экспериментов. Claude Code платный и закрытый, но обычно надёжнее на сложных многошаговых задачах и лучше держит длинный контекст проекта.

Поддерживает ли Gemini CLI MCP-серверы?

Да, Gemini CLI поддерживает MCP-серверы. Это значит, что к нему можно подключить внешние инструменты — поиск, Git, базы данных, браузер и другие сервисы. Подробнее в статье «Что такое MCP».

Когда лучше использовать Gemini CLI, а когда Claude Code?

Gemini CLI подходит для обучения, простых вспомогательных задач и ситуаций, когда хочется сэкономить. Claude Code лучше выбрать для основной разработки, сложных проектов и длинных сессий, где важна предсказуемость.