دليل تكامل 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 وامتدادات Gemini Code Assist IDE عن «تلبية الطلبات» — بالنسبة إلى Google AI Pro وUltra، وإلى الأشخاص الذين يستخدمونه مجانًا بحساب شخصي. وما أصبح متاحًا في ذلك اليوم هو Antigravity CLI وAntigravity 2.0 (صدر Antigravity IDE نفسه في وقت سابق، في 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

المؤسسات ←