Как установить Gemini CLI на Windows и запустить первую задачу

Gemini CLI можно установить на Windows через npm, но в 2026 году перед настройкой важно определить тип доступа. С 18 июня Gemini CLI перестал обслуживать запросы бесплатных индивидуальных аккаунтов и подписчиков Google AI Pro и Ultra. Google переносит для них терминальный опыт в Antigravity CLI. Gemini CLI остается доступен через поддерживаемые API-ключи, Google Cloud и корпоративные лицензии Gemini Code Assist.

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

Используйте Gemini CLI, если у вас есть один из актуальных вариантов:

• поддерживаемый Gemini API key;

• доступ через Vertex AI или Google Cloud;

• Gemini Code Assist Standard или Enterprise;

• корпоративная конфигурация, выданная администратором.

Если вы хотите войти личным бесплатным, Google AI Pro или Ultra аккаунтом, откройте официальное объявление о переходе на Antigravity CLI. Не пытайтесь исправить отказ входа переустановкой Node.js: проблема находится в политике доступа, а не в локальном пакете.

Open-source репозиторий Gemini CLI продолжает обновляться для поддерживаемых сценариев. Поэтому сама установка остается рабочей, но способ авторизации нужно выбирать по учетной записи.

Официальный installation guide на дату проверки рекомендует Windows 11 24H2 или новее, Node.js 20 или новее, PowerShell и интернет-соединение. Более старое окружение может работать, но не является лучшей исходной точкой для инструкции новичку.

Проверьте Windows через winver. Затем откройте PowerShell, не обязательно от имени администратора, и выполните:

Команды по порядку: node --version и npm --version.

Если node не найден, установите текущую поддерживаемую LTS-версию с официального сайта Node.js. После установки закройте и заново откройте PowerShell. Не скачивайте случайный архив с зеркала и не отключайте политику безопасности без понимания причины.

Версия Node должна быть не ниже требования документации. Слишком старая версия часто приводит к ошибкам синтаксиса или зависимостей при запуске CLI.

Стабильная установка:

npm install -g @google/gemini-cli@latest

Затем проверьте бинарник:

Команды по порядку: gemini --version и Get-Command gemini.

Команда Get-Command показывает путь, из которого запускается CLI. Это помогает, если на компьютере осталась другая версия.

Для одноразового запуска без глобальной установки официальная документация предлагает npx:

Команда для этого шага: npx @google/gemini-cli.

Для постоянной работы глобальная установка обычно понятнее. Preview и nightly релизы нужны для тестирования новых функций и могут содержать регрессии. Новичку лучше stable tag latest.

Сначала закройте PowerShell и откройте заново. Затем посмотрите глобальный npm-prefix:

Команда для этого шага: npm config get prefix.

Путь с глобальными npm-бинарниками должен быть в пользовательской переменной Path. Не добавляйте случайные каталоги. Сверьте расположение с npm config get prefix и официальной документацией npm для Windows.

Проверьте, установлен ли пакет:

Команда для этого шага: npm list -g @google/gemini-cli --depth=0.

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

При интерактивном запуске Gemini CLI может показывать варианты Google login, Gemini API key и Vertex AI. Однако старая страница авторизации может отставать от объявления 18 июня 2026 года. Для личных аккаунтов ориентируйтесь на официальное announcement: их запросы в Gemini CLI прекращены.

Для API key не вводите значение в чат и не записывайте в код. На Windows установите переменную только для текущего PowerShell-сеанса:

$env:GEMINI_API_KEY = "YOUR_KEY" gemini

Замените placeholder своим ключом локально. Не публикуйте скриншот терминала. После закрытия окна переменная исчезнет.

Для постоянной настройки лучше следовать политике вашей организации или использовать поддерживаемое хранилище секретов. Официальная документация также описывает .gemini/.env, но файл с ключом должен быть исключен из Git и иметь ограниченный доступ.

При Vertex AI потребуются проект, регион и подходящая аутентификация Google Cloud. Не копируйте конфигурацию service account из случайного примера. Корпоративные права должен выдать администратор по принципу минимальных привилегий.

Не запускайте Gemini CLI из C:\Users\ВашеИмя, потому что агент получит слишком широкую папку. Создайте тестовый каталог:

Команды по порядку: New-Item -ItemType Directory -Path "$env:USERPROFILE\gemini-cli-test", Set-Location "$env:USERPROFILE\gemini-cli-test" и git init.

Создайте минимальный index.html обычным редактором. Не храните в папке ключи и личные документы. Проверьте:

Команда для этого шага: git status.

Добавьте точный файл и baseline:

Команды по порядку: git add index.html, git diff --cached и git commit -m "initial test page".

Если Git просит имя и email, задайте их осознанно по официальной инструкции Git. Не копируйте чужие данные.

Из корня проекта выполните:

Команда для этого шага: gemini.

Первый запрос:

Проверьте, что агент видит именно тестовую папку и называет существующий файл. Не подтверждайте команду, если в ней указан другой путь.

После плана разрешите только одну правку:

Если агент предлагает shell-команду, прочитайте ее полностью. В Gemini CLI shell-команды имеют те же права, что и ваш PowerShell. Префикс AI не делает команду безопасной.

В другом окне PowerShell или после выхода выполните:

Команды по порядку: git status и git diff.

Откройте HTML в браузере. Проверьте текст, разметку, мобильную ширину и клавиатурную навигацию. Если агент создал неожиданный файл, откройте его отдельно. Не добавляйте все через git add ..

Если результат принят:

Команды по порядку: git add index.html, git diff --cached и git commit -m "add faq section".

Если нет, можно отменить только проверенное изменение через Git или вручную. Не используйте широкие destructive-команды, пока не поняли текущий status.

Ошибки авторизации нужно разделить.

• 401 часто означает отсутствующий или неверный credential.

• 403 может указывать на права проекта, регион, отключенный API или неподдерживаемый тип аккаунта.

• quota/rate limit означает ограничение учетной записи, а не поврежденную установку.

Сначала сверьте текущий способ доступа с announcement от 18 июня. Затем проверьте имя переменной, права ключа и выбранный Google Cloud project. Не публикуйте ключ в issue. В логах и скриншотах замажьте секреты.

Если личный Google login перестал работать, переходите на Antigravity CLI по официальной migration path. Создавать новый бесплатный аккаунт для обхода ограничения бессмысленно и может нарушать условия.

Для индивидуального пользователя это теперь основной путь терминальной работы Google. Официальное объявление содержит актуальные команды и migration guide. На Windows команда установки может меняться, поэтому ее лучше копировать непосредственно из текущей документации Antigravity, а не из статьи.

Не устанавливайте оба инструмента вслепую. Сначала определите, какой аккаунт и модель доступа у вас есть. Затем сохраните резервную копию проектных инструкций, проверьте новые разрешения и выполните read-only тест в отдельной папке.

Для npm-версии обновление stable выполняется через тот же пакет:

Команда для этого шага: npm install -g @google/gemini-cli@latest.

После обновления снова проверьте gemini --version и путь. Перед важной задачей прочитайте release notes: новый CLI может изменить команды, модели или подтверждения.

Удаление:

Команда для этого шага: npm uninstall -g @google/gemini-cli.

Это удаляет пакет, но не обязательно пользовательскую конфигурацию и credentials. Удаляйте их отдельно только после проверки точных путей. Если ключ больше не нужен, отзовите его у поставщика.

На корпоративном ноутбуке установка глобального npm-пакета может быть заблокирована. Не обходите policy запуском PowerShell от администратора или отключением защитного ПО. Запросите одобренный способ установки у администратора. Организация может выдавать Gemini Code Assist license, Google Cloud project и централизованные credentials.

Антивирус или endpoint protection может остановить дочерний процесс CLI. Сначала сохраните точное сообщение и путь бинарника. Не добавляйте всю папку пользователя в исключения. Если требуется exception, он должен быть узким и согласованным.

Проверьте, какую оболочку использует проект. Команды PowerShell, cmd и Git Bash различаются. Запрос агента должен учитывать вашу оболочку. Не подтверждайте Unix-команду удаления только потому, что она выглядит знакомо.

Если проект находится в OneDrive, синхронизация может конфликтовать с большим числом временных файлов и node_modules. Для учебного репозитория используйте обычную локальную папку, а исходники сохраняйте в Git. Не включайте node_modules в репозиторий.

При работе через WSL решите, где лежит проект и где установлен CLI. Windows-версия и Linux-версия внутри WSL имеют разные PATH и окружение. Не смешивайте их в одной инструкции. Для первого запуска выберите один контур, подтвердите Get-Location или pwd и только затем давайте агенту доступ к файлам.

Перед обращением в поддержку соберите безопасную диагностику: версию Windows, node --version, npm --version, gemini --version, путь из Get-Command gemini и точный текст ошибки без ключа. Укажите тип доступа, но не значение credential.

Если ошибка появилась после обновления, проверьте release notes и открытые issues. Не ставьте nightly как случайное исправление на рабочем компьютере. Воспроизведите проблему в тестовой папке и, если нужно, дождитесь стабильного релиза или используйте одобренную предыдущую версию по инструкции организации.

На курсе «Вайбкодинг на максималках» первый запуск CLI строится вокруг безопасной папки, Git, read-only плана и независимой проверки. Такой маршрут работает и при смене Gemini CLI на другой терминальный агент.

Установка Gemini CLI на Windows занимает несколько команд. Сложность 2026 года находится в выборе правильного доступа. Для API key и корпоративной лицензии установите stable пакет, проверьте PATH и начните в тестовом репозитории. Для личного бесплатного, Pro или Ultra аккаунта используйте актуальный путь Antigravity CLI.