Gemini CLI

قم بإعداد Gemini CLI مع CometAPI: ثبّت عبر npm أو Homebrew، واضبط GEMINI_API_KEY و GOOGLE_GEMINI_BASE_URL، وابدأ باستخدام نماذج Gemini في الطرفية.

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

المراجع الرسمية:

• Gemini CLI GitHub
• Gemini CLI Authentication

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

​

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

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

​

الإعداد

1. تثبيت Gemini CLI

   npm install -g @google/gemini-cli
   

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

   brew install gemini-cli
   

   تحقّق:

   gemini --version
   
2. تعيين متغيرات البيئة

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

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

3. بدء 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 failed	قد تمنع قيود الشبكة الاتصال. جرّب استخدام proxy على مستوى النظام
إصدار Node.js غير صحيح	يتطلب Gemini CLI إصدار Node.js 22+‎. شغّل node --version للتحقق
إلغاء التثبيت	npm uninstall -g @google/gemini-cli