Gemini CLI — это open-source AI-агент, который запускает Gemini прямо в терминале. Репозиторий — google-gemini/gemini-cli, пакет — @google/gemini-cli, дока — geminicli.com/docs, лицензия Apache 2.0. Ниже — как пользоваться новичку и где смотреть квоты.
Соседи: Codex CLI, Claude Code, Aider, Goose, Augment Code. Pillar — n8n / автоматизация.
Для кого Gemini CLI
Берите Gemini CLI, если удобен Google-аккаунт и нужен терминальный агент с поиском/файлами/shell из коробки. Если биллинг уже в ChatGPT — чаще проще Codex CLI. Для IDE-first — Cursor/Kilo, не обязательно CLI.
| Контур | Что ставите | Деньги (мягко)* | Кому |
|---|---|---|---|
| npx | npx @google/gemini-cli |
$0 за пакет; квоты auth | Разовый прогон без install |
| npm global | npm i -g @google/gemini-cli |
$0 + квоты | Ежедневный терминал |
| Homebrew | brew install gemini-cli |
$0 + квоты | macOS/Linux brew-пользователи |
| Google OAuth | Sign in with Google | Free tier 60/min, 1000/day | Индивид без API key |
| API key / Vertex | GEMINI_API_KEY или GCP project | usage / enterprise квоты | Контроль модели и прод |
*Цифры free tier и установка: README google-gemini/gemini-cli и geminicli.com/docs (срез август 2026). Paid Code Assist / Vertex — отдельные квоты cloud.google.com. ₽ не выдумываем.
Как пользоваться: маршрут на 1 вечер
- Запустите без установки:
npx @google/gemini-cliили поставьте глобально через npm/Homebrew. - Выберите auth: Sign in with Google (проще для новичка) или
export GEMINI_API_KEY=…из AI Studio. - Для org Code Assist при необходимости задайте
export GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID. - Дайте узкую задачу в каталоге репо: файлы, критерий готово, без секретов в промпте.
- Используйте встроенные tools: поиск Google grounding, файлы, shell — но подтверждайте опасные команды.
- Для CI/GitHub смотрите Action
google-github-actions/run-gemini-cli, не смешивайте с локальным интерактивом.
# Быстрый старт
npx @google/gemini-cli
# или
npm install -g @google/gemini-cli
gemini
# Пример задачи
В src/api найди обработчик /health.
Добавь проверку версии сборки в JSON-ответ.
Минимальный патч. Критерий: существующий e2e health зелёный.Сильные стороны по README Google
- Free tier с личными Google-квотами (60/min, 1000/day) — низкий порог входа.
- Built-in tools: Google Search grounding, файлы, shell, web fetch.
- MCP и GitHub Action для расширения и автоматизации PR.
- Open source Apache 2.0; каналы stable/preview/nightly на npm.
Типичные ошибки
- Путать Gemini CLI с веб-чатом Gemini — разный продукт и runtime.
- Фиксировать квоты «навсегда» без сверки README/cloud quotas.
- Ставить nightly в прод-скрипты без понимания риска регрессий.
- Кормить агента секретами и prod credentials.
- Ждать IDE-diff UX как в Cursor — это терминальный агент.
FAQ: Gemini CLI
Что такое Gemini CLI?
Gemini CLI — open-source AI-агент Google, который запускает Gemini в терминале. Репозиторий google-gemini/gemini-cli, пакет npm @google/gemini-cli, дока geminicli.com/docs, лицензия Apache 2.0.
Сколько стоит Gemini CLI?
Сам CLI open source. Free tier при Sign in with Google: 60 requests/min и 1,000 requests/day (README, срез август 2026). Есть пути Gemini API Key и Vertex AI с отдельным биллингом. ₽ не фиксируем — сверяйте квоты Google.
Как установить Gemini CLI?
Быстрый старт: npx @google/gemini-cli. Глобально: npm install -g @google/gemini-cli или brew install gemini-cli. Затем команда gemini и вход Google / API key.
Чем Gemini CLI отличается от Codex CLI?
Gemini CLI опирается на модели Gemini и Google-аккаунт/Vertex. Codex CLI — линейка OpenAI/ChatGPT. Оба терминальные агенты; выбор чаще по уже оплаченному кабинету и экосистеме.
Какие модели доступны?
В README заявлены Gemini 3 models и окно контекста до 1M tokens. Точный список моделей и квот зависит от способа auth (Google / API key / Vertex) — сверяйте доки geminicli.com и ai.google.dev.
Есть ли MCP и GitHub Action?
Да: MCP для расширений; GitHub Action google-github-actions/run-gemini-cli для PR review, triage и mention @gemini-cli.
Вывод
Gemini CLI — open-source терминальный агент Google: npx/npm → gemini → Google login или API key → узкая задача. Free tier удобен для старта; Codex CLI и Claude Code — соседи, если биллинг в другой экосистеме.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.