Примечание: В связи с ограничениями доступа к некоторым Google-сервисам из России, для полноценного использования Gemini CLI рекомендуется запускать его на удалённом сервере (VPS/VDS) за пределами страны. Например, вы можете арендовать виртуальный сервер на vdsina.com с размещением в Амстердаме или другом европейском дата-центре.

Ниже — подробное руководство по установке Gemini CLI как локально на Windows, так и на удаленном сервере.

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

Это главный и единственный обязательный предварительный шаг.

Скачайте Node.js:

Перейдите на официальный сайт: nodejs.org Скачайте версию LTS (Long-Term Support — рекомендуется для большинства пользователей). Она самая стабильная и поддерживаемая.

Установите Node.js:

Запустите скачанный

.msi

файл. Просто нажимайте "Next" на всех этапах установки. Установщик автоматически добавит

node

и

npm

в системную переменную PATH — это удобно и необходимо.

Проверьте установку:

Откройте новую командную строку (

cmd

) или PowerShell и выполните:

node -v

(Должна отобразиться версия, например,

v20.14.0

)

npm -v

(Должна отобразиться версия, например,

10.7.0

)

Если обе команды показывают версии, значит, Node.js установлен корректно, и вы готовы к установке Gemini CLI.

Шаг 2: Установка Gemini CLI

У вас есть два варианта установки. Рекомендуемый — глобальная установка.

Вариант А: Запуск без установки через npx

Этот способ хорош для тестирования: он загружает последнюю версию и сразу запускает её.

Откройте командную строку и выполните:

npx https://github.com/google-gemini/gemini-cli

⚠️ Примечание: если вы запускаете команду на локальной машине в России, могут возникнуть проблемы с доступом к API Google. Для стабильной работы рекомендуется использовать удалённый сервер (VDS).

Вариант Б: Глобальная установка (Рекомендуется)

Этот способ устанавливает gemini, как постоянную команду, которую можно вызывать из любой директории.

Откройте командную строку или PowerShell и выполните:

npm install -g @google/gemini-cli

Ключ

-g

означает "глобальная установка", после которой команда

gemini

будет доступна из любого места.

Шаг 3: Первая аутентификация

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

gemini

Выбор темы:

Сначала вас попросят выбрать цветовую схему интерфейса. Используйте стрелки клавиатуры и нажмите Enter для выбора.

Вход в аккаунт:

Откроется браузер по умолчанию, и вы будете перенаправлены на страницу входа в Google. Войдите в свой аккаунт.

Этот тип входа поддерживается если вы используете cloud google и к аккаунту привязана иностранная банковская карта.

Подтверждение доступа:

Подтвердите, что хотите разрешить приложению "Google Gemini CLI" доступ к вашему аккаунту.

После этого вы будете авторизованы. Этот метод даёт вам бесплатный доступ с лимитом до 60 запросов в минуту и 1000 запросов в день.

Шаг 4 (Рекомендуется): Использование API-ключа на Windows

Сгенерируйте ключ:

Зайдите в Google AI Studio и создайте проект, затем получите API-ключ. Это нужно делать с VDS или с иностранного ip.

Установите переменную окружения в Windows:

Откройте командную строку (cmd) или PowerShell и выполните:

setx GEMINI_API_KEY ваш_ключ

Вы увидите сообщение:

SUCCESS: Specified value was saved.

⚠️ Перезапустите терминал, чтобы переменная стала доступна.

Теперь Gemini CLI будет использовать этот ключ вместо авторизации через аккаунт.

🌐 Дополнительно: Работа через VDS (рекомендуется для пользователей из России)

Из-за блокировки некоторых доменов Google в России прямое использование Gemini CLI может быть затруднено или невозможно. Чтобы избежать проблем, используйте удалённый сервер (VDS), например, на vdsina.com с размещением в Амстердаме.

Полезные команды Gemini CLI

После установки и авторизации вы можете начать работать с проектами:

cd my-project/
gemini

Примеры запросов:

Напиши Discord-бота, который отвечает на вопросы из FAQ.md

Сделай презентацию из git-истории за последние 7 дней

Помоги перенести проект на Java 21, начни с плана

Заключение

Gemini CLI — мощный инструмент для работы с кодом и автоматизации задач. При использовании его на российских машинах могут возникнуть проблемы с доступом к сервисам Google. Чтобы избежать их, рекомендуется использовать удалённый сервер (VDS), например, на vdsina.com с размещением в Европе. Это позволит стабильно взаимодействовать с API Gemini и использовать все возможности CLI.