# تكامل Chatbox: ربط QCode خطوة بخطوة


**الإجابة المختصرة**: في Chatbox افتح `Settings → Model Provider`، وأضف مزوّدًا مخصصًا بنوع `Claude API Compatible`، وضع `https://api.qcode.cc/api/v1` في `API Host`، والصق مفتاح `cr_`، ثم أضف معرّف النموذج `claude-sonnet-5`.

| البند | ما تملؤه |
|---|---|
| عنوان Claude API | `https://api.qcode.cc/api/v1` |
| API Path | `/messages` |
| عنوان OpenAI API | `https://api.qcode.cc/openai/v1` |
| مفتاح API | `cr_xxxxxxxx` |
| معرّف النموذج | `claude-sonnet-5` |

تم التحقق في 2026-11-21 · Chatbox 1.24.6 · Windows 11


اتبع اللقطات أدناه على جهاز يعمل بـ Windows، وستنتهي وقد أضفت QCode كمزوّد في Chatbox، ونموذج Claude محدد في نافذة المحادثة، وإجابة ظاهرة على الشاشة. ولا تحتاج إلى حساب Chatbox في أي مرحلة.


- **ينطبق على**: Windows 10 / 11 (64 بت)؛ أُخذت اللقطات على Windows 11
- **إصدار البرنامج**: Chatbox 1.24.6 (واجهة إنجليزية)
- **تاريخ تحديث اللقطات**: 2026-11
- **الوقت المطلوب**: نحو 15 دقيقة، معظمها في تنزيل مثبّت بحجم 230 MiB
- **ما تحتاج إليه**: مفتاح API من QCode يبدأ بـ `cr_`


قبل أول لقطة شاشة، تحقق من توفر ما يلي:


- جهاز كمبيوتر بنظام Windows 10 أو 11، بمعمارية 64 بت، ويستطيع فتح مواقع الويب
- نحو 1 GB من المساحة الحرة على القرص؛ ويعمل المثبّت تحت حساب المستخدم الخاص بك فلا يحتاج إلى كلمة مرور مسؤول
- مفتاح API من QCode منسوخ من لوحة التحكم (`cr_xxxxxxxx`)؛ المفتاح هو الشيء الوحيد الذي لا غنى عنه. ليس لديك حساب بعد؟ [أنشئ حسابًا](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-chatbox-before) أولًا، واختر خطة من [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_before&utm_campaign=knowledge_base&src=docs-ide-chatbox-before)، ثم أنشئ المفتاح في [لوحة التحكم](https://qcode.cc/ar/dashboard).
- لا حاجة إلى حساب Chatbox: فشاشة الترحيب فيها زر `Skip guide`، وكل شيء يُضبط محليًا


## تنزيل Chatbox وتثبيته

يوفّر Chatbox مثبّتًا واحدًا لنظام Windows. اختر الصف المطابق لمكانك:

**مناطق أخرى**

افتح **chatboxai.app/en/download**. تحت `Desktop App` يقول صف Windows `64-bit`؛ انقر زر `Download` فيه. وستحصل على `Chatbox-1.24.6-Setup.exe` بحجم نحو 230 MiB.

إذا لم تُفتح الصفحة، فاستخدم **GitHub Releases** (github.com/chatboxai/chatbox/releases): افتح قسم `Downloads` وانقر `Windows (x64)`. أحدث إصدار هناك هو v1.24.4، وهو أقدم من المثبّت الموجود على الموقع، ففضّل صفحة التنزيل.

![صفحة GitHub Releases: قائمة Downloads تضم رابط Windows (x64)، وأحدث إصدار هو v1.24.4، أقدم من مثبّت الموقع](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/03-github-releases.webp)


**البر الرئيسي للصين**

افتح **chatboxai.app/zh/download** وانقر `Download` في الصف الذي يقول `64-bit` تحت `Windows`. اسم الملف `Chatbox-1.24.6-Setup.exe` وحجمه نحو 230 MiB. والموقع الدولي (chatboxai.app/en/download) يقدّم المثبّت نفسه، فاستخدمه إذا كانت الصفحة الصينية بطيئة.




### فتح صفحة التنزيل

انتقل إلى **chatboxai.app/en/download**. تحت `Desktop App`، ① يقول صف Windows `64-bit`، و② `Download` هو الزر على يمينه. انقر ②.

![صفحة التنزيل الإنجليزية الرسمية: تحت Desktop App يقرأ صف Windows القيمة 64-bit وزر Download على اليمين مظلّل](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/01-download-page.webp)


إذا فعلتها بشكل صحيح فسترى: يبدأ متصفحك في تنزيل ملف باسم `Chatbox-1.24.6-Setup.exe`، بحجم نحو 230 MiB. وسيتغير رقم الإصدار في الاسم بمرور الوقت.




### التحقق من اكتمال التنزيل

افتح لوحة التنزيلات في متصفحك. ① يُظهر المثبّت المكتمل بحجمه الكامل.

![لوحة التنزيلات في المتصفح تُظهر ملف Chatbox-1.24.6-Setup.exe مكتملًا، بحجم نحو 230 MiB](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/02-download-done.webp)


إذا فعلتها بشكل صحيح فسترى: ① إدخالًا واحدًا مكتملًا باسم `Chatbox-1.24.6-Setup.exe` ودون شريط تقدّم. أما الإدخال الذي ينتهي بـ `.crdownload` فهو ما زال قيد التنزيل — انتظر حتى يتحول إلى اسم `.exe`.




### اختيار من سيُثبَّت له البرنامج

انقر نقرًا مزدوجًا على الملف الذي نزّلته. في الشاشة الأولى من المعالج، اختر ① `Only for me (user)` ثم انقر ② `Next >`.

![شاشة Chatbox Setup بعنوان Choose Installation Options: Only for me (user) محدد وزر Next مظلّل](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/04-installer-options.webp)

**تعثّرت؟ يسألك Windows عن كلمة مرور مسؤول**

مع تحديد `Only for me (user)` يكتب المثبّت في مجلد AppData الخاص بك ولا يحتاج إلى صلاحيات مسؤول. وإذا ظهرت نافذة طلب كلمة مرور فألغِها وابدأ المثبّت من جديد — ويجب أن تعرض الشاشة الأولى `Only for me (user)` محددًا.



إذا فعلتها بشكل صحيح فسترى: ① `Only for me (user)` محدد، وينتقل المعالج إلى `Choose Install Location`.




### الإبقاء على المجلد الافتراضي

تعرض الشاشة الثانية مكان وجود التطبيق، افتراضيًا تحت مجلد AppData الخاص بك. اتركه كما هو وانقر ① `Install`.

![شاشة Chatbox Setup بعنوان Choose Install Location بمجلد AppData الافتراضي للمستخدم وزر Install مظلّل](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/05-installer-location.webp)


إذا فعلتها بشكل صحيح فسترى: يختفي الزر وتتحول النافذة إلى `Please wait while Chatbox is being installed.`




### الانتظار حتى ينتهي شريط التقدّم

لا شيء لتنقره هنا. يمتلئ الشريط في نحو 20 ثانية على جهاز عادي.

![شاشة تقدّم Chatbox Setup مع شريط تقدّم التثبيت في منتصفه](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/06-installer-installing.webp)


إذا فعلتها بشكل صحيح فسترى: يصل الشريط إلى نهايته وتنتقل النافذة من تلقاء نفسها إلى `Completing Chatbox Setup`.




### تشغيل Chatbox

في الشاشة الأخيرة، أبقِ `Run Chatbox` محددًا وانقر ① `Finish`.

![شاشة Completing Chatbox Setup مع تحديد Run Chatbox وتظليل زر Finish](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/07-installer-finish.webp)


إذا فعلتها بشكل صحيح فسترى: يُغلق المعالج وتُفتح نافذة Chatbox من تلقاء نفسها.




### تجاوز شاشة الترحيب

عند أول تشغيل تُفتح شاشة ترحيب. لا تحتاج إلى حساب: اترك ① `I'm new to this` كما هو وانقر ② `Skip guide` على اليمين.

![شاشة الترحيب عند أول تشغيل: بطاقة I'm new to this على اليسار وبطاقة Skip guide على اليمين](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/08-first-run-welcome.webp)

**تعثّرت؟ لا يوجد Skip guide في شاشة الترحيب**

تأكد من أنك ثبّتت 1.24.6 أو أحدث: فشاشة الترحيب فيها بطاقتان في الأسفل، `I'm new to this` و`Skip guide`. وإذا لم ترَ أيًّا منهما فلم ينتهِ المثبّت — ارجع إلى شاشة المثبّت الأخيرة وانقر `Finish`.



إذا فعلتها بشكل صحيح فسترى: تختفي شاشة الترحيب وتظهر النافذة الرئيسية — قائمة محادثات على اليسار، ومربع رسالة في الأسفل، ودون أي مطالبة بتسجيل الدخول.




### فتح `Settings → Model Provider`

انقر `Settings` في أسفل يسار النافذة الرئيسية. في العمود الأيسر من صفحة الإعدادات انقر ① `Model Provider`؛ فتُفتح قائمة المزوّدين. وزر مزوّدك الخاص هو الصف الأخير: ② `+ Add`.

![صفحة الإعدادات: Model Provider محدد في العمود الأيسر و+ Add في أسفل قائمة المزوّدين](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/09-settings-model-provider.webp)

**تعثّرت؟ لا يوجد Model Provider في العمود الأيسر**

في Chatbox 1.24.6 يوجد هذا البند في العمود الأيسر من الإعدادات. وإذا لم تجده فتأكد من أنك داخل الإعدادات لا داخل محادثة: انقر `Settings` في أسفل يسار النافذة الرئيسية أولًا، ثم انظر في العمود الأيسر بحثًا عن الصفحة التي تسرد مزوّدين مثل OpenAI وClaude وGemini.



إذا فعلتها بشكل صحيح فسترى: ① `Model Provider` مظلّل في العمود الأيسر، وقائمة مزوّدين في الوسط، و② `+ Add` هو الصف الأخير في تلك القائمة.




### فتح نموذج المزوّد المخصص

انقر `+ Add`. تُفتح قائمة بالمزوّدين المعروفين؛ اكتب `custom` في مربع البحث فيه، ثم انقر ① `Add Custom Provider`.

![قائمة المزوّدين وقد كُتب custom في مربع البحث، فبقي Add Custom Provider النتيجة الوحيدة](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/10-add-provider-picker.webp)


إذا فعلتها بشكل صحيح فسترى: مربع حوار بعنوان `Add provider` فيه حقلان، `Name` و`API Mode`.




### اختيار نوع Claude API

افتح قائمة ① `API Mode` واختر `Claude API Compatible`. بهذا تطلب من Chatbox أن تتحدث بروتوكول Claude؛ وحقول العنوان في الخطوات التالية تعتمد على ذلك.

![مربع حوار Add provider والقائمة المنسدلة API Mode مفتوحة مع تظليل Claude API Compatible](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/11-add-provider-mode.webp)


إذا فعلتها بشكل صحيح فسترى: ① حقل `API Mode` يعرض الآن `Claude API Compatible`.




### تسمية المزوّد

اكتب `QCode Claude` في ① `Name`. وأبقِ ② `API Mode` على `Claude API Compatible`، ثم انقر `Add`.

![مربع حوار Add provider وقد كُتب الاسم QCode Claude وبقي API Mode على Claude API Compatible](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/12-add-provider-filled.webp)


إذا فعلتها بشكل صحيح فسترى: يُغلق مربع الحوار وتُفتح صفحة المزوّد الجديد بحقول `API Host` و`API Path` و`Preview`.




### ملء حقل Claude API Host

في ① `API Host` اكتب `https://api.qcode.cc/api/v1`. واترك `API Path` على `/messages`. ويجمع Chatbox الحقلين بنفسه: ② ينبغي أن يعرض `Preview` القيمة `https://api.qcode.cc/api/v1/messages`.

![صفحة المزوّد مع ضبط API Host على https://api.qcode.cc/api/v1 وسطر Preview يعرض https://api.qcode.cc/api/v1/messages](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/13-claude-api-host.webp)

**تعثّرت؟ تعرض Preview المسار /api/messages دون /v1**

لا يضيف Chatbox إلى مضيف Claude المخصص سوى `/messages` — فهو لا يضيف `/v1` كما يفعل مع `api.anthropic.com`، ولا يضيفه كما يفعله Cherry Studio. لذا ضع مقطع الإصدار في حقل Host نفسه: `https://api.qcode.cc/api/v1`. أما عنوان QCode العام لقاعدة Anthropic، `https://api.qcode.cc/api`، فهو لعملاء يضيف SDK الخاص بهم `/v1/messages` بنفسه.



إذا فعلتها بشكل صحيح فسترى: ① ينتهي بـ `/api/v1`، و② يعرض `https://api.qcode.cc/api/v1/messages`.




### لصق مفتاح API

انقر حقل `API Key` والصق المفتاح الذي نسخته من لوحة تحكم QCode. ولا يعرض الحقل سوى نقاط — وهذا طبيعي، فالمفتاح يُخزَّن كما كتبته.

![حقل API Key مملوء بمفتاح QCode مقنّع يظهر على شكل صف من النقاط](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/14-api-key-filled.webp)

**تحتاج مفتاح API؟**

إن لم يكن لديك حساب QCode بعد، [أنشئ حسابًا](https://qcode.cc/ar/auth/sign-up?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-chatbox-key) أولًا. وإذا كنت لا تريد خطة شهرية، فابدأ بشراء [باقات الدفع حسب الاستخدام](https://qcode.cc/ar/pay-as-you-go?utm_source=docs.qcode.cc&utm_medium=tut_key_step&utm_campaign=knowledge_base&src=docs-ide-chatbox-key) ثم أنشئ مفتاحك في [لوحة التحكم](https://qcode.cc/ar/dashboard). وانسخ السلسلة التي تبدأ بـ `cr_`. يمكنك الدفع ببطاقة الائتمان / الخصم (Visa / Mastercard)، أو Apple Pay / Google Pay، أو العملات المشفرة — راجع [طرق الدفع](/docs/reference/payment-methods).



إذا فعلتها بشكل صحيح فسترى: صفًا من النقاط في الحقل وقد اختفى النص النائب الرمادي. وإذا بقي الحقل فارغًا فانقر داخله مرة واحدة، وانتظر ثانية، ثم الصق من جديد — دون مسافة زائدة قبل المفتاح أو بعده.




### إضافة معرّف النموذج

انقر `+ New`. وفي نافذة `Edit Model` اكتب ① `claude-sonnet-5` في `Model ID`، ثم انقر ② `Save`. ولا يجلب Chatbox قائمة نماذج QCode، لذا يُكتب المعرّف يدويًا.

![نافذة Edit Model وقد كُتب claude-sonnet-5 في حقل Model ID وزر Save مظلّل](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/15-add-model.webp)

**تعثّرت؟ تبقى قائمة النماذج فارغة بعد التحديث**

لا يجلب المزوّد المخصص المتوافق مع Claude في Chatbox قائمة النماذج، فلا يصل شيء تلقائيًا. أضف المعرّف يدويًا، مثل `claude-sonnet-5` أو `claude-opus-5-5` أو `claude-haiku-5-5`؛ وكل معرّف يمكنك استخدامه مذكور على [qcode.cc/models](https://qcode.cc/ar/models). وانسخ المعرّف كما هو تمامًا، مع الشرطات.



إذا فعلتها بشكل صحيح فسترى: يصبح `claude-sonnet-5` صفًا في قائمة نماذج مزوّد `QCode Claude`.




### التحقق من الاتصال

انقر `Check`. وحين يسألك عن النموذج الذي تريد اختباره، اختر `claude-sonnet-5`. عندئذٍ يعرض ① `Model Test Results` النتيجة `Connection successful`، مع تحديد النص والرؤية واستخدام الأدوات كلها.

![نافذة Model Test Results تعرض Connection successful للنموذج claude-sonnet-5، مع تحديد النص والرؤية واستخدام الأدوات](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/16-check-result.webp)

**تعثّرت؟ يفشل Check ويظهر خطأ**

تحقق أولًا من الحقلين: يجب أن يكون `API Host` هو `https://api.qcode.cc/api/v1`، ويجب أن يعرض حقل `API Key` نقاطًا. ثم انقر `Check` مرة أخرى — فالسبب المعتاد تعثّر شبكة لمرة واحدة. وإذا ذكرت الرسالة النموذج، فتأكد من أن معرّفه `claude-sonnet-5` تمامًا.



إذا فعلتها بشكل صحيح فسترى: ① `Connection successful` باللون الأخضر، وعلامة صح بجانب كل من النص والرؤية واستخدام الأدوات.




### اختيار النموذج في نافذة المحادثة

أغلق الإعدادات وابدأ محادثة جديدة. افتح منتقي النموذج في أسفل اليمين، وبدّل القائمة إلى `More Providers (BYOK)`، وافتح ① `QCode Claude` وانقر ② `claude-sonnet-5`.

![منتقي النموذج في المحادثة مع مجموعة QCode Claude مفتوحة تحت More Providers (BYOK) وclaude-sonnet-5 مُدرج](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/19-model-picker.webp)


إذا فعلتها بشكل صحيح فسترى: منتقي النموذج في أسفل اليمين يعرض الآن `claude-sonnet-5` بدل أحد نماذج Chatbox الخاصة.




### إرسال أول رسالة

انقر مربع الرسالة، واكتب `Say hello in one short sentence` واضغط Enter. ① هو رسالتك في المحادثة.

![منطقة المحادثة مع الرسالة المرسلة Say hello in one short sentence والرد Hello! تحتها](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/20-first-reply.webp)

**تعثّرت؟ الإجابة خطأ أحمر بدل نص**

افتح منتقي النموذج وتأكد من أن النموذج `claude-sonnet-5` تحت `QCode Claude`، لا نموذج GPT تحت مزوّد OpenAI. فنماذج Claude لا تجيب إلا عبر مزوّد `Claude API Compatible` بعنوان `https://api.qcode.cc/api/v1`.



إذا فعلتها بشكل صحيح فسترى: ① رسالتك في المحادثة، وإجابة قصيرة مثل `Hello!` تحتها، وسطرًا صغيرًا أسفل الإجابة يعرض `claude-sonnet-5` وعدد الرموز.




### طرح سؤال متابعة

اكتب `Was that last sentence your own answer just now?` واضغط Enter. ① هو سؤال المتابعة؛ و② إجابة النموذج عليه.

![المحادثة نفسها مع سؤال المتابعة عن الجملة السابقة وإجابة النموذج تحته](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/21-followup-reply.webp)


إذا فعلتها بشكل صحيح فسترى: يشير النموذج إلى ما قاله في الدور السابق، فتحتفظ المحادثة بسياقها.




## التحقق من أن كل شيء يعمل

يكتمل إعدادك عندما تتحقق الأمور الأربعة كلها:

- في `Settings → Model Provider` يوجد مزوّد باسم `QCode Claude`، ونوع `API Mode` فيه `Claude API Compatible`، و`API Host` فيه `https://api.qcode.cc/api/v1`.
- يعرض سطر `Preview` في ذلك المزوّد `https://api.qcode.cc/api/v1/messages`، ويعرض حقل المفتاح صفًا من النقاط.
- يعرض `Check` في المزوّد `Connection successful` للنموذج `claude-sonnet-5`.
- أي رسالة تكتبها في محادثة جديدة تحصل على إجابة عادية، مع `claude-sonnet-5` وعدد الرموز أسفل الرد.

إذا أردت رؤية الطلبات نفسها، فافتح **probe.qcode.cc**، والصق المفتاح نفسه، وتحقق من حركة المرور التي تصل إلى QCode.


### انتهى كل شيء

أصبح QCode موصولًا بـ Chatbox وClaude يجيب في نافذة المحادثة. ومن هنا يمكنك:

- قارن بين الخطط على [صفحة الأسعار](https://qcode.cc/ar/pricing?utm_source=docs.qcode.cc&utm_medium=tut_done&utm_campaign=knowledge_base&src=docs-ide-chatbox-done) واختر الأنسب للاستخدام الطويل
- ارجع إلى [لوحة التحكم](https://qcode.cc/ar/dashboard) لمراجعة الاستخدام والرصيد
- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths)
- [النماذج الصينية](/docs/usage/cn-models)
- [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting)


## الأخطاء الشائعة

| نص الخطأ | السبب | ما العمل |
|---|---|---|
| `Fetch uses /models while API Path is /v1/chat/completions` | غاب مقطع الإصدار من `API Host`، فذهب طلب قائمة النماذج إلى مسار خاطئ | ضع الإصدار في Host: `https://api.qcode.cc/openai/v1`، وأبقِ `API Path` على `/chat/completions` |
| `API Error: Error from Custom Claude: TypeError: Load failed (api.example.com)` | لم يغادر الطلب التطبيق: تعذّر الوصول إلى المضيف المذكور في الرسالة، إما لأن العنوان خاطئ أو لأن الشبكة منعته | تحقق من التقسيم: `API Host` هو `https://api.qcode.cc/api/v1` و`API Path` هو `/messages`؛ ويجب أن يعرض `Preview` القيمة `https://api.qcode.cc/api/v1/messages`. وإذا استمر الفشل ففعّل `Improve Network Compatibility` |
| `API Error: Error from Claude: TypeError: Failed to fetch(192.168.1.206:8080)` | الطلب محجوب داخل التطبيق قبل أن يغادر جهازك، والسبب عادة قيد شبكي في WebView | في المزوّد المخصص فعّل `Improve Network Compatibility`، ثم تأكد من أن `API Host` هو `https://api.qcode.cc/api/v1` |
| `API Error: Error from Custom OpenAl: Network Error: Failed to fetch (api.firefllyai.chat)` | القيد الشبكي نفسه في مزوّد مخصص؛ والمضيف المذكور في الرسالة هو المضيف الذي كان مضبوطًا، لا مضيف QCode | فعّل `Improve Network Compatibility` لذلك المزوّد المخصص، ثم تحقق من أن `API Host` هو `https://api.qcode.cc/openai/v1` |

## الأسئلة الشائعة

### هل أحتاج إلى حساب في Chatbox؟

لا. Chatbox عميل محلي: انقر `Skip guide` في شاشة الترحيب، وأدخل عنوان QCode والمفتاح، وستكون جاهزًا. ولا شيء في هذا الدليل يحتاج إلى تسجيل دخول.

### لماذا ينتهي حقل Claude API Host بـ /v1؟

لأن Chatbox لا يضيفه. فمضيف Claude المخصص لا يُضاف إليه سوى `/messages`، لذا يتحول `https://api.qcode.cc/api` إلى `https://api.qcode.cc/api/messages` ويعيد 404. وعنوان QCode العام لقاعدة Anthropic، `https://api.qcode.cc/api`، مخصص لعملاء يضيف SDK الخاص بهم `/v1/messages` بنفسه — هكذا يعمل Cherry Studio، ولا يعمل Chatbox بهذه الطريقة.

### لماذا قائمة النماذج فارغة؟

لا يجلب المزوّد المخصص في Chatbox قائمة النماذج، فلا يظهر شيء تلقائيًا. أضف كل معرّف نموذج يدويًا عبر `+ New`، مثل `claude-sonnet-5` أو `claude-opus-5-5` أو `claude-haiku-5-5`؛ والقائمة الكاملة على [qcode.cc/models](https://qcode.cc/ar/models). وانسخ المعرّف كما هو تمامًا، مع الشرطات.

### هل يمكنني استخدام نماذج GPT في التطبيق نفسه؟

نعم. أضف مزوّدًا ثانيًا بنوع `OpenAI API Compatible`، و`API Host` هو `https://api.qcode.cc/openai/v1`، وبالمفتاح `cr_` نفسه، ومعرّف النموذج `gpt-6.2-sol`. والقسم الاختياري أدناه يشرح ذلك خطوة بخطوة. وبدّل النماذج من منتقي النموذج؛ فكل مزوّد يحتفظ بقائمة نماذجه الخاصة.

### انتهت صلاحية مفتاحي — هل يمكنني تجديده؟

يعتمد ذلك على مصدر المفتاح. مفتاح الخطة الشخصية الشهرية لا يمكن تجديده بعد انتهاء صلاحيته: افتح خطة جديدة وأنشئ مفتاحًا جديدًا في [لوحة التحكم](https://qcode.cc/ar/dashboard)، ثم الصق قيمة `cr_` الجديدة في حقل `API Key`. أما مفتاح باقة الدفع حسب الاستخدام فيعود للعمل عند شراء باقة أخرى، وهو المفتاح نفسه، فلا حاجة لتغيير أي شيء في Chatbox.

### هل يدعم Chatbox نماذج Gemini عبر QCode؟

لا. لا يوفّر QCode نماذج Gemini. استخدم نموذج Claude عبر `Claude API Compatible`، أو GPT والنماذج الصينية عبر `OpenAI API Compatible`.

## اختياري: استخدام نماذج GPT أيضًا

يقدّم QCode نماذج GPT والنماذج الصينية عبر بروتوكول OpenAI. والمزوّد في Chatbox يتحدث بروتوكولًا واحدًا، لذا فهذا مزوّد ثانٍ بالمفتاح نفسه. تخطَّ هذا القسم إن كان Claude كل ما تحتاج إليه.



### إضافة مزوّد متوافق مع OpenAI

افتح `Settings → Model Provider` مرة أخرى وانقر `+ Add`، ثم `Add Custom Provider`. سمّه `QCode OpenAI`، واضبط `API Mode` على `OpenAI API Compatible`، وضع `https://api.qcode.cc/openai/v1` في ① `API Host` — مع مقطع الإصدار مرة أخرى، لأن هذا النوع لا يضيفه هو أيضًا. وينبغي أن يعرض ② `Preview` القيمة `https://api.qcode.cc/openai/v1/chat/completions`. الصق المفتاح نفسه، ثم أضف معرّف النموذج `gpt-6.2-sol`؛ و③ يعرضه في قائمة النماذج.

![المزوّد الثاني QCode OpenAI: API Host مضبوط على https://api.qcode.cc/openai/v1، وPreview يعرض /openai/v1/chat/completions وgpt-6.2-sol في قائمة النماذج](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/17-openai-provider.webp)

**تعثّرت؟ نماذج Claude لا تجيب هنا**

لا يستطيع المزوّد المتوافق مع OpenAI خدمة نماذج Claude. أبقِ Claude على مزوّد `QCode Claude` بعنوان `https://api.qcode.cc/api/v1`، واستخدم هذا المزوّد الثاني لنماذج GPT والنماذج الصينية فقط.



إذا فعلتها بشكل صحيح فسترى: ① ينتهي بـ `/openai/v1`، و② ينتهي بـ `/openai/v1/chat/completions`، و③ يسرد `gpt-6.2-sol` في قائمة نماذج `QCode OpenAI`.




### التحقق من اتصال GPT

انقر `Check`، واختر `gpt-6.2-sol` حين يُطلب منك ذلك، وانتظر ① `Model Test Results`.

![نتائج Model Test Results لمزوّد QCode OpenAI: gpt-6.2-sol يعرض Connection successful](https://docs.qcode.cc/static/images/tut/chatbox/202611/en/18-openai-check-result.webp)


إذا فعلتها بشكل صحيح فسترى: ① `Connection successful` للنموذج `gpt-6.2-sol`، أي أن المفتاح نفسه يعمل مع المزوّدين كليهما.




## أنواع المزوّد وعناوين QCode

يحدد Chatbox البروتوكول حسب `API Mode`، ثم يضيف `API Path` إلى `API Host`. والتعيين كالتالي:

| نوع API Mode | API Host الذي تدخله | API Path | ما يعرضه Preview | النماذج التي تعمل |
|---|---|---|---|---|
| `Claude API Compatible` | `https://api.qcode.cc/api/v1` | `/messages` | `https://api.qcode.cc/api/v1/messages` | Claude؛ والنماذج الصينية تجيب أيضًا على نقطة النهاية هذه |
| `OpenAI API Compatible` | `https://api.qcode.cc/openai/v1` | `/chat/completions` | `https://api.qcode.cc/openai/v1/chat/completions` | GPT والنماذج الصينية — لا Claude |
| `Google Gemini API Compatible` | لا يوفّر QCode خدمة Gemini | — | — | لا شيء |

- **نقطتا وصول إضافيتان**: `asia.qcode.cc` و`us.qcode.cc` تقبلان المسارات نفسها والمفاتيح نفسها — استبدل `api.qcode.cc` واترك الباقي كما هو، بما في ذلك `/api/v1` أو `/openai/v1`. جرّبهما إن كان المضيف الافتراضي بطيئًا من شبكتك.
- **مقطع `/v1` مكانه في Host.** فChatbox يضيف Path فقط، لذا ينتهي مضيفا QCode أعلاه بمقطع الإصدار. وهذه هي النقطة الوحيدة التي يختلف فيها Chatbox عن عملاء مثل Cherry Studio، حيث يضيف SDK الخاص بهم `/v1/messages` إلى عنوان QCode العام لقاعدة Anthropic `https://api.qcode.cc/api`.
- **`Preview` أسرع فحص.** فهو يعرض العنوان الدقيق الذي سيناديه Chatbox؛ وإذا كان يعرض `/api/messages` أو `/openai/chat/completions` فمقطع الإصدار غائب من Host.

## النماذج التي يمكنك استخدامها

- **Claude** — عبر `Claude API Compatible`، مثل `claude-sonnet-5`، `claude-opus-5-5`، `claude-haiku-5-5`
- **GPT** — عبر `OpenAI API Compatible`، مثل `gpt-6.2-sol`، `gpt-6.1-terra`
- **النماذج الصينية** — عبر `OpenAI API Compatible`، مثل `glm-5.3`، `kimi-k3`، `deepseek-v4-pro`
- **Gemini** — لا يوفّره QCode؛ ولا يوجد عنوان QCode لوضع Gemini في Chatbox

يُضاف كل معرّف نموذج يدويًا عبر `+ New` ويمكن تعديله لاحقًا. والقائمة الحالية على **qcode.cc/models**.

## شرح الإعدادات الرئيسية

| الإعداد | ما يفعله |
|---|---|
| `Name` | مجرد اسم تعريفي لك؛ ويكفي `QCode Claude`. وهو اسم المجموعة في منتقي النموذج |
| `API Mode` | يحدد البروتوكول والمسار الذي يضيفه Chatbox. والنوع الخطأ يظهر على هيئة 404 أو رفض نماذج Claude للإجابة |
| `API Host` | العنوان حتى مقطع الإصدار شاملًا إياه: `https://api.qcode.cc/api/v1` أو `https://api.qcode.cc/openai/v1` |
| `API Path` | الجزء الأخير الذي يضيفه Chatbox: `/messages` لـ Claude، و`/chat/completions` لـ OpenAI |
| `Preview` | سطر للقراءة فقط يعرض العنوان الكامل المبني من Host وPath |
| `API Key` | مفتاح QCode الخاص بك الذي يبدأ بـ `cr_`، يُخزَّن محليًا ويُعرض على شكل نقاط |
| `Model ID` | اسم النموذج الدقيق، يُكتب يدويًا في نافذة `Edit Model` |
| `Check` | يرسل طلب اختبار واحد بنموذج تختاره ويعرض `Model Test Results` |

## القيود المعروفة

- **لا إضافة تلقائية لـ `/v1` في مضيفات Claude المخصصة.** فChatbox يعيد كتابة `https://api.anthropic.com` ليضيف `/v1`، أما المضيف المخصص فيُستخدم كما كتبته؛ ولا يُضاف إليه سوى `/messages`. ولهذا فإن مضيف Claude لدى QCode هنا هو `https://api.qcode.cc/api/v1`، لا العنوان العام `https://api.qcode.cc/api`.
- **لا قائمة نماذج تلقائية.** فالمزوّد المخصص في Chatbox لا يجلب قائمة نماذج، لذا يُكتب كل معرّف نموذج يدويًا؛ وتحديث القائمة لا يملؤها.
- **بروتوكول واحد لكل مزوّد.** يحتاج Claude إلى مزوّد `Claude API Compatible`، ويحتاج GPT والنماذج الصينية إلى `OpenAI API Compatible`؛ والمفتاح نفسه يعمل مع كليهما.
- **تختلف أسماء الأزرار بين الإصدارات.** Chatbox 1.24.6 (الإنجليزية) يقول `Model Provider` و`+ Add` و`Add Custom Provider` و`Check`؛ وقد تصوغ الإصدارات الأقدم هذه الأسماء بصيغة مختلفة.

## الوثائق ذات الصلة

- [نقاط النهاية ومسارات API](/docs/getting-started/endpoints-and-api-paths)
- [نظرة عامة على توافق الأدوات](/docs/ide/tool-compatibility)
- [النماذج الصينية](/docs/usage/cn-models)
- [الاشتراكات مقابل مفاتيح API مقابل مفاتيح QCode](/docs/reference/subscription-vs-api-key)
- [استكشاف الأخطاء وإصلاحها](/docs/reference/troubleshooting)