Установить Gemini CLIПолное руководство 2025

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

✅ БЕСПЛАТНО: 1000 вызовов API в день (кредитная карта не требуется)

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

Перед установкой Gemini CLI убедитесь, что ваша система соответствует этим требованиям.

Node.js

Обязательно

18.0.0 или выше

Среда выполнения JavaScript, необходимая для установки NPM

NPM

Обязательно

8.0.0 или выше

Менеджер пакетов (поставляется с Node.js)

Git

Последняя версия

Система контроля версий (опционально, для сборки из исходников)

Аккаунт Google

Обязательно

Активный

Необходим для аутентификации API

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

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

📦

Установка NPM (Рекомендуется)

Установить глобально с помощью Node Package Manager

Легко
npm install -g @google/gemini-cli

Поддерживаемые платформы:

WindowsmacOSLinux
Посмотреть на NPM
⬇️

Прямое скачивание

Скачайте готовые бинарные файлы для вашей платформы

Легко
Скачать с релизов GitHub

Поддерживаемые платформы:

WindowsmacOSLinux
Скачать релизы
🔧

Сборка из исходников

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

Продвинутый
git clone && npm run build

Поддерживаемые платформы:

WindowsmacOSLinux
Посмотреть руководство по сборке

Пошаговая установка

Следуйте этим подробным шагам для установки Gemini CLI с помощью NPM (рекомендуемый метод).

1

Install Node.js and NPM

Download and install Node.js from the official website. NPM comes bundled with Node.js.

# Check if Node.js is installed
node --version
npm --version
2

Install Gemini CLI

Use NPM to install Gemini CLI globally on your system.

npm install -g @google/gemini-cli
3

Verify Installation

Check that Gemini CLI is installed correctly and accessible from your terminal.

gemini --version
gemini --help
4

Authenticate with Google

Run Gemini CLI and follow the authentication prompts, or set up your API key.

gemini
Or set API key:
export GEMINI_API_KEY="YOUR_API_KEY"

Test Your Installation

Run your first Gemini CLI command to ensure everything is working.

gemini
# Then in the interactive session:
> Hello, world!

Troubleshooting Common Issues

Having trouble with installation? Here are solutions to the most common problems.

⚠️

Ошибка отказа в доступе

Запустите с sudo на macOS/Linux или как Администратор на Windows

sudo npm install -g @google/gemini-cli
⚠️

Команда не найдена после установки

Добавьте глобальную bin-директорию NPM в ваш PATH

echo $PATH | grep npm
⚠️

Ошибка аутентификации

Настройте аутентификацию, запустив Gemini CLI или установив ваш API-ключ

export GEMINI_API_KEY="ВАШ_API_КЛЮЧ"
⚠️

Таймаут сети во время установки

Используйте другой реестр NPM или проверьте настройки брандмауэра

npm config set registry https://registry.npmjs.org/

Установка завершена! Что дальше?

Теперь, когда у вас установлен Gemini CLI, изучите эти следующие шаги, чтобы получить максимум от вашей настройки.

Заголовок

Проверено фактами
[1]🏛️Официальная документацияПроверено

Gemini CLI - Official GitHub Repository

Автор: Google Gemini Team
Организация: Google
Опубликовано: 2024年1月1日
Доступ: 2025年8月14日
Посмотреть источник
Проверено фактами
[2]🏛️Официальная документацияПроверено

Node.js Installation Guide

Организация: Node.js Foundation
Опубликовано: 2024年1月1日
Доступ: 2025年8月14日
Посмотреть источник
Проверено фактами

Отказ от ответственности за цитирование

Уведомление о товарных знаках

Google™, Gemini™ Google и Gemini являются товарными знаками Google LLC.

NPM® npm является товарным знаком npm, Inc.

Node.js® Node.js является товарным знаком OpenJS Foundation.

GitHub® GitHub является товарным знаком GitHub, Inc.

Все товарные знаки являются собственностью их соответствующих владельцев.