Интеграция Gemini CLI с пользовательскими моделями CodingPlanX

Настройте Google Gemini CLI с использованием вашего API-ключа CodingPlanX.ai.

Руководство по интеграции Gemini CLI

CodingPlanX.ai поддерживает Claude Code, OpenAI Codex и Google Gemini CLI. После покупки плана эти три инструмента используют общую квоту плана, что позволяет вам гибко выбирать инструмент, который лучше всего подходит для вашего рабочего процесса.

Что такое Gemini CLI?

Gemini CLI — это ИИ-ассистент для программирования в командной строке, представленный Google. Подобно Claude Code, он помогает разрабатывать код, отлаживать и управлять файлами прямо в терминале.

Доступные модели

Вы можете получить доступ к следующим моделям Gemini через CodingPlanX.ai:

Модель	Описание
`gemini-3-pro-preview`	Последняя preview-версия (Рекомендуется)
`gemini-2.5-pro`	Стабильная версия

Последняя версия: Gemini CLI v0.33.1 (12.03.2026), включающая систему расширений, пользовательские темы и многое другое.

Обзор конфигурации

Для работы Gemini CLI необходимо задать следующие переменные окружения:

GOOGLE_GEMINI_BASE_URL - URL-адрес конечной точки сервиса
GEMINI_API_KEY - API-ключ (Такой же, как для Claude Code)
GEMINI_MODEL - Выбранная модель

Настройка для macOS

Шаг 1: Установка среды Node.js

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

Способ 1: Использование Homebrew (Рекомендуется)

Если у вас установлен Homebrew, это самый простой способ установить Node.js:

# Обновление Homebrew
brew update

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

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

Посетите https://nodejs.org/
Загрузите LTS-версию для macOS
Откройте загруженный файл .pkg
Следуйте инструкциям установщика

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

Если у вас возникнут проблемы с правами доступа, возможно, потребуется использовать sudo.
При первом запуске может потребоваться разрешение в Системных настройках.
Рекомендуется использовать Terminal или iTerm2.

Проверка установки 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://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai. Вы можете использовать тот же API-ключ, что и для Claude Code.

Постоянная настройка (Профиль оболочки)

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

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

Затем примените изменения:

source ~/.zshrc

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

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

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 следует устанавливать Node.js внутри подсистемы 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://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai.

Постоянная настройка (Профиль оболочки)

Добавьте следующее в ваш профиль оболочки (~/.bashrc):

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

Примените изменения:

source ~/.bashrc

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

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

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Настройка для Windows

Шаг 1: Установка среды Node.js

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

Посетите https://nodejs.org/
Нажмите на версию "LTS" для загрузки.
Запустите скачанный файл .msi.
Следуйте мастеру установки, оставив настройки по умолчанию.

Способ 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

npm install -g @google/gemini-cli

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

gemini --version

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

Временная настройка PowerShell (Текущий сеанс)

Выполните следующее в PowerShell:

$env:GOOGLE_GEMINI_BASE_URL = "https://api.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

Замените cr_xxxxxxxxxx на ваш API-ключ CodingPlanX.ai.

Постоянная настройка PowerShell (Уровень пользователя)

Выполните следующее в PowerShell:

# Установка переменных окружения на уровне пользователя (Постоянно)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [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, чтобы эти изменения вступили в силу.

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

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

Частые вопросы / Устранение неполадок

Версия Node.js слишком старая

Проблема: Gemini CLI сообщает, что версия Node.js несовместима.

Решение:

Проверьте вашу версию: node --version
Рекомендуется Node.js версии 18.x или выше.
Обновите с помощью nvm: nvm install --lts && nvm use --lts

Переменные окружения не применяются

Проблема: Не удается подключиться после настройки переменных окружения.

Решение:

Убедитесь, что вы перезапустили терминал или выполнили команду source.
Проверьте правильность написания имен переменных (с учетом регистра).
Проверьте формат вашего API-ключа (начинается с cr_).

Проблемы с сетевым подключением

Проблема: Не удается подключиться к сервисам CodingPlanX.ai.

Решение:

Проверьте подключение к интернету.
Убедитесь, что GOOGLE_GEMINI_BASE_URL задан правильно.