الانتقال إلى المحتوى الرئيسي
استخدم هذا الدليل لربط Claude Desktop Cowork على الاستدلال عبر جهات خارجية بـ CometAPI. يتيح هذا الإعداد لـ Claude Desktop إرسال طلبات Claude Messages API إلى CometAPI من Cowork وProjects ومسارات عمل سطح المكتب المدعومة. المراجع الرسمية:
يتطلب الاستدلال عبر جهات خارجية في Claude Desktop بوابة متوافقة مع Anthropic. يدعم CometAPI نماذج Claude من خلال Anthropic Messages API.
تتم معالجة المحتوى الذي ترسله من Claude Desktop بواسطة CometAPI وموفر النموذج المحدد. لا ترسل بيانات سرية ما لم تسمح مؤسستك بمسار العمل هذا.

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

  • تثبيت Claude Desktop من claude.com/download
  • إصدار من Claude Desktop يتضمن Developer mode وConfigure third-party inference
  • حساب CometAPI مع مفتاح API نشط
  • الوصول إلى نماذج Claude في CometAPI
  • مسار شبكة يمكنه الوصول إلى https://api.cometapi.com
ابدأ من شاشة تسجيل الدخول في Claude Desktop. إذا كنت قد سجلت الدخول بالفعل باستخدام حساب Anthropic، فسجل الخروج قبل تهيئة الاستدلال عبر جهات خارجية.

​
التهيئة

1

تمكين وضع المطور

افتح Claude Desktop وابقَ على شاشة تسجيل الدخول. من قائمة التطبيق، افتح Help → Troubleshooting، ثم اختر Enable Developer Mode.في Windows، قد يصعب الوصول إلى القائمة قبل تسجيل الدخول. ضع التركيز على حقل البريد الإلكتروني، ثم اضغط Tab حتى يتم التركيز على القائمة، ثم اضغط Enter.
2

فتح إعدادات الاستدلال عبر جهات خارجية

بعد تمكين وضع المطور، افتح Developer → Configure third-party inference.تُفتح نافذة التهيئة وبها عدة أقسام في الشريط الجانبي الأيسر. استخدم قسم Connection لإعدادات CometAPI.
3

تهيئة البوابة

في قسم Connection، أدخل قيم CometAPI التالية:
الحقلالقيمة
موفر الاستدلالGateway
البوابةAnthropic-compatible
عنوان URL الأساسي للبوابةhttps://api.cometapi.com
مفتاح API للبوابةمفتاح API الخاص بـ CometAPI، مثل <COMETAPI_KEY>
مخطط مصادقة البوابةBearer
رؤوس إضافية للبوابةاتركه فارغًا
أبقِ عنوان URL الأساسي مطابقًا تمامًا كما هو موضح. يتطلب Claude Desktop عنوان URL أساسيًا باستخدام HTTPS.تعرض لقطة الشاشة التالية قسم Connection بعد تعبئته بقيم CometAPI.إعدادات Connection في Claude Desktop مع تعبئة عنوان URL الأساسي لبوابة CometAPI وحقل مفتاح API ومخطط مصادقة bearer
4

إضافة model ID

في Model list، أضف model ID التالية يدويًا:
Model IDالاستخدام الموصى به
claude-opus-4-7مهام التخطيط المعقدة والمهام الوكيلة
claude-sonnet-4-6الاستخدام العام على سطح المكتب
claude-haiku-4-5-20251001Prompts خفيفة ومسودات سريعة
يصبح أول نموذج في القائمة هو النموذج الافتراضي. ضع claude-sonnet-4-6 أولاً إذا كنت تريد افتراضيًا عامًا.
قد يتغير توفر النماذج. إذا لم يظهر نموذج في Claude Desktop بعد التهيئة، فتحقق من الوصول في صفحة نماذج CometAPI.
تعرض لقطة الشاشة التالية قائمة النماذج مع تهيئة model ID الثلاث الخاصة بـ Claude لـ CometAPI.قائمة نماذج Claude Desktop تعرض claude-opus-4-7 وclaude-sonnet-4-6 وclaude-haiku-4-5-20251001 لـ CometAPI
5

تطبيق التهيئة محليًا

انقر على Apply locally. يكتب Claude Desktop التهيئة المحددة إلى ملف تعريف المستخدم المحلي ويعيد تشغيل التطبيق.إذا لم يُعِد التطبيق التشغيل، فأغلق Claude Desktop بالكامل ثم افتحه مرة أخرى.
6

بدء جلسة Cowork

في شاشة تسجيل الدخول، اختر خيار Cowork على الاستدلال عبر جهات خارجية. افتح Cowork أو Projects، وحدد أحد نماذج Claude التي تمت تهيئتها، ثم أرسل Prompt اختبار قصيرًا.تؤكد الاستجابة الناجحة أن Claude Desktop يستخدم CometAPI لاستدعاءات النماذج.

​
التحقق من التهيئة

استخدم Prompt قصيرًا لا يتطلب أدوات خارجية: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
إذا أعاد Claude Desktop استجابة، فهذا يعني أن عنوان URL الأساسي ومفتاح API وقائمة النماذج تمت تهيئتها بشكل صحيح. تعرض لقطة الشاشة التالية رد Cowork ناجحًا عبر CometAPI. رد Cowork في Claude Desktop باستخدام CometAPI بعد إعداد الاستدلال عبر جهات خارجية لفحص الإعدادات المكتشفة، افتح Help → Troubleshooting → Copy Managed Configuration Report. تُحجب القيم السرية في التقرير المنسوخ.

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

تأكد من أنك اخترت Help → Troubleshooting → Enable Developer Mode. ثم أغلق Claude Desktop بالكامل وافتحه مرة أخرى.إذا كان الخيار غير موجود، فثبّت إصدارًا من Claude Desktop يتضمن تهيئة الاستدلال عبر جهات خارجية.
تحقق من هذه العناصر:
  • تم تعيين Inference provider إلى Gateway.
  • قيمة Gateway base URL هي https://api.cometapi.com.
  • يحتوي Gateway API key على مفتاح API الخاص بـ CometAPI بدون مسافات إضافية.
  • لقد نقرت على Apply locally وأعدت تشغيل Claude Desktop بالكامل.
تأكد من أن عنوان URL الأساسي يبدأ بـ https://. لا يقبل Claude Desktop عناوين URL لبوابة HTTP العادية.تأكد أيضًا من أن حساب CometAPI الخاص بك لديه وصول إلى نماذج Claude وأن مفتاح API لم يتم حذفه أو تعطيله.
أعد فتح Developer → Configure third-party inference وتحقق من إدخالات Model list. يجب أن تتطابق model ID مع المعرّفات التي يعرضها CometAPI.أضف كل model ID كإدخال منفصل. لا تُدرج علامات اقتباس أو فواصل أو مسافات إضافية في حقول واجهة المستخدم.
يتوقع الاستدلال عبر جهات خارجية في Claude Desktop بوابة متوافقة مع Anthropic لهذا المسار. استخدم https://api.cometapi.com وmodel ID الخاصة بـ Claude المذكورة أعلاه.
تستخدم علامة تبويب Code محرك Claude Code داخل Claude Desktop. قد لا تنطبق بعض إعدادات سطح المكتب على جلسات Code بالطريقة نفسها التي تنطبق بها على Cowork.للاستخدام المستقل عبر الطرفية، راجع دليل تكامل Claude Code.