شرح Gemini CLI بالعربي: الإعداد مع مفتاح خبير

لتستخدم Gemini CLI مع خبير، ثبّت Gemini CLI، ثم ضع ثلاثة متغيرات في ملف ~/.gemini/.env: عنوان خبير الأساسي، ومفتاح API من خبير، ونموذجًا. اختر الدخول بمفتاح API، وشغّل gemini في مشروعك واكتب أي طلب، فيُدفع كل طلب من رصيدك في خبير. ومع الاشتراك يتولى تطبيق 5abeer AI هذا الإعداد عنك.

ما الذي تحصل عليه#

• Gemini CLI كما هو، بأوامره وإعداداته.
• نماذج Gemini التي تدعم صيغة Gemini في خبير، بأقل من سعرها الرسمي.
• استخدامك وتكلفته في لوحة التحكم، لكل مفتاح.

قبل أن تبدأ#

• طرفية على macOS أو Linux أو Windows.
• Node.js بالإصدار 20 أو أحدث، إذا ثبّت Gemini CLI بالأمر npm.
• مفتاح API لنماذج Gemini (أنشئ مفتاحًا).

مع اشتراك: تطبيق 5abeer AI#

إذا كان لديك اشتراك في خبير يشمل Gemini، فإن تطبيق 5abeer AI يضبط Gemini CLI على اشتراكك بنقرة واحدة، دون مفتاح API ودون أن تفتح أي ملف. يعمل التطبيق على Mac وWindows وLinux، والخطوات في كيف يعمل الاشتراك. أما بمفتاح API فاتبع الإعداد اليدوي أدناه.

الإعداد اليدوي#

1. 1

   ثبّت Gemini CLI#

   npmHomebrew

   انسخ

   npm install -g @google/gemini-cli

2. 2

   أضف الإعداد#

   يقرأ Gemini CLI ثلاثة متغيرات من ملف ~/.gemini/.env: المتغير GOOGLE_GEMINI_BASE_URL للعنوان الأساسي، وGEMINI_API_KEY لمفتاحك، وGEMINI_MODEL للنموذج. ضع فيه هذه القيم، واستبدل YOUR_5ABEER_API_KEY بمفتاحك:

   .envmacOS / LinuxWindows

   انسخ

   GOOGLE_GEMINI_BASE_URL=https://api.5abeer.ai
   GEMINI_API_KEY=YOUR_5ABEER_API_KEY
   GEMINI_MODEL=gemini-4-argon
   

   ~/.gemini/.env

3. 3

   اختر الدخول بمفتاح API#

   اجعل طريقة الدخول مفتاح API في ملف ~/.gemini/settings.json، أو اختر «Use Gemini API Key» عندما يسألك Gemini CLI في أول تشغيل:

   ~/.gemini/settings.jsonانسخ

   {
     "security": {
       "auth": {
         "selectedType": "gemini-api-key"
       }
     }
   }

4. 4

   شغّله#

   Terminalانسخ

   cd your-project
   gemini

   عند أول تشغيل في مجلد جديد قد يسألك Gemini CLI إن كنت تثق به؛ وافق ليقرأ ملف الإعداد. ثم اكتب أي طلب، فإذا وصلك الرد فالإعداد يعمل.

اختر النموذج#

يعمل في Gemini CLI كل نموذج يدعم صيغة Gemini في خبير. تعرض صفحة كل نموذج في قائمة النماذج الصيغ التي يدعمها؛ ضع معرّف النموذج في المتغير GEMINI_MODEL.

إذا ظهر خطأ#

• INVALID_API_KEY: المفتاح غير صحيح أو منسوخ ناقصًا.
• MODEL_PLATFORM_NOT_ALLOWED: المفتاح لمزوّد آخر غير Gemini.
• INSUFFICIENT_BALANCE: الرصيد لا يكفي لهذا الطلب.

كل الرموز ومعانيها في الأخطاء وحلولها.

أسئلة شائعة#

هل أحتاج إلى حساب Google؟#

لا. عند الدخول بمفتاح API يرسل Gemini CLI مفتاحك من خبير المحفوظ في GEMINI_API_KEY إلى عنوان خبير الأساسي، فلا تسجّل الدخول بحساب Google.

لماذا ما زال Gemini CLI يطلب تسجيل الدخول؟#

لأن طريقة الدخول لم تُضبط على مفتاح API بعد. أضف مقطع settings.json أعلاه، أو اختر «Use Gemini API Key» عندما يسألك، ثم شغّل gemini من جديد.

هل أستخدم نماذج Claude أو GPT في Gemini CLI؟#

لا. يتعامل Gemini CLI بصيغة Gemini فقط، فيشغّل النماذج التي تدعم هذه الصيغة في خبير، بمفتاح لنماذج Gemini.

كيف تُحسب تكلفة الطلب؟#

تُدفع تكلفة كل طلب من رصيدك حسب عدد التوكنات التي يستهلكها، بسعر النموذج في خبير. التفاصيل في الأسعار والرصيد.