إعداد Antigravity CLI (agy): مفتاح API (2026)

اضبط Google Antigravity CLI (agy) باستخدام مفتاح QCode.cc: عيّن modelProvider في settings.json، ثم وجّه GEMINI_API_KEY وGOOGLE_GEMINI_BASE_URL إلى نقطة نهاية Gemini لدى QCode

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

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

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

نظرة سريعة¶

⚠️ هل تنتقل من 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 سابقًا، فانتقل إلى هذه الصفحة.

Google Antigravity هو خليفة 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.

لاستخدام Claude أو GPT، استخدم عميلًا آخر — Claude Code، Codex CLI، Cline، Zed. أي بروتوكول يخدم أي نماذج موثّق في نقاط النهاية ومسارات API.

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

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

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

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

• مفتاح API من QCode.cc (يبدأ بـ cr_)، من لوحة التحكم
• الإلمام بـ نقاط النهاية ومسارات API

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

راجع وثائق التثبيت الرسمية:

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

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

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

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

تورد صفحة التثبيت الرسمية --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:

{
  "modelProvider": "gemini"
}

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

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

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

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

أضفهما إلى ~/.zshrc / ~/.bashrc ليبقيا محفوظين. على Windows 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.

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

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

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

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

# 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.

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

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

إدخال الرؤية مقابل توليد الصور¶

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

• إدخال الرؤية: أشِر إلى مسار ملف صورة في prompt، أو الصق / اسحب صورة إلى الداخل. تمتلك نماذج Gemini القدرة على الرؤية. الاستخدامات النموذجية: إعادة بناء واجهة مستخدم من تصميم، وتحديد خطأ من لقطة شاشة لخطأ، وقراءة مخطط معماري.

• توليد الصور: يتطلب نموذج gpt-image-2 المخصص على نقطة نهاية الصور لدى QCode — راجع توليد الصور عبر gpt-image-2.

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

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

• نقاط النهاية ومسارات API — جدول البروتوكول × عائلة النماذج
• تكامل Gemini CLI — الإصدار السابق (لا تزال مفاتيح المؤسسات تعمل)
• الوكلاء الفرعيون — تنسيق وكلاء الخلفية
• الأتمتة وCI/CD — الوضع بلا واجهة والبرمجة النصية

لا تملك مفتاح QCode بعد؟ مفتاح cr_ واحد يغطي Claude وGPT والنماذج الصينية ونماذج الصور (على بروتوكولات مختلفة — انظر الجدول أعلاه). راجع الأسعار للبدء.

المؤسسات ←