Gemini CLI

نظرة عامة

النوع: أداة برمجةالمسار الرئيسي: 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 الخاص بك

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

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

مؤقت (الجلسة الحالية):

export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"

تكوين دائم: أضف إلى ملف تكوين الصدفة (shell) الخاص بك:

Bash
Zsh
Fish

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
source ~/.bashrc

echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
source ~/.zshrc

set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"

أعد تشغيل الجهاز الطرفي (terminal) بعد التكوين لتفعيل التغييرات.

قيد معروف: في بعض الحالات، قد لا يحترم Gemini CLI قيمة GOOGLE_GEMINI_BASE_URL إذا كانت هناك جلسة Google مخزنة مؤقتاً. إذا واجهت مشكلات في الاتصال، جرّب مسح ذاكرة التخزين المؤقت لـ CLI أو بدء جلسة terminal جديدة.

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

ابدأ Gemini CLI من دليل المشروع الخاص بك:

cd your-project
gemini

عند التشغيل الأول، ستقوم بـ:

اختيار سمة (theme)
تأكيد إشعار السلامة
الوثوق بدليل العمل

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

النموذج	الوصف
`gemini-2.5-pro`	أقوى نموذج Gemini
`gemini-3.5-flash`	سريع وفعال لمعظم المهام
`gemini-3.1-flash-lite`	نموذج Gemini خفيف حالي

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

طرح سؤال:

> 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 قراءة وتعديل الملفات.

مراجعة الكود المولد

راجع دائماً الكود المولد بواسطة الذكاء الاصطناعي قبل اعتماده في مشروعك.

مصفوفة التوافق

أدوات البرمجة

حِزم SDK الأصلية

الأطر والمنصات

تطبيقات الدردشة

نظرة عامة

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

التثبيت

التكوين

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

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

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

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

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

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

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

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

​نظرة عامة

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

​التثبيت

​التكوين

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

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

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

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

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

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

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

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

نظرة عامة

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

التثبيت

التكوين

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

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

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

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

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

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

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

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