> ## 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.

# استخدام Claude Desktop مع CometAPI

> استخدم هذا الدليل لإعداد Claude Desktop مع CometAPI من خلال تعيين base URL ومفتاح API وخيارات model أو provider.

استخدم هذا الدليل لربط Claude Desktop Cowork على third-party inference بـ CometAPI. يتيح هذا الإعداد لـ Claude Desktop إرسال طلبات Claude Messages API إلى CometAPI من خلال Cowork وProjects وسير العمل المكتبي المدعوم.

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

* [تثبيت Claude Desktop وإعداده](https://claude.com/docs/cowork/3p/installation)
* [إعداد gateway في Claude Desktop](https://claude.com/docs/cowork/3p/gateway)
* [مرجع إعداد Claude Desktop](https://claude.com/docs/cowork/3p/configuration)

<Note>
  يتطلب third-party inference في Claude Desktop بوابة متوافقة مع Anthropic. يدعم CometAPI نماذج Claude من خلال [Anthropic Messages API](/api/text/anthropic-messages).
</Note>

<Warning>
  تتم معالجة المحتوى الذي ترسله من Claude Desktop بواسطة CometAPI وموفر model المحدد. لا ترسل بيانات سرية ما لم تكن مؤسستك تسمح بسير العمل هذا.
</Warning>

## المتطلبات المسبقة

* تم تثبيت Claude Desktop من [claude.com/download](https://claude.com/download)
* إصدار من Claude Desktop يتضمن **Developer mode** و**Configure third-party inference**
* حساب CometAPI مع مفتاح API نشط
* إمكانية الوصول إلى نماذج Claude في CometAPI
* مسار شبكة يمكنه الوصول إلى `https://api.cometapi.com`

ابدأ من شاشة تسجيل الدخول في Claude Desktop. إذا كنت قد سجلت الدخول بالفعل باستخدام حساب Anthropic، فسجّل الخروج قبل إعداد third-party inference.

## الإعداد

<Steps>
  <Step title="تفعيل وضع المطور">
    افتح Claude Desktop وابقَ على شاشة تسجيل الدخول. من قائمة التطبيق، افتح **Help** → **Troubleshooting**، ثم اختر **Enable Developer Mode**.

    على Windows، قد يكون الوصول إلى القائمة صعبًا قبل تسجيل الدخول. حدّد حقل البريد الإلكتروني، واضغط `Tab` حتى يتم تحديد القائمة، ثم اضغط `Enter`.
  </Step>

  <Step title="فتح إعدادات inference التابعة لجهة خارجية">
    بعد تفعيل وضع المطور، افتح **Developer** → **Configure third-party inference**.

    تفتح نافذة الإعداد مع عدة أقسام في الشريط الجانبي الأيسر. استخدم قسم **Connection** لإعدادات CometAPI.
  </Step>

  <Step title="تكوين البوابة">
    في قسم **Connection**، أدخل قيم CometAPI التالية:

    | الحقل                     | القيمة                                           |
    | ------------------------- | ------------------------------------------------ |
    | موفر Inference            | Gateway                                          |
    | البوابة                   | Anthropic-compatible                             |
    | عنوان URL الأساسي للبوابة | `https://api.cometapi.com`                       |
    | مفتاح API للبوابة         | مفتاح API الخاص بـ CometAPI، مثل `$COMETAPI_KEY` |
    | مخطط مصادقة البوابة       | Bearer                                           |
    | رؤوس البوابة الإضافية     | اتركه فارغًا                                     |

    احتفظ بعنوان URL الأساسي كما هو موضح تمامًا. يتطلب Claude Desktop عنوان URL أساسيًا بنظام HTTPS.

    توضح لقطة الشاشة التالية قسم Connection بعد تعبئته بقيم CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-connection.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=879de5e2a4587861f220a7f6e0f7d2a5" alt="إعدادات Connection في Claude Desktop مع تعبئة عنوان URL الأساسي لبوابة CometAPI وحقل مفتاح API ومخطط مصادقة bearer" width="1800" height="1440" data-path="images/integrations/claude-desktop-cometapi-connection.png" />
  </Step>

  <Step title="إضافة model IDs">
    في **Model list**، أضف model IDs التالية يدويًا:

    | Model ID                    | الاستخدام الموصى به            |
    | --------------------------- | ------------------------------ |
    | `claude-opus-4-7`           | التخطيط المعقد ومهام الوكلاء   |
    | `claude-sonnet-4-6`         | الاستخدام العام على سطح المكتب |
    | `claude-haiku-4-5-20251001` | Prompts خفيفة ومسودات سريعة    |

    يصبح أول model في القائمة هو model الافتراضي. ضع `claude-sonnet-4-6` أولاً إذا كنت تريد افتراضيًا عامًا.

    <Tip>
      قد يتغير توفر model. إذا لم يظهر model في Claude Desktop بعد الإعداد، فتحقق من إمكانية الوصول في [صفحة Models الخاصة بـ CometAPI](/ar/overview/models).
    </Tip>

    توضح لقطة الشاشة التالية قائمة model مع تكوين model IDs الثلاثة الخاصة بـ Claude لاستخدام CometAPI.

    <img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-model-list.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=63dcdfe05db59c09782e1514e09a734d" alt="قائمة model في Claude Desktop تعرض claude-opus-4-7 وclaude-sonnet-4-6 وclaude-haiku-4-5-20251001 لـ CometAPI" width="1764" height="1278" data-path="images/integrations/claude-desktop-cometapi-model-list.png" />
  </Step>

  <Step title="تطبيق الإعداد محليًا">
    انقر على **Apply locally**. يكتب Claude Desktop الإعداد المحدد في ملف تعريف المستخدم المحلي ثم يعيد تشغيل التطبيق.

    إذا لم يُعد تشغيل التطبيق، فأغلق Claude Desktop بالكامل ثم افتحه مرة أخرى.
  </Step>

  <Step title="بدء جلسة Cowork">
    على شاشة تسجيل الدخول، اختر خيار Cowork على inference التابعة لجهة خارجية. افتح Cowork أو Projects، وحدد أحد نماذج Claude التي تم تكوينها، ثم أرسل Prompt اختبارية قصيرة.

    تؤكد الاستجابة الناجحة أن Claude Desktop يستخدم CometAPI لاستدعاءات model.
  </Step>
</Steps>

## التحقق من الإعداد

استخدم Prompt قصيرة لا تتطلب أدوات خارجية:

```text theme={null}
Reply with one sentence: Claude Desktop is connected through CometAPI.
```

إذا أعاد Claude Desktop استجابة، فهذا يعني أن عنوان URL الأساسي ومفتاح API وقائمة model قد تم تكوينها بشكل صحيح.

توضح لقطة الشاشة التالية رد Cowork ناجحًا عبر CometAPI.

<img src="https://mintcdn.com/cometapi/wsQpBp8rhXV0Hvh3/images/integrations/claude-desktop-cometapi-chat.png?fit=max&auto=format&n=wsQpBp8rhXV0Hvh3&q=85&s=93bb3b1a60de0d7edbd25cb6ba3b58d8" alt="رد Cowork في Claude Desktop باستخدام CometAPI بعد إعداد inference التابعة لجهة خارجية" width="2880" height="1600" data-path="images/integrations/claude-desktop-cometapi-chat.png" />

لفحص الإعدادات المكتشفة، افتح **Help** → **Troubleshooting** → **Copy Managed Configuration Report**. يتم حجب القيم السرية في التقرير المنسوخ.

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

<AccordionGroup>
  <Accordion title="لا تظهر قائمة المطور">
    تأكد من أنك اخترت **Help** → **Troubleshooting** → **Enable Developer Mode**. ثم أغلق Claude Desktop بالكامل وأعد فتحه مرة أخرى.

    إذا كان هذا الخيار غير موجود، فقم بتثبيت إصدار من Claude Desktop يتضمن إعدادات Inference من جهات خارجية.
  </Accordion>

  <Accordion title="يفتح Claude Desktop مسار تسجيل الدخول القياسي">
    تحقق من هذه العناصر:

    * تم تعيين **Inference provider** إلى **Gateway**.
    * قيمة **Gateway base URL** هي `https://api.cometapi.com`.
    * يحتوي **Gateway API key** على مفتاح CometAPI API الخاص بك بدون أي مسافات إضافية.
    * لقد نقرت على **Apply locally** وأعدت تشغيل Claude Desktop بالكامل.
  </Accordion>

  <Accordion title="يفشل التحقق من الاتصال">
    تأكد من أن base URL يبدأ بـ `https://`. لا يقبل Claude Desktop عناوين URL لبوابة HTTP العادية.

    تأكد أيضًا من أن حساب CometAPI الخاص بك لديه إمكانية الوصول إلى نماذج Claude، وأن مفتاح API لم يتم حذفه أو تعطيله.
  </Accordion>

  <Accordion title="لا تظهر النماذج التي تم تكوينها">
    أعد فتح **Developer** → **Configure third-party inference** وتحقق من إدخالات **Model list**. يجب أن تتطابق model ID مع المعرّفات التي يعرضها CometAPI.

    أضف كل model ID كإدخال منفصل. لا تدرج علامات اقتباس أو فواصل أو مسافات إضافية في حقول واجهة المستخدم.
  </Accordion>

  <Accordion title="عنوان base URL المتوافق مع OpenAI لا يعمل">
    يتوقع Claude Desktop third-party inference بوابة متوافقة مع Anthropic لهذا المسار. استخدم `https://api.cometapi.com` ومعرّفات نماذج Claude المذكورة أعلاه.
  </Accordion>

  <Accordion title="يتصرف تبويب Code بشكل مختلف">
    يستخدم تبويب Code محرك Claude Code داخل Claude Desktop. قد لا تُطبّق بعض إعدادات سطح المكتب على جلسات Code بالطريقة نفسها التي تُطبّق بها على Cowork.

    للاستخدام المستقل عبر الطرفية، راجع [دليل تكامل Claude Code](/ar/integrations/claude-code).
  </Accordion>
</AccordionGroup>