logo

Руководство по настройке Gemini CLI

Шаги установки

1. Установить Node.js

Посетите официальный сайт Node.js. Рекомендуется скачать версию LTS слева, это версия с долгосрочной поддержкой, более стабильная.

2. Установить Git

Посетите официальный сайт Git. Страница автоматически порекомендует версию, подходящую для вашей операционной системы; нажмите кнопку для скачивания.

3. Установить Gemini CLI

Откройте командную строку cmd и установите gemini-cli через npm:

npm install -g @google/gemini-cli

Шаги настройки

Конфигурация (.env)

Создайте файл конфигурации (Windows: %USERPROFILE%\.gemini\.env, Mac/Linux: ~/.gemini/.env)

GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=<LLMOXY_API_KEY>
GEMINI_MODEL=gemini-2.5-pro

Примечание: Для ключа API, пожалуйста, используйте токен из группы Gemini/Vertex.

Запуск

gemini

Подробные шаги настройки

1. Установить Gemini CLI

Откройте PowerShell и выполните:

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

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

gemini --version

Если команда gemini не найдена, попробуйте альтернативное имя пакета:

npm install -g @google/gemini-cli

Откройте Terminal (нажмите Command + Space, введите Terminal, нажмите Enter) и выполните:

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

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

gemini --version

Если команда gemini не найдена, попробуйте альтернативное имя пакета:

npm install -g @google/gemini-cli

Откройте Terminal и выполните:

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

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

gemini --version

Если команда gemini не найдена, попробуйте альтернативное имя пакета:

npm install -g @google/gemini-cli

2. Настроить Gemini CLI (подключение к LLMoxy)

Gemini CLI использует свой собственный каталог конфигурации; нет необходимости редактировать файлы конфигурации Shell.

Создать каталог конфигурации

mkdir -Force "$env:USERPROFILE\.gemini"

Записать файл конфигурации переменных среды

Создайте файл .env (пожалуйста, замените ключ API):

@"
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Ваш ключ API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\.env"

Опционально: записать конфигурацию аутентификации

@"
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
"@ | Out-File -Encoding utf8 "$env:USERPROFILE\.gemini\settings.json"

Каталог конфигурации находится в %USERPROFILE%\.gemini\ (обычно C:\Users\ВашеИмяПользователя\.gemini\).

Создать каталог конфигурации

mkdir -p ~/.gemini

Записать файл конфигурации переменных среды

Создайте файл .env (пожалуйста, замените ключ API):

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Ваш ключ API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Опционально: записать конфигурацию аутентификации

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Каталог конфигурации находится в ~/.gemini/ (то есть /Users/ВашеИмяПользователя/.gemini/).

Создать каталог конфигурации

mkdir -p ~/.gemini

Записать файл конфигурации переменных среды

Создайте файл .env (пожалуйста, замените ключ API):

cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://llmoxy.com
GEMINI_API_KEY=Ваш ключ API LLMoxy
GEMINI_MODEL=gemini-3.1-flash-image-preview-1
EOF

Опционально: записать конфигурацию аутентификации

cat > ~/.gemini/settings.json <<'EOF'
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}
EOF

Вы должны заменить Ваш ключ API LLMoxy на реальный ключ, скопированный из Консоли LLMoxy.

Пояснения элементов конфигурации:

  • GOOGLE_GEMINI_BASE_URL — Адрес шлюза LLMoxy
  • GEMINI_API_KEY — Ваш ключ API
  • GEMINI_MODEL — Модель по умолчанию (gemini-3.1-flash-image-preview-1 — последний флагман)

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

Ошибка прав npm install -g

Запустите PowerShell от имени администратора и повторите попытку.

Переустановите Node.js через Homebrew; установка через Homebrew не требует sudo.

Используйте nvm для управления Node.js (рекомендуется), или измените глобальный каталог npm: npm config set prefix ~/.npm-global, затем добавьте ~/.npm-global/bin в PATH.

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

  • Попробуйте альтернативный пакет: npm install -g @google/gemini-cli
  • Убедитесь, что Node.js установлен: node -v
  • Перезапустите терминал

Сбой вызова API

  • Проверьте, правильно ли содержимое файла конфигурации
  • Убедитесь, что ключ API не содержит лишних пробелов
  • Перейдите в Консоль LLMoxy для проверки баланса счета

Проблемы подключения к удаленному серверу (Linux)

  • Проверьте сеть: curl -I https://llmoxy.com
  • Если требуется прокси, добавьте в .env: HTTPS_PROXY=http://your-proxy:port
Инструкция по CC Switch
Руководство по настройке CodeX CLI