Настройка Gemini CLI

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

Последняя проверка: 2026-09-18 · 📄 По официальной документации (Gemini CLI v0.60.0 (2026-09-15; тарифы Pro/free не обслуживаются с 2026-06-18, корпоративные платные ключи продолжают))

Кратко¶

⚠️ Важное изменение: путь для личных аккаунтов заменён на Google Antigravity CLI. В официальном посте от 2026-05-19 дословно сказано, что с 2026-06-18 Gemini CLI и расширения Gemini Code Assist для IDE «will stop serving requests» — для Google AI Pro и Ultra, а также для тех, кто бесплатно пользуется им с личного аккаунта. Именно в тот день вышли Antigravity CLI и Antigravity 2.0 (сама IDE Antigravity появилась раньше, 2025-11-18). Для компаний всё иначе: организации с лицензией Gemini Code Assist Standard или Enterprise продолжают работу, и в том же посте указано «Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys». Поэтому эта страница по-прежнему актуальна для корпоративных платных ключей; пользователям Pro / Ultra / бесплатного тарифа стоит перейти на Google Antigravity CLI.

Репозиторий не заброшен: на день проверки (2026-09-18) там выходил nightly-билд, а последний стабильный релиз — v0.60.0 (2026-09-15). Корректная формулировка — «прекращено обслуживание личных аккаунтов», а не «сопровождение прекращено».

🚧 Ограниченная доступность: Ресурсы Gemini сейчас доступны в ограниченном режиме и пока не предоставляются массово. Если у вас значительные потребности в использовании, свяжитесь с нами через онлайн-чат или по email hi@qcode.cc — мы организуем для вас выделенные ресурсы Gemini.

QCode.cc поддерживает Claude Code, OpenAI Codex и Google Gemini CLI. После покупки тарифного плана все три инструмента используют общую квоту, что позволяет гибко выбирать инструмент.

Что такое Gemini CLI¶

Gemini CLI — это AI-ассистент для программирования от Google, работающий в командной строке. Аналогичен Claude Code и помогает писать код, отлаживать и работать с файлами прямо в терминале.

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

Источником истины считайте живой запрос — не копируйте фиксированный список из какого-либо документа, включая этот:

curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: cr_ваш_ключ_QCode"

Возвращённые идентификаторы — это модели Gemini, которые можно вызывать; подставьте один из них в GEMINI_MODEL. Полный каталог и актуальные цены — на qcode.cc/models.

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

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

• GOOGLE_GEMINI_BASE_URL — адрес сервиса

• GEMINI_API_KEY — API-ключ (тот же, что и для Claude Code)

• GEMINI_MODEL — выбор модели Файл настроек — второй поддерживаемый путь: пользовательский ~/.gemini/settings.json и проектный .gemini/settings.json (проект перекрывает пользователя). Модель задаётся в model.name, тип авторизации — в security.auth.selectedType; строковые значения могут ссылаться на переменные через $VAR, ${VAR} или ${VAR:-значение по умолчанию}. В документации сказано, что GOOGLE_GEMINI_BASE_URL относится к авторизации gemini-api-key, поэтому задавайте обе переменные, как показано ниже.

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

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

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

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

source ~/.zshrc

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

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

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

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

# 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

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"

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

source ~/.bashrc

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

# Через Chocolatey
choco install nodejs

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

node --version
npm --version

npm install -g @google/gemini-cli

gemini --version

$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"

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

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

Часто задаваемые вопросы¶

Устаревшая версия Node.js¶

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

Решение:

1. Проверьте версию Node.js: node --version

2. Официальное требование — Node.js 20.0.0 или выше (engines.node >=20.0.0; на 18 падает сразу после установки)

3. Обновите через nvm: nvm install --lts && nvm use --lts

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

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

Решение:

1. Убедитесь, что вы перезапустили терминал или выполнили команду source

2. Проверьте правильность имён переменных (учитывается регистр)

3. Проверьте формат API-ключа (должен начинаться с cr_)

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

Проблема: не удаётся подключиться к сервису QCode.cc

Решение:

1. Проверьте сетевое соединение

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

3. Попробуйте резервные узлы:

4. Резерв в Азии: https://asia.qcode.cc/gemini

Связанная документация¶

• Antigravity CLI — официальный преемник Gemini CLI

• Настройка переменных окружения — конфигурация Claude Code

• Интеграция с Codex — настройка OpenAI Codex CLI

• Быстрый старт — начало работы с Claude Code