# إعداد Google Antigravity CLI

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

> **آخر تحقق**: 2026-09-18 · 📄 وفقًا للوثائق الرسمية (Antigravity CLI 1.2.x (بيان المحدّث التلقائي 1.2.6، تم التحقق في 2026-09))

## نظرة سريعة

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

> **⚠️ هل تنتقل من Gemini CLI؟** يقول المنشور الرسمي بتاريخ 2026-05-19، حرفيًا، إنه اعتبارًا من
> **2026-06-18** ستتوقف Gemini CLI وإضافات IDE من Gemini Code Assist «عن تلبية الطلبات» —
> بالنسبة إلى **Google AI Pro وUltra**، وإلى الأشخاص الذين يستخدمونه مجانًا عبر حساب شخصي.
> **مفاتيح المؤسسات المدفوعة غير متأثرة**: يذكر المنشور نفسه أن Gemini CLI يظل متاحًا عبر
> مفاتيح API المدفوعة لـ Gemini وGemini Enterprise Agent Platform. ما صدر في ذلك اليوم هو
> **Antigravity CLI وAntigravity 2.0**؛ أما Antigravity IDE نفسه فقد صدر سابقًا في
> **2025-11-18**. إذا كنت قد اتبعت [تكامل Gemini CLI](/docs/ide/gemini) سابقًا، فانتقل إلى هذه الصفحة.

[Google Antigravity](https://antigravity.google/) هو خليفة Google لـ Gemini CLI لعمليات
تسجيل الدخول الخاصة بالمستهلكين. يأتي
في ثلاثة أجزاء: IDE لسطح المكتب، و**Antigravity CLI (`agy`، مكتوب بلغة Go)**، وSDK.
تغطي هذه الصفحة CLI فقط: توجيهه إلى **QCode.cc**.
## 🔴 اقرأ هذا أولًا: بروتوكول Gemini فقط

نقطة النهاية المخصصة في Antigravity CLI **متوافقة مع Gemini**، وتُضبط عبر متغير البيئة
`GOOGLE_GEMINI_BASE_URL`. يذكر جدول استكشاف الأخطاء الرسمي، حرفيًا، أن
`gemini` هي «القيمة الوحيدة المقبولة» لـ `modelProvider` — لذا **لا يمكن لهذا المسار استخدام
نقطة نهاية متوافقة مع OpenAI**، وعبر QCode لا يمكنه تقديم سوى نماذج عائلة Gemini.

| العنصر | القيمة |
|---|---|
| ملف الإعدادات | `~/.gemini/antigravity-cli/settings.json` |
| حقل المفتاح | `"modelProvider": "gemini"` |
| بيانات الاعتماد | متغير البيئة `GEMINI_API_KEY` (مفتاح QCode `cr_` الخاص بك) |
| تجاوز نقطة النهاية | متغير البيئة `GOOGLE_GEMINI_BASE_URL` |
| المتغيرات التي يتجاهلها | كما توضح الوثائق الرسمية: agy **لا يحمّل ملفات `.env`**، و`GOOGLE_API_KEY` ليس له تأثير — تتم قراءة بيانات الاعتماد فقط من `GEMINI_API_KEY` في البيئة. Gemini CLI يحمّل `.env`، لذا يتصرف الاثنان بشكل معاكس؛ يواجه مستخدمو CI هذا مرة واحدة ولا ينسونه أبدًا |
| النماذج القابلة للاستخدام | عبر QCode: عائلة Gemini فقط |

> لاستخدام Claude أو GPT، استخدم عميلًا آخر — [Claude Code](/docs/getting-started/installation)،
> [Codex CLI](/docs/ide/codex)، [Cline](/docs/ide/cline)، [Zed](/docs/ide/zed).
> أي بروتوكول يخدم أي نماذج موثّق في
> [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

## 🔴 لا يمكن ربط Antigravity IDE (تطبيق سطح المكتب 2.0)

لا يوفّر **Antigravity IDE لسطح المكتب حاليًا أي آلية ربط رسمية لـ BYOK أو لمزوّد مخصص**، لذا
لا يمكن استبدال نموذج الوكيل المدمج فيه بنقطة نهاية من طرف ثالث. تلتف مشاريع المجتمع حول
هذا باستخدام وسيط اعتراضي محلي، لكن ذلك مسار هندسة عكسية بلا دعم رسمي، وهذه الصفحة
لا توصي به.

**الجزء الذي يتصل بـ QCode هو CLI (`agy`)، وليس IDE.**

## المتطلبات الأساسية

- مفتاح API من QCode.cc (يبدأ بـ `cr_`)، من [لوحة التحكم](https://qcode.cc/dashboard)
- الإلمام بـ [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths)

## الخطوة 1: تثبيت Antigravity CLI

راجع [وثائق التثبيت الرسمية](https://antigravity.google/docs/cli/install):

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

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
# installs to ~/.local/bin/agy
```

</div>

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

```bash
curl -fsSL https://antigravity.google/cli/install.sh | bash
# installs to ~/.local/bin/agy
```

</div>

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

PowerShell:

```powershell
irm https://antigravity.google/cli/install.ps1 | iex
# installs to C:\Users\<username>\AppData\Local\agy\bin
```

CMD:

```bat
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
```

</div>

تورد صفحة التثبيت الرسمية `--skip-aliases` و`--skip-path`، لكن ذلك سلوك **Windows**: يمرّر `install.ps1` / `install.cmd` الوسائط إلى `agy install`، بينما لا يقبل `install.sh` على macOS / Linux سوى `-d, --dir <path>` و`-h, --help` وينهي التنفيذ عند أي شيء آخر. لا تنسخ هذين الخيارين على macOS / Linux.
## الخطوة 2: التبديل إلى المصادقة بمفتاح API (تخطّي تسجيل الدخول عبر Google)

افتراضيًا، يقرأ `agy` مخزن مفاتيح نظام التشغيل لديك أو يفتح متصفحًا لتسجيل الدخول إلى حساب Google. لاستخدام
مفتاح API بدلًا من ذلك، حرّر (أو أنشئ) `~/.gemini/antigravity-cli/settings.json`:

```json
{
  "modelProvider": "gemini"
}
```

عند ضبط هذا، **يتخطّى `agy` شاشة تسجيل الدخول** ويفتح الواجهة الرئيسية مباشرةً، ويقرأ
متغير البيئة `GEMINI_API_KEY` بدلًا من ذلك.

> 🔴 إذا كان `"modelProvider": "gemini"` مضبوطًا لكن `GEMINI_API_KEY` مفقودًا، **فلن يبدأ CLI**. يجب توفرهما معًا.

## الخطوة 3: وجّه المفتاح ونقطة النهاية إلى QCode

```bash
export GEMINI_API_KEY="cr_your_qcode_key"
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
```

أضفهما إلى `~/.zshrc` / `~/.bashrc` ليبقيا محفوظين. على Windows PowerShell:

```powershell
$env:GEMINI_API_KEY = "cr_your_qcode_key"
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
```

**أوقف `GOOGLE_GEMINI_BASE_URL` عند `/gemini`** ولا تُدرج `/v1beta`: المثال الرسمي عنوان مجرّد
(`export GOOGLE_GEMINI_BASE_URL="https://your-endpoint.example.com"`)، ويضيف العميل مقطع
الإصدار ومسار الطلب بنفسه. agy عميل Go مغلق المصدر — لا توثّق Google قاعدة الدمج ولا ما إذا كانت
الشرطة المائلة اللاحقة `/` تُطبَّع (الـ SDK وراء Gemini CLI يزيل واحدة فعلًا)، لذا نتبع
الشكل الموثّق بدلًا من التخمين في الحالات الحدّية. هذا عكس مزوّد `google` في OpenCode (الذي يحتاج فعلًا إلى `/v1beta`)؛
ويُشرح الفرق في [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths).

**من البر الرئيسي للصين**، استبدل المضيف بـ `https://asia.qcode.cc/gemini` (عقدة آسيا، الأقرب بين كوريا / تايوان / هونغ كونغ)؛
المفتاح دون تغيير. تعمل `us` بالطريقة نفسها.

> عند المصادقة باستخدام `GEMINI_API_KEY`، لا يفعل `/logout` شيئًا — لا توجد جلسة مخزنة
> لمسحها.

## الخطوة 4: التحقق من الاتصال

اختبر نقطة نهاية Gemini الخاصة بـ QCode مباشرةً، متجاوزًا الأداة:

```bash
# List the Gemini models you can currently call
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: $GEMINI_API_KEY"

# Send a minimal request (use a model id from the list above)
curl -s "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "content-type: application/json" \
  -d '{"contents":[{"parts":[{"text":"ping"}]}],"generationConfig":{"maxOutputTokens":16}}'
```

- JSON يحتوي على `candidates` → نقطة النهاية والمفتاح كلاهما سليم
- **401** → المسار صحيح؛ المفتاح مفقود أو خاطئ

**اعتبر الاستعلام المباشر مرجعًا موثوقًا** لتحديد النماذج الموجودة — لا تنسخ قائمة ثابتة من أي
وثيقة، بما فيها هذه. المعرّفات التي يعيدها أول `curl` هي ما يمكن لنقطة نهاية QCode هذه تقديمه؛
الكتالوج الكامل والأسعار على [qcode.cc/models](https://qcode.cc/models).

ملاحظة تحذيرية: تستخدم لوحة `/model` في `agy` و`agy --model=...` **أسماء العرض الخاصة بالمنتجات** (على شكل
`Gemini 3.5 Flash`). لا توثّق Google كيفية ربط معرّف من API بمدخل في اللوحة عند تكوين نقطة نهاية مخصصة،
ولا ما إذا كانت تلك القائمة تأتي من نقطة النهاية لديك أساسًا. إذا كان نموذجك مفقودًا
من اللوحة، فلا توجد إرشادات رسمية إضافية — لم **نختبر** ذلك، لذا نصفه كما هو.

بعد أن تنجح نقطة النهاية في الفحص، أجرِ محادثة في `agy`.
## إدخال الرؤية مقابل توليد الصور

تستطيع أدوات مثل `agy` **قراءة الصور** — مرّر لها لقطة شاشة لواجهة مستخدم، أو لقطة شاشة لخطأ، أو مخططًا معماريًا، ودع النموذج يكتب الشيفرة أو يصلح الأخطاء انطلاقًا منها. هذا أمر مختلف عن **توليد** صورة:

- **إدخال الرؤية**: أشِر إلى مسار ملف صورة في prompt، أو الصق / اسحب صورة إلى الداخل.
  تمتلك نماذج Gemini القدرة على الرؤية. الاستخدامات النموذجية: إعادة بناء واجهة مستخدم من تصميم، وتحديد خطأ من
  لقطة شاشة لخطأ، وقراءة مخطط معماري.
- **توليد الصور**: يتطلب نموذج `gpt-image-2` المخصص على نقطة نهاية الصور لدى QCode —
  راجع [توليد الصور عبر gpt-image-2](/docs/usage/image-2).

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

| العارض | السبب المحتمل | الحل |
|---------|--------------|-----|
| لا يبدأ CLI | تم تعيين `modelProvider: "gemini"` لكن `GEMINI_API_KEY` مفقود | أضف متغيّر البيئة، أو أزل الحقل للعودة إلى تسجيل الدخول إلى الحساب |
| 401 | لم يُحقن المفتاح أو أنه خاطئ | تحقق من `GEMINI_API_KEY` — البادئة `cr_`، دون مسافات زائدة |
| 404 | يحمل `GOOGLE_GEMINI_BASE_URL` مقطعًا إضافيًا `/v1beta`، أو أن بادئة المسار خاطئة | توقّف عند `/gemini`، كما في المثال الرسمي؛ سلوك الشرطة المائلة اللاحقة غير موثّق |
| `model_not_available_on_endpoint` | طُلب نموذج Claude / GPT | تخدم نقطة النهاية Gemini فقط؛ غيّر العميل أو النموذج |
| خطأ في اسم النموذج | معرّف مسحوب أو مكتوب خطأً | استخدم `curl` الخاص بالخطوة 4 لسرد ما يمكن استدعاؤه فعليًا |
| بطء / انتهاء المهلة من الصين | استخدام النطاق الجذري `api` | بدّل إلى `https://asia.qcode.cc/gemini` |
| `/logout` لا يفعل شيئًا | مصادقتك تمت باستخدام مفتاح API | متوقّع — لا توجد جلسة لمسحها |

## الخطوات التالية

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths) — جدول البروتوكول × عائلة النماذج
- [تكامل Gemini CLI](/docs/ide/gemini) — الإصدار السابق (لا تزال مفاتيح المؤسسات تعمل)
- [الوكلاء الفرعيون](/docs/advanced/subagents) — تنسيق وكلاء الخلفية
- [الأتمتة وCI/CD](/docs/advanced/headless) — الوضع بلا واجهة والبرمجة النصية

> لا تملك مفتاح QCode بعد؟ مفتاح `cr_` واحد يغطي Claude وGPT والنماذج الصينية ونماذج الصور (على
> بروتوكولات مختلفة — انظر الجدول أعلاه). راجع [الأسعار](https://qcode.cc/pricing) للبدء.