تخطَّ إلى المحتوى
موارد المطورين
موارد المطورين

Gemini CLI

اضبط Gemini CLI لاستخدام واجهة Gemini الأصلية من RunAPI، وتحقق من الطلبات ثم استعد إعداداتك السابقة.

عرض Markdown

نظرة عامة

Gemini CLI وكيل يعمل في الطرفية. يغيّر هذا الدليل مزود النماذج إلى واجهة Gemini الأصلية من RunAPI؛ أما إضافة أدوات RunAPI عبر MCP فهي خطوة منفصلة.

قبل البدء

اتبع دليل التثبيت الرسمي. أنشئ مفتاح API قياسيًا مخصصًا باستخدام دليل المصادقة، ثم انسخ معرّف نموذج Gemini أصلي من كتالوج النماذج. لا تحفظ مفتاحك مطلقًا في commit.

SHELL 
npm install -g @google/gemini-cli

إعداد RunAPI

ابدأ بهذه المتغيرات في الطرفية الحالية. عنوان URL الأساسي هو جذر واجهة HTTPS دون /v1beta؛ يضيف SDK المسار POST /v1beta/models/{model}:streamGenerateContent?alt=sse. يُسمح باستخدام HTTP فقط مع localhost.

SHELL 
export GOOGLE_GEMINI_BASE_URL=https://runapi.ai
export GEMINI_API_KEY=YOUR_RUNAPI_API_KEY
export GEMINI_MODEL=YOUR_RUNAPI_MODEL_ID

للاستخدام المستمر، ضع المتغيرات الثلاثة نفسها في ~/.gemini/.env خارج مستودعاتك. قيّد الوصول باستخدام chmod 600 ~/.gemini/.env. يبحث Gemini CLI عن .env بدءًا من المجلد الحالي نحو المجلدات الأصل، ثم يتحقق من ~/.gemini/.env و~/.env؛ افحص الملفات المتعارضة.

ادمج هذين الإعدادين في ~/.gemini/settings.json مع الحفاظ على الإعدادات الأخرى. استخدم gemini-api-key للمصادقة بمفتاح API ولا تُعِد استخدام تسجيل دخول Google المخزن. يُرسل المفتاح عبر x-goog-api-key افتراضيًا.

JSON 
{
  "security": {
    "auth": {"selectedType": "gemini-api-key"}
  },
  "model": {"name": "YOUR_RUNAPI_MODEL_ID"}
}

اختر نموذجاً

استخدم GEMINI_MODEL أو --model YOUR_RUNAPI_MODEL_ID أو /model في جلسة تفاعلية. تجنب auto وpro وflash؛ فقد تتحول هذه الأسماء البديلة إلى معرّفات نماذج Google غير متوفرة في RunAPI. قد يطلب الاختيار الداخلي والتصنيف واكتشاف الحلقات نماذج مساعدة flash أو flash-lite أيضًا؛ تحقق من توفرها بصورة منفصلة.

تحقق

نفّذ هذا في مستودع تثق به. تحقق من النموذج باستخدام /about أو /stats في جلسة تفاعلية، ثم أكد وجود طلب streamGenerateContent مطابق في سجلات استخدام RunAPI. نجاح استجابة CLI وحده لا يثبت نقطة النهاية التي استقبلت الطلب.

SHELL 
gemini --version
gemini -p "Describe this repository in one sentence."

إضافة أدوات RunAPI

يضيف MCP أدوات وليس مزود نماذج. يسجّل هذا الأمر الخادم المحلي؛ اتبع Local MCP للمصادقة والتحقق المنفصلين.

SHELL 
gemini mcp add runapi npx -y @runapi.ai/mcp

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

إذا بقيت الطلبات متجهة إلى Google، تحقق من ملفات .env المتعارضة وsecurity.auth.selectedType وتسجيل الدخول المخزن ومتغيرات بيئة المصادقة Google/Vertex. إذا ظهر Invalid auth method selected، اختر gemini-api-key بدلًا من gateway في الإعدادات ثم أعد التشغيل.

عند ظهور 401، تحقق من المفتاح وأي تعديل على GEMINI_API_KEY_AUTH_MECHANISM؛ يُستخدم x-goog-api-key افتراضيًا. عند 404، احذف /v1beta من عنوان URL الأساسي وانسخ مجددًا معرّف نموذج يدعم Gemini الأصلي. إذا لم يتوفر نموذج مساعد، تحقق من المعرّف المطلوب بدقة؛ اختيار النموذج الرئيسي لا يضمن عمل جميع ميزات CLI.

لا توفر RunAPI عمليتي countTokens أو embedContent. يمكن أن يعود Gemini CLI إلى تقدير الرموز محليًا عند فشل countTokens؛ وقد تختلف التقديرات عن سجلات الاستخدام. استخدم HTTPS باستثناء localhost، ولا تعطّل التحقق من الشهادات.

إزالة RunAPI

احذف المتغيرات الثلاثة من الطرفية وملفات .env المحفوظة، واستعد security.auth.selectedType وإعداد النموذج السابقين، ثم ألغِ المفتاح المخصص في RunAPI. احذف خادم MCP المضاف بصورة منفصلة فقط إذا لم تعد تحتاج إلى أدواته.

SHELL 
unset GOOGLE_GEMINI_BASE_URL GEMINI_API_KEY GEMINI_MODEL

الخطوات التالية

تابع مع البدء السريع لواجهة LLM، أو Gemini generateContent، أو streamGenerateContent، أو كتالوج النماذج، أو Local MCP.