Настройка интеграции с Gemini

Настройка macOS¶

Шаг 1: Установка Node.js¶

Для работы Gemini CLI требуется среда Node.js.

Способ 1: Через Homebrew (рекомендуется)¶

Если Homebrew уже установлен, установка Node.js будет проще:

# Обновить Homebrew
brew update

# Установить Node.js
brew install node

Способ 2: Загрузка с официального сайта¶

1. Перейдите на https://nodejs.org/

2. Скачайте LTS-версию для macOS

3. Откройте загруженный файл .pkg

4. Следуйте инструкциям мастера установки

Примечания для macOS¶

• При проблемах с правами доступа может потребоваться sudo

• При первом запуске может потребоваться разрешение в системных настройках

• Рекомендуется использовать Terminal или iTerm2

Проверка установки Node.js¶

После установки откройте Terminal и выполните:

node --version
npm --version

Если отображаются номера версий — установка прошла успешно!

Шаг 2: Установка Gemini CLI¶

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

npm install -g @google/gemini-cli

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

gemini --version

Шаг 3: Настройка переменных окружения Gemini CLI¶

Установите переменные окружения для подключения к сервису:

Временная установка (текущая сессия)¶

Выполните в терминале:

export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ QCode.cc. Используйте тот же API-ключ, что и для Claude Code.

Постоянная установка (конфигурация оболочки)¶

Добавьте следующее в конфигурационный файл оболочки (~/.zshrc):

# Конфигурация Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Затем выполните:

source ~/.zshrc

Проверка переменных окружения Gemini CLI¶

Проверьте в терминале:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Настройка Linux / WSL2¶

Шаг 1: Установка Node.js¶

Для работы Gemini CLI требуется среда Node.js.

Способ 1: Через nvm (рекомендуется)¶

nvm позволяет удобно управлять несколькими версиями Node.js:

# Установить nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Перезагрузить конфигурацию оболочки
source ~/.bashrc

# Установить последнюю LTS-версию
nvm install --lts

Способ 2: Через пакетный менеджер¶

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm

Примечания для Linux / WSL2¶

• Пользователям WSL2 рекомендуется устанавливать в Linux-подсистеме, а не в Windows

• Использование nvm позволяет избежать проблем с правами доступа

• Убедитесь, что конфигурация оболочки корректно загружает nvm

Проверка установки Node.js¶

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

node --version
npm --version

Если отображаются номера версий — установка прошла успешно!

Шаг 2: Установка Gemini CLI¶

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

npm install -g @google/gemini-cli

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

gemini --version

Шаг 3: Настройка переменных окружения Gemini CLI¶

Установите переменные окружения для подключения к сервису:

Временная установка (текущая сессия)¶

Выполните в терминале:

export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ QCode.cc. Используйте тот же API-ключ, что и для Claude Code.

Постоянная установка (конфигурация оболочки)¶

Добавьте следующее в конфигурационный файл оболочки (~/.bashrc):

# Конфигурация Gemini CLI
export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Затем выполните:

source ~/.bashrc

Если вы используете Zsh, добавьте в ~/.zshrc и выполните source ~/.zshrc.

Проверка переменных окружения Gemini CLI¶

Проверьте в терминале:

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Настройка Windows¶

Шаг 1: Установка Node.js¶

Для работы Gemini CLI требуется среда Node.js.

Способ 1: Загрузка с официального сайта (рекомендуется)¶

1. Откройте браузер и перейдите на https://nodejs.org/

2. Нажмите на версию "LTS" для загрузки (рекомендуется версия с долгосрочной поддержкой)

3. По завершении загрузки дважды кликните на файл .msi

4. Следуйте мастеру установки, оставив настройки по умолчанию

Способ 2: Через пакетный менеджер¶

Если у вас установлен Chocolatey или Scoop:

# Через Chocolatey
choco install nodejs

# Или через Scoop
scoop install nodejs

Примечания для Windows¶

• Рекомендуется использовать PowerShell вместо CMD

• При проблемах с правами доступа попробуйте запустить от имени администратора

• Некоторые антивирусы могут давать ложные срабатывания — добавьте исключение

Проверка установки Node.js¶

После установки откройте PowerShell или CMD и выполните:

node --version
npm --version

Если отображаются номера версий — установка прошла успешно!

Шаг 2: Установка Gemini CLI¶

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

npm install -g @google/gemini-cli

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

gemini --version

Шаг 3: Настройка переменных окружения Gemini CLI¶

Установите переменные окружения для подключения к сервису:

Временная установка через PowerShell (текущая сессия)¶

Выполните в PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://asia.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ QCode.cc. Используйте тот же API-ключ, что и для Claude Code.

Постоянная установка через PowerShell (уровень пользователя)¶

Выполните в PowerShell:

# Установка переменных окружения на уровне пользователя (постоянно)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://asia.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [System.EnvironmentVariableTarget]::User)

После установки необходимо перезапустить окно PowerShell для применения изменений.

Проверка переменных окружения Gemini CLI¶

Проверьте в PowerShell:

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL