Содержание

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

Ниже — подробное руководство по установке и настройке окружения.

Шаг 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

⚠️ Обратите внимание: При запуске с российского IP-адреса серверы Google могут отклонить соединение из-за региональных ограничений самой компании. В этом случае используйте VDS.

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

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

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

npm install -g @google/gemini-cli

Ключ

-g

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

gemini

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

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

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

gemini

Выбор темы:

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

Авторизация:

CLI предложит открыть браузер для входа в Google-аккаунт. Данный метод авторизации (OAuth) работает корректно, если вы находитесь в поддерживаемом регионе или используете удаленный рабочий стол на зарубежном сервере.

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

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

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

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

Для стабильной работы лучше использовать прямой доступ по API-ключу, минуя браузерную авторизацию.

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

Зайдите в Google AI Studio и создайте проект, затем получите API-ключ. Примечание: Доступ к студии может требовать IP-адреса, отличного от российского (из-за политики Google). Создайте проект и скопируйте API Key.

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

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

setx GEMINI_API_KEY ваш_ключ

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

SUCCESS: Specified value was saved.

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

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

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

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

cd my-project/
gemini

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

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

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

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

Заключение

Gemini CLI — отличный инструмент для разработчиков. Несмотря на региональные ограничения со стороны Google, его можно комфортно использовать, применяя API-ключи и, при необходимости, удаленные серверы для хостинга ваших приложений.