Примечание: В связи с ограничениями доступа к некоторым Google-сервисам из России, для полноценного использования Gemini CLI рекомендуется запускать его на удалённом сервере (VPS/VDS) за пределами страны. Например, вы можете арендовать виртуальный сервер на vdsina.com с размещением в Амстердаме или другом европейском дата-центре.
Ниже — подробное руководство по установке Gemini CLI как локально на Windows, так и на удаленном сервере.
Шаг 1: Установка Node.js
Это главный и единственный обязательный предварительный шаг.
Скачайте Node.js:
Перейдите на официальный сайт: https://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.
Добавить комментарий