sitdraw

Как установить Gemini CLI: вход Google и первая задача

По официальным шагам установить Gemini CLI, войти через Google и выполнить первую задачу по коду в текущем репозитории.

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

Идите по официальному старту, не угадывайте команды. Запросы: установить Gemini CLI, вход Google в Gemini CLI, команда gemini. Документы: geminicli.com/docs/get-started/.

20+Минимальный Node.js
npmРекомендуемая установка
GoogleРекомендуемый вход

Сверить рантайм, затем выбрать установку

Глобальный npm

Проверьте node -v ≥ 20.0.0, затем npm install -g @google/gemini-cli. Это официальный путь. Стабильный канал — тег latest.

Homebrew или разовая проба

macOS / Linux: brew install gemini-cli. Разово: npx @google/gemini-cli. Не ставьте npm и Homebrew сразу: PATH будет конфликтовать.

СпособКомуНа что смотреть
Sign in with GoogleЛокальная машина с браузеромЛичный аккаунт часто без проекта; Workspace часто нужен GOOGLE_CLOUD_PROJECT
Ключ Gemini APIAI Studio, без браузераСекрет: не коммитить в репозиторий
Vertex AIУже есть проект Google CloudНужны Cloud-проект и регион

Установка, вход, первая задача

  1. 01
    Проверить Node и установить

    Документы: Node.js 20.0.0+, macOS 15+, Windows 11 24H2+, Ubuntu 20.04+. Затем gemini и ждать вопрос про вход.

  2. 02
    Войти через Google

    Выберите 1. Sign in with Google, аккаунт, Sign in. Данные остаются локально. Если рабочий аккаунт просит проект — задайте переменную среды до следующей сессии.

  3. 03
    Одно проверяемое дело в репозитории

    Откройте gemini в корне. Сначала объяснение входного файла только на чтение. Затем по официальному образцу — юнит-тесты для существующего модуля или одно небольшое изменение.

  4. 04
    Смотреть diff до записи

    CLI спрашивает перед правкой файлов и командами с побочными эффектами. Allow once, не постоянный доступ по умолчанию. Квота: /stats model.

node -v
npm install -g @google/gemini-cli
gemini
# После входа, в корне репозитория, например:
# Read the entry file and explain how the app starts.
# Then write unit tests for Login.js and wait before writing files.
Личному аккаунту Google нужен Cloud-проект?
Документы: большинству личных — нет. Компания, школа или Workspace — обычно да. Личный аккаунт всё равно могут спросить, если сработала официальная оговорка.
Страница входа не открывается.
OAuth возвращает браузер на localhost, который слушает CLI. Удалённый SSH, хост без экрана или сеть, режущая localhost, ломают вход. Возьмите ключ Gemini API или войдите на машине с браузером.
Какого размера первая задача?
То, что сразу проверяется тестом или diff. Официальные примеры: тесты для Login.js или клон chalk с разбором исходников. Не начинайте с переписывания всего репозитория.
Заменяет ли установка ревью схемы?
Нет. Это помощник в терминале. Если встреча — та же модульная схема, откройте sitdraw.

Сначала понять, потом одобрить запись

Модель может рассказать изменение, которое звучит верно. Без вашего одобрения записи она не должна трогать репозиторий. Тесты по-прежнему запускаете вы.

Начать картину