---
title: Gemini CLI | RunAPI
description: اضبط Gemini CLI لاستخدام واجهة Gemini الأصلية من RunAPI، وتحقق من الطلبات
  ثم استعد إعداداتك السابقة.
url: https://runapi.ai/ar/docs/resources/tool-integrations/gemini-cli.md
canonical: https://runapi.ai/ar/docs/resources/tool-integrations/gemini-cli
locale: ar
---

> نسخة HTML: https://runapi.ai/ar/docs/resources/tool-integrations/gemini-cli
> فهرس الموقع للوكلاء: https://runapi.ai/llms.txt

# Gemini CLI

## نظرة عامة

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

## قبل البدء

اتبع [دليل التثبيت الرسمي][1]. أنشئ مفتاح API قياسيًا مخصصًا باستخدام [دليل المصادقة](https://runapi.ai/ar/docs/guides/authentication.md)، ثم انسخ معرّف نموذج Gemini أصلي من [كتالوج النماذج](https://runapi.ai/ar/models). لا تحفظ مفتاحك مطلقًا في commit.

[1]: https://geminicli.com/docs/get-started/installation/

```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](https://runapi.ai/ar/docs/resources/mcp/local.md) للمصادقة والتحقق المنفصلين.

```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](https://runapi.ai/ar/docs/guides/llm-api/quickstart.md)، أو [Gemini generateContent](https://runapi.ai/ar/docs/api/gemini/generate-content.md)، أو [streamGenerateContent](https://runapi.ai/ar/docs/api/gemini/stream-generate-content.md)، أو [كتالوج النماذج](https://runapi.ai/ar/models)، أو [Local MCP](https://runapi.ai/ar/docs/resources/mcp/local.md).

---

## المزيد من RunAPI

- [الرئيسية](https://runapi.ai/ar/.md)
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models)
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [x402](https://runapi.ai/ar/x402.md)
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [فهرس الموقع للوكلاء](https://runapi.ai/llms.txt)

التواصل: contact@runapi.ai

## البيانات المنظمة

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "TechArticle",
    "headline": "Gemini CLI",
    "description": "اضبط Gemini CLI لاستخدام واجهة Gemini الأصلية من RunAPI، وتحقق من الطلبات ثم استعد إعداداتك السابقة.",
    "url": "https://runapi.ai/ar/docs/resources/tool-integrations/gemini-cli",
    "mainEntityOfPage": "https://runapi.ai/ar/docs/resources/tool-integrations/gemini-cli"
  }
]
```