استخدم Gemini CLI مع CometAPI

استخدم هذا الدليل لتشغيل Gemini CLI مع CometAPI كنقطة نهاية API. المراجع الرسمية:

يتغير توفر النماذج بمرور الوقت. راجع صفحة نماذج CometAPI للاطلاع على نماذج Gemini المتاحة.

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

المتطلب	التفاصيل
Node.js	22+ (يُوصى بإصدار LTS)
نظام التشغيل	macOS أو Linux أو Windows
مفتاح CometAPI	من لوحة تحكم CometAPI (يبدأ بـ `sk-`)

تثبيت Gemini CLI

npm install -g @google/gemini-cli

أو عبر Homebrew (macOS / Linux):

brew install gemini-cli

تحقّق:

gemini --version

تعيين متغيرات البيئة

export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

استبدل sk-your-cometapi-key بمفتاح CometAPI الفعلي الخاص بك.

بدء Gemini CLI

cd your-project
gemini

عند التشغيل لأول مرة، سيُطلب منك اختيار سمة، وتأكيد إشعار الأمان، ومنح الثقة لدليل العمل.

لتجنب إعادة التصدير في كل جلسة، أضف ما يلي إلى إعدادات shell الخاصة بك:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"

أعد تشغيل الطرفية لتطبيق التغييرات.

خطأ Invalid API Key

تحقّق من أن GEMINI_API_KEY تم تعيينه بشكل صحيح. شغّل echo $GEMINI_API_KEY للتحقق.

فشل fetch

قد تؤدي قيود الشبكة إلى حظر الاتصال. جرّب استخدام proxy على مستوى النظام.

إصدار Node.js غير صحيح

يتطلب Gemini CLI إصدار Node.js 22+‎. شغّل node --version للتحقق.

إلغاء تثبيت Gemini CLI

شغّل npm uninstall -g @google/gemini-cli.