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

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

نظرة عامة

النوع: أداة برمجةالمسار الرئيسي: Gemini-nativeمستوى الدعم: توافق أفضل جهد
Google Gemini CLI هي أداة سطر أوامر للتفاعل مع نماذج Gemini. توفر TokenLab نقطة نهاية متوافقة تتيح لك استخدام Gemini CLI مع الوصول إلى مئات النماذج.
تعامل مع هذا التكامل على أنه تجريبي: لا يوثق Gemini CLI حاليًا مسارًا ثابتًا لاستخدام Base URL مخصص بأسلوب TokenLab. إذا كنت تحتاج إلى تكامل TokenLab مدعوم على الطرفية، فاختر 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. سجّل الدخول إلى لوحة تحكم TokenLab
  2. انتقل إلى مفاتيح API
  3. أنشئ وانسخ مفتاح API الخاص بك (التنسيق: sk-...)

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

مؤقت (الجلسة الحالية):
export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"
تكوين دائم: أضف إلى ملف تكوين الصدفة (shell) الخاص بك:
echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.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.tokenlab.sh
  • ملاحظة: لا تضف لاحقة /v1 لنقطة نهاية Gemini
  • تحقق من اتصال الشبكة
  • تحقق من تعيين متغير البيئة GEMINI_API_KEY
  • تأكد من أن المفتاح يبدأ بـ sk-
  • تأكد من أن المفتاح نشط في لوحة تحكم TokenLab
  • تحقق من توفر نماذج Gemini على tokenlab.sh/en/models
  • جرّب نسخة مختلفة من نموذج Gemini

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

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