الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

النوع: أداة برمجةالمسار الرئيسي: Gemini-nativeمستوى الدعم: توافق Best-effort
Google Gemini CLI هي أداة سطر أوامر للتفاعل مع نماذج Gemini. توفر LemonData نقطة نهاية متوافقة تتيح لك استخدام Gemini CLI مع الوصول إلى أكثر من 300 نموذج.
تعامل مع هذا التكامل على أنه تجريبي: لا يوثق Gemini CLI حاليًا مسارًا ثابتًا لاستخدام Base URL مخصص بأسلوب LemonData. إذا كنت تحتاج إلى تكامل LemonData مدعوم على الطرفية، فاختر Codex CLI أو Claude Code أو OpenCode.

​
متطلبات النظام

  • Node.js: الإصدار 20.0+
  • نظام التشغيل: Windows 10/11، macOS 10.15+، Ubuntu 20.04+، أو Debian 10+

​
التثبيت

npm install -g @google/gemini-cli
التحقق من التثبيت: 
gemini --version

​
التكوين

​
الخطوة 1: احصل على مفتاح API الخاص بك

  1. سجّل الدخول إلى لوحة تحكم LemonData
  2. انتقل إلى مفاتيح API
  3. أنشئ وانسخ مفتاح API الخاص بك (التنسيق: sk-...)

​
الخطوة 2: تعيين متغيرات البيئة

مؤقت (الجلسة الحالية): 
export GEMINI_API_KEY="sk-your-lemondata-key"
export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"
تكوين دائم: أضف إلى ملف تكوين الصدفة (shell) الخاص بك: 
echo 'export GEMINI_API_KEY="sk-your-lemondata-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.lemondata.cc"' >> ~/.bashrc
source ~/.bashrc
أعد تشغيل الجهاز الطرفي (terminal) بعد التكوين لتفعيل التغييرات.
قيد معروف: في بعض الحالات، قد لا يحترم Gemini CLI قيمة GOOGLE_GEMINI_BASE_URL إذا كانت هناك جلسة Google مخزنة مؤقتاً. إذا واجهت مشكلات في الاتصال، جرّب مسح ذاكرة التخزين المؤقت لـ CLI أو بدء جلسة terminal جديدة.

​
الاستخدام الأساسي

ابدأ Gemini CLI من دليل المشروع الخاص بك: 
cd your-project
gemini
عند التشغيل الأول، ستقوم بـ:
  1. اختيار سمة (theme)
  2. تأكيد إشعار السلامة
  3. الوثوق بدليل العمل

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

النموذجالوصف
gemini-2.5-proأقوى نموذج Gemini
gemini-2.5-flashسريع وفعال لمعظم المهام
gemini-2.0-flashالجيل السابق، مستقر

​
الأوامر الشائعة

طرح سؤال: 
> What is the best way to structure a React app?
تحليل الكود: 
> Explain the code in src/main.ts
توليد الكود: 
> Create a Python function to parse JSON files
مراجعة التغييرات: 
> Review the recent git changes and suggest improvements

​
التحقق من التكوين

# التحقق من متغيرات البيئة
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# اختبار الاتصال
gemini

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

  • تحقق من أن GOOGLE_GEMINI_BASE_URL مضبوط على https://api.lemondata.cc
  • ملاحظة: لا تضف لاحقة /v1 لنقطة نهاية Gemini
  • تحقق من اتصال الشبكة
  • تحقق من تعيين متغير البيئة GEMINI_API_KEY
  • تأكد من أن المفتاح يبدأ بـ sk-
  • تأكد من أن المفتاح نشط في لوحة تحكم LemonData
  • تحقق من توفر نماذج Gemini على lemondata.cc/en/models
  • جرّب نسخة مختلفة من نموذج Gemini

​
أفضل الممارسات

قم دائماً بتشغيل Gemini CLI من جذر المشروع لفهم أفضل للسياق.
ثق فقط بالأدلة التي تملكها. يمكن لـ Gemini CLI قراءة وتعديل الملفات.
راجع دائماً الكود المولد بواسطة الذكاء الاصطناعي قبل اعتماده في مشروعك.