Руководство по установке

Установите и настройте Gemini CLI в вашей системе

Системные требования

Убедитесь, что ваша система соответствует этим требованиям

Windows

  • Windows 10 или новее
  • Node.js 18.0.0 или выше
  • PowerShell 5.1 или PowerShell Core 7+
  • Windows Terminal (рекомендуется)

macOS

  • macOS 10.15 (Catalina) или новее
  • Node.js 18.0.0 или выше
  • Инструменты командной строки Xcode
  • Terminal или iTerm2

Linux

  • Ubuntu 18.04+ / CentOS 8+ / Debian 10+
  • Node.js 18.0.0 или выше
  • curl или wget
  • оболочка bash или zsh

Методы установки

Выберите метод установки, который лучше всего подходит для ваших нужд

Установка NPM

Рекомендуемый метод для большинства пользователей

Шаг 1: Установить глобально через npm

Это устанавливает Gemini CLI глобально в вашей системе

npm install -g @google/generative-ai-cli

Шаг 2: Проверить установку

Убедитесь, что установка прошла успешно

gemini --version

Шаг 3: Настроить API ключ

Настройте ваш API ключ Google AI

gemini config set api-key YOUR_API_KEY

Установка Docker

Контейнеризованная среда для согласованного развертывания

Шаг 1: Загрузить Docker образ

Скачайте официальный Docker образ

docker pull google/gemini-cli:latest

Шаг 2: Запустить с API ключом

Запустите контейнер с вашим API ключом

docker run -e GEMINI_API_KEY=your_key google/gemini-cli:latest

Шаг 3: Интерактивный режим

Запустите интерактивную сессию чата

docker run -it -e GEMINI_API_KEY=your_key google/gemini-cli:latest chat

Из исходного кода

Сборка из исходного кода для разработки

Шаг 1: Клонировать репозиторий

Получите исходный код с GitHub

git clone https://github.com/google-gemini/gemini-cli.git

Шаг 2: Установить зависимости

Установите все необходимые зависимости

cd gemini-cli && npm install

Шаг 3: Собрать и связать

Соберите проект и создайте глобальную символическую ссылку

npm run build && npm link

Настройка API ключа

Настройте ваш API ключ Google AI для начала использования Gemini CLI

Получите ваш API ключ

  1. 1Посетите Google AI Studio
  2. 2Войдите с вашим аккаунтом Google
  3. 3Нажмите "Создать API ключ" и скопируйте ключ

Настроить ключ

Используя CLI команду:

gemini config set api-key YOUR_API_KEY

Используя переменную окружения:

export GEMINI_API_KEY=YOUR_API_KEY

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

Протестируйте вашу установку, чтобы убедиться, что все работает

Проверить версию

gemini --version

Должен отобразить номер установленной версии

Тест API соединения

gemini ask "Привет, вы меня слышите?"

Должен вернуть ответ от Gemini

Проверить конфигурацию

gemini config list

Должен показать ваши текущие настройки конфигурации

Распространенные проблемы

Решения распространенных проблем установки

Команда не найдена

Если вы получаете "команда не найдена" после установки, ваш PATH может не включать глобальную bin директорию npm.

npm config get prefix

Добавьте bin директорию в ваш PATH в профиле оболочки (.bashrc, .zshrc, и т.д.)

Доступ запрещен

На macOS/Linux вам может потребоваться использовать sudo или настроить npm для использования другой директории.

npm config set prefix ~/.npm-global

Затем добавьте ~/.npm-global/bin в ваш PATH

Следующие шаги

Теперь, когда Gemini CLI установлен, изучите эти ресурсы

Руководство по настройкеПримеры использованияУстранение неполадок