راهنمای یکپارچه‌سازی Gemini CLI

Google Gemini CLI را با کلید API در QCode.cc پیکربندی کنید — کلیدهای پرداختی سازمانی؛ سطح‌های Pro / مصرف‌کننده در 2026-06-18 از رده خارج شدند (QCode در حال حاضر Gemini را ارائه نمی‌دهد؛ فقط برای مرجع)

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

⚠️ در حال حاضر در دسترس نیست: QCode همه مدل‌های Gemini را به‌طور موقت از دسترس خارج کرده است، بنابراین مراحل زیر برای فراخوانی Gemini از طریق QCode فعلاً قابل استفاده نیستند و فقط برای مرجع نگه داشته شده‌اند؛ لطفاً به‌جای آن از Claude، GPT یا مدل‌های چینی استفاده کنید.

آخرین بررسی: 2026-09-18 · 📄 طبق مستندات رسمی (Gemini CLI v0.60.0 (2026-09-15؛ سرویس‌دهی به سطح‌های Pro/مصرف‌کننده از 2026-06-18 متوقف شد، کلیدهای پرداختی سازمانی ادامه دارند))

در یک نگاه¶

⚠️ تغییر مهم: مسیر ورود مصرف‌کننده با Google Antigravity CLI جایگزین شد. پست رسمی 2026-05-19 به‌صورت نقل‌قول مستقیم بیان می‌کند که از 2026-06-18، Gemini CLI و افزونه‌های IDE مربوط به Gemini Code Assist «سرویس‌دهی به درخواست‌ها را متوقف خواهند کرد» — برای Google AI Pro و Ultra، و برای افرادی که از آن به‌صورت رایگان با حساب کاربری شخصی استفاده می‌کنند. آنچه در آن روز در دسترس قرار گرفت Antigravity CLI و Antigravity 2.0 بود (خود IDE Antigravity زودتر، در 2025-11-18، عرضه شده بود). سازمانی وضعیت متفاوتی دارد: سازمان‌هایی که مجوز Gemini Code Assist Standard یا Enterprise دارند دسترسی خود را حفظ می‌کنند، و همان پست می‌گوید «Gemini CLI از طریق کلیدهای API پرداختی Gemini و Gemini Enterprise Agent Platform در دسترس باقی خواهد ماند». بنابراین این صفحه همچنان برای کلیدهای پرداختی سازمانی معتبر است؛ کاربران Pro / Ultra / رایگان باید به Google Antigravity CLI مهاجرت کنند.

مخزن بدون نگهداری نیست: در روز این بررسی (2026-09-18) هنوز یک بیلد شبانه منتشر می‌کرد، و آخرین انتشار پایدار v0.60.0 (2026-09-15) است. عبارت دقیق «سرویس‌دهی به ورودهای مصرف‌کننده را متوقف کرد» است، نه «نگهداری آن متوقف شد».

QCode.cc از Claude Code و OpenAI Codex پشتیبانی می‌کند که می‌توانند از همان کلید استفاده کنند. مراحل راه‌اندازی Gemini CLI در ادامه فقط برای مرجع نگه داشته شده‌اند، اما QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد.

Gemini CLI چیست¶

Gemini CLI دستیار برنامه‌نویسی هوش مصنوعی خط فرمان Google است، مشابه Claude Code، که در توسعه کد، اشکال‌زدایی و عملیات فایل در ترمینال به شما کمک می‌کند.

مدل‌های موجود¶

QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد. پرس‌وجوی زیر نشان می‌دهد که پس از ارائه دوباره آن‌ها، چگونه آن‌ها را فهرست کنید (فقط برای مرجع):

پرس‌وجوی زنده را مرجع بدانید — فهرست ثابتی را از هیچ سند، از جمله همین سند، کپی نکنید:

curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: cr_your_qcode_key"

شناسه‌هایی که برگردند، مدل‌های Gemini قابل فراخوانی هستند؛ یکی را در GEMINI_MODEL قرار دهید. کاتالوگ کامل و قیمت‌های زنده در qcode.cc/models قرار دارند.

یادداشت نسخه: از 2026-06-18، Gemini CLI دیگر به حساب‌های شخصی Pro / Ultra / رایگان سرویس‌دهی نمی‌کند — به Google Antigravity CLI مهاجرت کنید (Antigravity CLI و Antigravity 2.0 در 2026-05-19 در دسترس شدند)؛ کلیدهای پرداختی سازمانی تحت تأثیر نیستند و می‌توانند همچنان از Gemini CLI استفاده کنند.

نمای کلی پیکربندی¶

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:-default} به متغیرهای محیطی ارجاع دهند. مستندات بیان می‌کند که GOOGLE_GEMINI_BASE_URL برای احراز هویت gemini-api-key اعمال می‌شود، بنابراین هر دو متغیر را مطابق زیر تنظیم کنید.

# Update Homebrew
brew update

# Install 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 Configuration
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

# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Reload shell configuration
source ~/.bashrc

# Install latest LTS version
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 Configuration
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

# Using Chocolatey
choco install nodejs

# Or using 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"

# Set user-level environment variables (permanent)
[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

سازمانی ←