# دليل تكامل Gemini CLI

> **⚠️ غير متاح حاليًا**: أوقف QCode جميع نماذج Gemini مؤقتًا، لذا لا يمكن استخدام الخطوات أدناه لاستدعاء Gemini عبر QCode في الوقت الحالي، وتُحفظ للرجوع فقط؛ يُرجى استخدام Claude أو GPT أو النماذج الصينية بدلًا من ذلك.

> **آخر تحقق**: 2026-09-18 · 📄 وفقًا للوثائق الرسمية (Gemini CLI v0.60.0 (2026-09-15؛ توقفت خدمة فئات Pro/المستهلكين في 2026-06-18، وتستمر مفاتيح المؤسسات المدفوعة))

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج المتاحة للاستخدام | Gemini (لا يوفّره QCode حاليًا؛ للرجوع فقط) · Claude ❌ · GPT ❌ · النماذج الصينية ❌ |
| البروتوكول وBase URL | Gemini: `https://api.qcode.cc/gemini` (يضيف CLI المسار `/v1beta/...` بنفسه — لا تضفه يدويًا) |
| مكان التهيئة | `~/.gemini/settings.json` أو متغير البيئة `GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY` |
| الوثائق الرسمية | [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |

> **⚠️ تغيير مهم: استُبدل مسار تسجيل دخول المستهلكين بـ 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](/docs/ide/antigravity).
>
> المستودع ليس بلا صيانة: في يوم هذا التحقق (2026-09-18) كان لا يزال ينشر بناءً ليليًا، وأحدث إصدار مستقر هو v0.60.0 (2026-09-15). الصياغة الدقيقة هي «**توقف تقديم تسجيلات دخول المستهلكين**»، وليس «توقف الصيانة».


يدعم QCode.cc كلاً من Claude Code وOpenAI Codex، ويمكن لكليهما استخدام المفتاح نفسه. تُحفظ خطوات تهيئة Gemini CLI أدناه للرجوع فقط، لكن QCode لا يوفّر نماذج Gemini في الوقت الحالي.
## ما هو Gemini CLI

[Gemini CLI](https://geminicli.com/) هو مساعد برمجة بالذكاء الاصطناعي من Google يعمل من سطر الأوامر، ويشبه Claude Code، ويساعدك في تطوير الشيفرة وتصحيح الأخطاء والعمليات على الملفات داخل الطرفية.

## النماذج المتاحة

لا تقدّم QCode نماذج Gemini في الوقت الحالي. يوضح الاستعلام أدناه كيفية عرضها عند إتاحتها مجددًا (للمرجع فقط):

**اعتمد الاستعلام المباشر بوصفه المرجع الموثوق** — لا تنسخ قائمة ثابتة من أي وثيقة،
بما في ذلك هذه الوثيقة:

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

أي معرّفات تُعاد هي نماذج Gemini التي يمكنك استدعاؤها؛ ضع أحدها في `GEMINI_MODEL`.
تجد الكتالوج الكامل والأسعار المباشرة على [qcode.cc/models](https://qcode.cc/models).

> **ملاحظة الإصدار**: اعتبارًا من 2026-06-18 لم يعد Gemini CLI يقدّم حسابات Pro / Ultra والحسابات الشخصية المجانية — انتقل إلى [Google Antigravity CLI](https://antigravity.google/) (أصبح 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، لذا عيّن كلا المتغيرين كما هو موضح أدناه.

<div data-os="macos" markdown="1">

## إعداد macOS

### الخطوة 1: تثبيت Node.js

يحتاج Gemini CLI إلى Node.js ليعمل.

#### الطريقة 1: استخدام Homebrew (موصى بها)

إذا كان Homebrew مثبتًا لديك، فاستخدمه لتثبيت Node.js:

```bash
# Update Homebrew
brew update

# Install Node.js
brew install node
```

#### الطريقة 2: التنزيل الرسمي

1. زُر [https://nodejs.org/](https://nodejs.org/)

2. نزّل إصدار LTS الخاص بـ macOS

3. افتح ملف `.pkg` الذي نزّلته

4. اتبع تعليمات المثبّت لإكمال التثبيت

#### ملاحظات macOS

- قد تحتاج إلى استخدام `sudo` إذا واجهت مشكلات في الأذونات

- قد يتطلب التشغيل الأول موافقة في تفضيلات النظام

- يُوصى باستخدام Terminal أو iTerm2

#### التحقق من تثبيت Node.js

بعد التثبيت، افتح Terminal ونفّذ:

```bash
node --version
npm --version
```

إذا ظهرت أرقام الإصدارات، فقد نجح التثبيت!

### الخطوة 2: تثبيت Gemini CLI

ثبّت Gemini CLI عالميًا باستخدام npm:

```bash
npm install -g @google/gemini-cli
```

بعد التثبيت، تحقق:

```bash
gemini --version
```

### الخطوة 3: إعداد متغيرات بيئة Gemini CLI

عيّن متغيرات البيئة التالية للاتصال بخدمة الوسيط:

#### إعداد مؤقت (الجلسة الحالية)

نفّذ الأوامر التالية في الطرفية:

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

> استبدل `cr_xxxxxxxxxx` بـ [مفتاح API الخاص بـ QCode.cc](https://qcode.cc/dashboard). استخدم مفتاح API نفسه الذي يستخدمه Claude Code.

#### إعداد دائم (إعداد الصدفة)

أضف ما يلي إلى ملف إعداد الصدفة لديك (`~/.zshrc`):

```bash
# 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"
```

ثم نفّذ:

```bash
source ~/.zshrc
```

### التحقق من متغيرات بيئة Gemini CLI

تحقق في الطرفية:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="linux" markdown="1">

## إعداد Linux / WSL2

### الخطوة 1: تثبيت Node.js

يتطلب Gemini CLI وجود Node.js لتشغيله.

#### الطريقة 1: استخدام nvm (موصى بها)

يسهّل nvm إدارة إصدارات Node.js المتعددة:

```bash
# 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
```

#### الطريقة 2: استخدام مدير الحزم

```bash
# 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

بعد التثبيت، افتح الطرفية ونفّذ:

```bash
node --version
npm --version
```

إذا ظهرت أرقام الإصدارات، فقد نجح التثبيت!

### الخطوة 2: تثبيت Gemini CLI

ثبّت Gemini CLI عالميًا باستخدام npm:

```bash
npm install -g @google/gemini-cli
```

بعد التثبيت، تحقق:

```bash
gemini --version
```

### الخطوة 3: إعداد متغيرات بيئة Gemini CLI

عيّن متغيرات البيئة التالية للاتصال بخدمة الوسيط:

#### إعداد مؤقت (الجلسة الحالية)

نفّذ الأوامر التالية في الطرفية:

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

> استبدل `cr_xxxxxxxxxx` بـ [مفتاح API الخاص بك في QCode.cc](https://qcode.cc/dashboard). استخدم مفتاح API نفسه المستخدم في Claude Code.

#### إعداد دائم (إعداد الصدفة)

أضف ما يلي إلى ملف إعداد الصدفة لديك (`~/.bashrc`):

```bash
# 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"
```

ثم نفّذ:

```bash
source ~/.bashrc
```

إذا كنت تستخدم Zsh، فأضف إلى `~/.zshrc` ونفّذ `source ~/.zshrc`.

### التحقق من متغيرات بيئة Gemini CLI

تحقق في الطرفية:

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="windows" markdown="1">

## إعداد Windows

### الخطوة 1: تثبيت Node.js

يتطلب Gemini CLI وجود Node.js لتشغيله.

#### الطريقة 1: التنزيل الرسمي (موصى بها)

1. افتح متصفحك وزُر [https://nodejs.org/](https://nodejs.org/)

2. انقر على إصدار «LTS» للتنزيل (موصى به للاستقرار)

3. انقر نقرًا مزدوجًا على ملف `.msi` الذي نزّلته

4. اتبع معالج التثبيت مع الإبقاء على الإعدادات الافتراضية

#### الطريقة 2: استخدام مدير الحزم

إذا كان Chocolatey أو Scoop مثبتًا لديك، فاستخدم سطر الأوامر:

```powershell
# Using Chocolatey
choco install nodejs

# Or using Scoop
scoop install nodejs
```

#### ملاحظات حول Windows

- يُوصى باستخدام PowerShell بدلًا من CMD

- شغّل كمسؤول إذا واجهت مشكلات في الأذونات

- قد تعتبره بعض برامج مكافحة الفيروسات مشبوهًا؛ أضفه إلى القائمة البيضاء إذا لزم الأمر

#### التحقق من تثبيت Node.js

بعد التثبيت، افتح PowerShell أو CMD ونفّذ:

```powershell
node --version
npm --version
```

إذا ظهرت أرقام الإصدارات، فقد نجح التثبيت!

### الخطوة 2: تثبيت Gemini CLI

ثبّت Gemini CLI عالميًا باستخدام npm:

```powershell
npm install -g @google/gemini-cli
```

بعد التثبيت، تحقق:

```powershell
gemini --version
```

### الخطوة 3: إعداد متغيرات بيئة Gemini CLI

عيّن متغيرات البيئة التالية للاتصال بخدمة الوسيط:

#### إعداد مؤقت في PowerShell (الجلسة الحالية)

نفّذ الأوامر التالية في PowerShell:

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

> استبدل `cr_xxxxxxxxxx` بـ [مفتاح API الخاص بك في QCode.cc](https://qcode.cc/dashboard). استخدم مفتاح API نفسه المستخدم في Claude Code.

#### إعداد دائم في PowerShell (مستوى المستخدم)

نفّذ الأوامر التالية في PowerShell:

```powershell
# 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)
```

> تحتاج إلى إعادة فتح PowerShell لكي تسري التغييرات.

### التحقق من متغيرات بيئة Gemini CLI

تحقق في PowerShell:

```powershell
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL
```

</div>
## استكشاف الأخطاء وإصلاحها

### إصدار 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. جرّب نقاط وصول أخرى:
   - آسيا: `https://asia.qcode.cc/gemini`

## الوثائق ذات الصلة

- [Antigravity CLI](/docs/ide/antigravity) - الخلف الرسمي لـ Gemini CLI
- [تهيئة البيئة](/docs/getting-started/environment) - إعداد Claude Code

- [تكامل Codex](/docs/ide/codex) - إعداد OpenAI Codex CLI

- [البدء السريع](/docs/getting-started/quick-start) - بدء العمل مع Claude Code