> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# استخدم Gemini CLI مع CometAPI

> استخدم هذا الدليل لتهيئة Gemini CLI باستخدام بيانات اعتماد CometAPI وإعدادات base URL ومعرّفات Gemini model ID.

استخدم هذا الدليل لتشغيل [Gemini CLI](https://github.com/google-gemini/gemini-cli) مع CometAPI كنقطة نهاية API.

المراجع الرسمية:

* [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
* [Gemini CLI Authentication](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx)

<Note>
  يتغير توفر النماذج بمرور الوقت. راجع [صفحة نماذج CometAPI](/ar/overview/models)
  للاطلاع على نماذج Gemini المتاحة.
</Note>

## المتطلبات الأساسية

| المتطلب        | التفاصيل                                                          |
| -------------- | ----------------------------------------------------------------- |
| Node.js        | 22+ (يُوصى بإصدار LTS)                                            |
| نظام التشغيل   | macOS أو Linux أو Windows                                         |
| مفتاح CometAPI | من [لوحة تحكم CometAPI](https://www.cometapi.com) (يبدأ بـ `sk-`) |

## الإعداد

<Steps>
  <Step title="تثبيت Gemini CLI">
    ```bash theme={null}
    npm install -g @google/gemini-cli
    ```

    أو عبر Homebrew (macOS / Linux):

    ```bash theme={null}
    brew install gemini-cli
    ```

    تحقّق:

    ```bash theme={null}
    gemini --version
    ```
  </Step>

  <Step title="تعيين متغيرات البيئة">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    استبدل `sk-your-cometapi-key` بمفتاح CometAPI الفعلي الخاص بك.
  </Step>

  <Step title="بدء Gemini CLI">
    ```bash theme={null}
    cd your-project
    gemini
    ```

    عند التشغيل لأول مرة، سيُطلب منك اختيار سمة، وتأكيد إشعار الأمان، ومنح الثقة لدليل العمل.
  </Step>
</Steps>

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

لتجنب إعادة التصدير في كل جلسة، أضف ما يلي إلى إعدادات shell الخاصة بك:

```bash theme={null}
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
```

أعد تشغيل الطرفية لتطبيق التغييرات.

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

<AccordionGroup>
  <Accordion title="خطأ Invalid API Key">
    تحقّق من أن `GEMINI_API_KEY` تم تعيينه بشكل صحيح. شغّل `echo $GEMINI_API_KEY` للتحقق.
  </Accordion>

  <Accordion title="فشل fetch">
    قد تؤدي قيود الشبكة إلى حظر الاتصال. جرّب استخدام proxy على مستوى النظام.
  </Accordion>

  <Accordion title="إصدار Node.js غير صحيح">
    يتطلب Gemini CLI إصدار Node.js 22+‎. شغّل `node --version` للتحقق.
  </Accordion>

  <Accordion title="إلغاء تثبيت Gemini CLI">
    شغّل `npm uninstall -g @google/gemini-cli`.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#howto",
        "name": "استخدام Gemini CLI مع CometAPI",
        "description": "استخدم هذا الدليل لتهيئة Gemini CLI باستخدام بيانات اعتماد CometAPI، وإعدادات base URL، وmodel ID الخاصة بـ Gemini.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "تثبيت Gemini CLI",
            "text": "أكمل خطوة تثبيت Gemini CLI في دليل استخدام Gemini CLI مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "تعيين متغيرات البيئة",
            "text": "أكمل خطوة تعيين متغيرات البيئة في دليل استخدام Gemini CLI مع CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "بدء Gemini CLI",
            "text": "أكمل خطوة بدء Gemini CLI في دليل استخدام Gemini CLI مع CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "مستندات CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "عمليات التكامل",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "استخدام Gemini CLI مع CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>