← Все движки

Gemini CLI

Google Gemini CLI под обычным Google-аккаунтом: контекст в миллион токенов, одна рабочая слэш-команда и почему остальные роняют запуск.

Gemini CLI работает в VibeForge под обычным Google-аккаунтом, на бесплатном тарифе и без API-ключа. Доступны Gemini 3.1 Pro, 2.5 Pro и 2.5 Flash — у всех контекст 1 000 000 токенов. Особенность у него неприятная и стоит знать заранее: почти любая слэш-команда в неинтерактивном режиме не игнорируется, а обрывает запуск с ошибкой.

Что VibeForge знает про этот движок

СвойствоЗначение
Исполняемый файлgemini, переопределяется VIBEFORGE_GEMINI_BIN
Вычищается из окруженияGEMINI_API_KEY, GOOGLE_API_KEY
Модели и контекстGemini 3.1 Pro, 2.5 Pro, 2.5 Flash — по 1 000 000 токенов
Уровень рассужденийфлага нет: глубину CLI выбирает сам
Обновлениеnpm install -g @google/gemini-cli@latest
Слэш-команды в headless1: /plan — и только с аргументом

Почему ключи вычищаются, хотя они «просто лежат в окружении»

Потому что с выставленным GEMINI_API_KEY или GOOGLE_API_KEY CLI молча начинает биллить ключ вместо входа по аккаунту, а два ключа сразу — классический источник загадочных отказов. VibeForge подключается подписочным входом, поэтому обе переменные убираются из окружения агента.

Слэш-команды: не «не работают», а роняют запуск

Неинтерактивный режим команду разбирает, но принимает только один вид результата — «отправить это моделью как задание». На любой другой (сообщение, справка, сжатие контекста, статистика) он не отступает молча, а завершается фатальной ошибкой ввода. Из встроенных команд нужный результат возвращает ровно одна — /plan, и только если ей передан аргумент: без аргумента она просто переключает режим и отдаёт строку «/plan» модели текстом.

Что отправленоЧем кончится
/plan исправить логинработает: включается режим плана, задача уходит той же строкой
/plan без аргументастрока уходит модели текстом, ход потрачен
/init, /compress, /stats, /memory, /tools, /mcp, /chat, /docs, /copyзапуск обрывается фатальной ошибкой

Отдельно работают команды пользователя из .gemini/commands/*.toml и промпты MCP-серверов — они возвращают ровно тот вид результата, который нужен. В общий каталог движка их не поместить: они лежат на диске конкретного проекта.

Установка и вход

  1. 1Поставьте CLI: npm i -g @google/gemini-cli.
  2. 2Запустите gemini и войдите Google-аккаунтом, когда программа спросит.
  3. 3В VibeForge откройте «Настройки → Окружение» и нажмите «Проверить снова».