دليل تكوين واجهة سطر الأوامر Gemini

📋 خطوات تحضيرية

قبل البدء، يرجى التأكد مما يلي:

إنشاء حساب Koze وتسجيل الدخول
إنشاء مفتاح API من صفحة إدارة API
تثبيت Gemini CLI (npm install -g @anthropic-ai/gemini-cli أو الرجوع إلى المستودع الرسمي)

🚀 الطريقة الأولى: الوصول عبر Gemini API (موصى بها)

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

# تعيين عنوان وكيل Koze Gemini export GOOGLE_GEMINI_BASE_URL='https://api.kozeai.com/gemini'

# تعيين مفتاح واجهة برمجة تطبيقات Koze
export GEMINI_API_KEY='مفتاح واجهة برمجة التطبيقات الخاص بك'

# تحديد النموذج المراد استخدامه
export GEMINI_MODEL='gemini-2.5-pro'

طريقة المصادقة:اختر استخدام مفتاح واجهة برمجة تطبيقات Gemini عند بدء التشغيل. إذا طُلب منك إدخال مفتاح API، اضغط على مفتاح الإدخال واتركه فارغًا. إذا تم توجيهك تلقائيًا إلى صفحة تسجيل الدخول إلى جوجل عند بدء التشغيل، فيُرجى حذف الملف ~/.gemini/settings.json وإعادة تشغيل الجهاز. الطريقة الثانية: الوصول عبر واجهة برمجة تطبيقات Code Assist طريقة وصول أخرى، مناسبة لبعض الحالات الخاصة: # إعداد نقطة نهاية Code Assist export CODE_ASSIST_ENDPOINT='https://api.kozeai.com/gemini' # إعداد رمز الوصول (باستخدام مفتاح Koze API الخاص بك) export GOOGLE_CLOUD_ACCESS_TOKEN='مفتاح API الخاص بك' # تفعيل وضع GCA export GOOGLE_GENAI_USE_GCA='true' # تحديد الطراز export GEMINI_MODEL='gemini-2.5-pro'

طريقة المصادقة:اختر تسجيل الدخول باستخدام عند بدء التشغيل Google.

⚠️ ملاحظة: قد تعرض وحدة تحكم Gemini CLI رسالة "فشل في جلب معلومات المستخدم: 401 غير مصرح به"، وهذا أمر طبيعي ولا يؤثر على الاستخدام.



🎯 الخطوة 3: تشغيل Gemini CLI

بعد الإعداد، قم بتشغيله في الطرفية:

gemini

📌 حفظ متغيرات البيئة

يُوصى بكتابة متغيرات البيئة في ملف إعدادات الصدفة (باستخدام الطريقة 1 كمثال):

# مستخدم Zsh

cat >> ~/.zshrc << < EOF <

export GOOGLE_GEMINI_BASE_URL=

export GEMINI_API_KEY=<مفتاح API الخاص بك

تصدير GEMINI_MODEL=

نهاية الملف مصدر ~/.zshrc



📌 الموديلات المتوفرة







اسم الموديل

الوصف








gemini-2.5-pro

Gemini 2.5 Pro، أحدث جيل من الموديلات عالية الأداء




gemini-2.5-flash

Gemini 2.5 Flash، أسرع وأكثر فعّال من حيث التكلفة




gemini-2.0-flash

Gemini 2.0 Flash







⚠️ الأسئلة الشائعة







المشكلة

الحل








إعادة التوجيه تلقائيًا إلى تسجيل الدخول إلى جوجل بعد بدء التشغيل

احذف ~/.gemini/settings.json وحاول مرة أخرى




يظهر خطأ 401 غير مصرح به

هذا هذا تنبيه عادي ولا يؤثر على الاستخدام؛ تجاهله.




الطراز غير متوفر

تحقق من ردهة طرازات Koze لمعرفة ما إذا كانت خطتك الحالية تشمل طرازات Gemini.

اسم الموديل	الوصف
`gemini-2.5-pro`	Gemini 2.5 Pro، أحدث جيل من الموديلات عالية الأداء
`gemini-2.5-flash`	Gemini 2.5 Flash، أسرع وأكثر فعّال من حيث التكلفة
`gemini-2.0-flash`	Gemini 2.0 Flash

المشكلة	الحل
إعادة التوجيه تلقائيًا إلى تسجيل الدخول إلى جوجل بعد بدء التشغيل	احذف `~/.gemini/settings.json` وحاول مرة أخرى
يظهر خطأ 401 غير مصرح به	هذا هذا تنبيه عادي ولا يؤثر على الاستخدام؛ تجاهله.
الطراز غير متوفر	تحقق من ردهة طرازات Koze لمعرفة ما إذا كانت خطتك الحالية تشمل طرازات Gemini.