دليل إعداد Cherry Studio لواجهات API الخاصة بـ Claude وGPT وDeepSeek
اعتبارًا من 2026-10-07، يتم ربط Cherry Studio بواجهة API الخاصة بـ Claude على النحو التالي: في الإعدادات ← خدمات النماذج، أضف مزوّدًا، واختر نوع Anthropic، وأدخل العنوان الجذري https://api.qcode.cc/api فقط، من دون /v1. أما GPT والنماذج الصينية مثل DeepSeek، فاختر لها نوع OpenAI بالعنوان https://api.qcode.cc/openai، واستخدم المفتاح cr_ نفسه لكليهما. وتستعرض هذه الصفحة الخطوات ومعرّفات النماذج والأخطاء الشائعة نقطة بنقطة، استنادًا إلى وثائق QCode ووثائق Cherry Studio الرسمية.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها قبل البدء
نوع المزوّد الخاص بـ Claude
اضبط عنوان API على https://api.qcode.cc/api. وتذكر وثائق QCode أن Claude لا يمكن تمريره عبر نوع OpenAI، كما يحتاج Cherry Agent أيضًا إلى نقطة نهاية ببروتوكول Anthropic.
النوع الخاص بـ GPT والنماذج الصينية
اضبط عنوان API على https://api.qcode.cc/openai؛ ويضيف Cherry بقية المسار تلقائيًا لتكوين /openai/v1/chat/completions.
كيفية إدخال عنوان API
أدخل العنوان الجذري فقط، من دون /v1 أو أي مسار؛ وإدخال /v1 بنفسك يحوّله إلى /v1/v1. وإذا كنت تحتاج فعلاً إلى تعطيل المسار التلقائي، فاختم العنوان بـ #.
مفتاح واحد للنوعين
يستخدم النوعان المفتاح cr_ نفسه، الذي يُنشأ في لوحة التحكم. ويمكن لـ Cherry أيضًا تدوير عدة مفاتيح على مزوّد واحد، مفصولة بفواصل ASCII عادية.
كيف يتصل Cherry Studio بواجهة API مخصصة
اعتبارًا من 2026-10-07، يعني ربط Claude أو GPT أو DeepSeek في Cherry Studio دائمًا إضافة مزوّد مخصص ضمن الإعدادات ← خدمات النماذج: يستخدم Claude نوع Anthropic بالعنوان https://api.qcode.cc/api, بينما تستخدم GPT والنماذج الصينية نوع OpenAI بالعنوان https://api.qcode.cc/openai. وCherry Studio عميل سطح مكتب مفتوح المصدر (نسخة Community Edition مرخّصة بموجب AGPL-3.0) لمنصات Windows وMac وLinux. وتُدرج وثائقه الرسمية 60+ مزوّدًا مدمجًا، ولا يزال يمكن إضافة أي خدمة غير موجودة في القائمة كمزوّد مخصص ما دامت تقدم بروتوكولًا مثل OpenAI-compatible أو Anthropic-compatible. وتشير وثائق QCode إلى أنه لا يوجد لديه نظام حسابات ويُضبط محليًا بالكامل: لا تحتاج إلى حساب Cherry Studio ولا إلى حساب لدى أي مزوّد نماذج.
إصدارات Cherry Studio الأخيرة (اعتبارًا من 2026-10-07)
اعتبارًا من 2026-10-07، أحدث إصدار مستقر على GitHub Releases هو v2.1.4، المنشور في 2026-09-30 (UTC). وتنص ملاحظات الإصدار على «إضافة Claude Sonnet 5.5 وOpus 5.5 مع عناصر تحكم التفكير وأهلية أدوات الويب الأصلية»، كما يضيف دعم GPT-6.1 Sol لـ OpenAI وOpenAI Codex. ويذكر الإصدار v2.1.3 (2026-09-24) أن المزوّدين يُتحقق منهم ويُفعّلون تلقائيًا بعد إضافة النماذج، وأضاف الإصدار v2.1.0 (2026-09-18) نموذج DeepSeek V4.1 Flash. وهذه تحديثات لكتالوج النماذج المدمج في Cherry؛ وعند ربط QCode، ما زلت تدخل معرّفات النماذج كما تصف وثائق QCode وتتحقق منها مقابل /models. وقد تم التحقق من وثيقة QCode الخاصة بـ Cherry Studio مقابل الوثائق الرسمية للإصدار v2.0.14، لذا قد تختلف تسميات الواجهة بين الإصدارات.
الجدول الزمني للإصدارات والوثائق
صدر Cherry Studio v2.0.14؛ وتم التحقق من وثيقة QCode الخاصة بـ Cherry Studio مقابل الوثائق الرسمية لهذا الإصدار. وبدءًا من هذا الإصدار، تعرض الأخطاء تفاصيل المزوّد الفعلية بدلاً من رسائل عامة مثل «400 null».
تم تحديث وثيقة QCode الخاصة بـ Cherry Studio والتحقق منها آخر مرة؛ وصدر Cherry Studio v2.1.0 في اليوم نفسه، مضيفًا DeepSeek V4.1 Flash إلى الكتالوج المدمج.
صدر Cherry Studio v2.1.4 (UTC)، مضيفًا Claude Sonnet 5.5 وOpus 5.5 إلى الكتالوج المدمج؛ واعتبارًا من 2026-10-07 هو أحدث إصدار مستقر على GitHub.
المؤكد مقابل غير الموثّق
مؤكد (حرفيًا في الوثائق)
كل مما يلي يمكن التحقق منه كلمة بكلمة في وثائق QCode أو وثائق Cherry Studio الرسمية أو ملاحظات إصدار GitHub: يستخدم Claude النوع Anthropic على https://api.qcode.cc/api; ويستخدم GPT والنماذج الصينية النوع OpenAI على https://api.qcode.cc/openai; ويستخدمان مفتاح cr_ نفسه ؛ وعنوان API هو URL الجذر فقط، ولا يُعطّل إلحاق المسار إلا وجود # في النهاية ؛ ويُرفض Claude عند وضعه تحت النوع OpenAI مع الخطأ model_not_available_on_endpoint ؛ وعلى QCode، لا تخدم نقطة نهاية OpenAI Responses سوى عائلة GPT ؛ ويحتاج Cherry Agent إلى نقطة نهاية ببروتوكول Anthropic (مذكور ذلك في وثائق QCode ووثائق Cherry معًا) ؛ ويجب تشغيل المزوّد عبر مفتاح التمكين الخاص به، ولا تظهر في قوائم اختيار النماذج إلا النماذج المضافة إلى قائمته ؛ وصدر الإصدار v2.1.4 في 2026-09-30.
غير موثّق أو غير متحقّق منه
لا تخلص هذه الصفحة إلى نتيجة بشأن ثلاث نقاط. أولًا، تم التحقق من وثيقة QCode على الإصدار v2.0.14، وهي تحذّر بنفسها من أن صفحة الإعدادات قد تحمل عنوان Model Services أو Model Provider، وأن زر جلب قائمة النماذج قد يظهر بعنوان syncing models في بعض الإصدارات؛ ولم تختبر هذه الصفحة واجهة v2.1.4، لذا اعتمد على عميلك الخاص. ثانيًا، لا تقدّم وثيقة QCode الخاصة بـ Cherry Studio سوى إعداد واحد للنماذج الصينية، وهو النوع OpenAI؛ ولا تُوثّق هناك تركيبات أخرى، ولا تصفها هذه الصفحة أيضًا. ثالثًا، لإنشاء الصور وتحريرها حقلا Base URL خاصان بهما، وتذكر وثيقة QCode أن سلوك Cherry هناك لم يُتحقق منه في تلك الصفحة.
أي نوع من المزوّد تختار
Anthropic مقابل OpenAI
يعتمد ذلك على عائلة النموذج. لا يعمل Claude إلا عبر النوع Anthropic (https://api.qcode.cc/api)، وترفض نقطة نهاية OpenAI لدى QCode نموذج Claude رفضًا قاطعًا؛ أما GPT والنماذج الصينية GLM وKimi وDeepSeek وQwen فتمر عبر النوع OpenAI (https://api.qcode.cc/openai). والخط الفاصل الآخر هو Agent: تذكر وثائق QCode ووثائق Cherry كلتاهما أن Cherry Agent يحتاج إلى نقطة نهاية ببروتوكول Anthropic، لذا إذا أردت Agent داخل التطبيق، فاضبط النوع Anthropic.
OpenAI مقابل OpenAI Responses
يأخذ كلاهما https://api.qcode.cc/openai عنوانًا لـ API؛ والفرق هو النماذج التي يصل إليها كل منهما. تذكر وثيقة QCode أن نقطة نهاية Responses لا تخدم سوى عائلة GPT، وأن Claude والنماذج الصينية غير متاحة هناك. إذا كنت تحتاج إلى GPT فقط، فكلاهما يفي بالغرض؛ وإذا أردت أيضًا DeepSeek أو نموذجًا صينيًا آخر، فاختر النوع OpenAI.
ست خطوات لربط Claude (ثم GPT وDeepSeek)
① افتح الإعدادات ← Model Services، وانقر زر إضافة مزوّد أسفل القائمة، وأعطِ المزوّد اسمًا في نافذة المزوّد المخصص. ② اختر النوع Anthropic، واضبط عنوان API على https://api.qcode.cc/api، والصق المفتاح cr_ الذي أنشأته في لوحة التحكم. ③ اجلب قائمة النماذج، أو انقر + لإضافة معرّف نموذج يدويًا، مثل claude-sonnet-5؛ لا تظهر في منتقيات النماذج إلا النماذج المضافة إلى القائمة. ④ فعّل مفتاح التمكين أعلى يمين المزوّد، ثم استخدم زر الفحص واختر نموذجًا لاختبار الاتصال. ⑤ بالنسبة إلى GPT والنماذج الصينية: اختر النوع OpenAI، واضبط عنوان API على https://api.qcode.cc/openai، واستخدم المفتاح cr_ نفسه، وأضف معرّفات نماذج مثل gpt-6-sol أو deepseek-v4.1-flash أو glm-5.3. ⑥ اختر النموذج الجديد في أي نافذة محادثة وأرسل رسالة؛ إذا لم تصل أي استجابة، فتحقق أولًا من تطابق النوع مع العنوان.
على QCode
على QCode، يعمل مفتاح cr_ واحد (أُنشئ في لوحة التحكم) عبر البروتوكولات، ويحدد مسار الطلب البروتوكول الذي يُستخدم: claude-sonnet-5 وclaude-sonnet-5-5 وclaude-opus-5-5 تمر عبر النوع Anthropic على https://api.qcode.cc/api؛ وgpt-6-sol وgpt-5.6-terra وdeepseek-v4.1-flash وglm-5.3 وkimi-k3 وqwen3.8-max تمر عبر النوع OpenAI على https://api.qcode.cc/openai. تقدم نطاقات الوصول الثلاثة الميزات نفسها وتقبل المفتاح نفسه: يخدم us.qcode.cc (Los Angeles) أمريكا الشمالية وأوروبا، وللشبكات في البر الرئيسي الصيني تقترح الوثائق asia.qcode.cc، مع بقاء المسارات دون تغيير. يُحتسب الاستخدام لكل token؛ راجع /models لمعرفة سعر كل نموذج. يمكن البحث عن كل طلب على probe.qcode.cc بإدخال مفتاحك.
الأسئلة الشائعة
أي نوع من المزوّد يجب أن أختار لـ Claude في Cherry Studio؟
نوع Anthropic. عيّن عنوان API إلى https://api.qcode.cc/api، وأدخل مفتاح cr_ الخاص بك، ثم أضف معرّف نموذج (مثل claude-sonnet-5) أو اجلب قائمة النماذج. تنص وثائق QCode على أن نماذج Claude لا يمكنها استخدام سوى نقطة نهاية Anthropic، وليس نوع OpenAI. مزوّد Anthropic المدمج في Cherry يعتمد افتراضيًا على https://api.anthropic.com؛ والطريقة التي تقدّمها وثائق QCode هي إضافة مزوّد مخصص منفصل.
ماذا يعني model_not_available_on_endpoint؟
يعني أن البروتوكول هو الخطأ، وليس المفتاح. ضع نموذج Claude ضمن نوع OpenAI وسيعيد QCode خطأً مثل «Model 'claude-sonnet-5' is not available on this endpoint». تنص الوثائق على أن هذا التحقق يجري قبل المصادقة، لذا يظهر حتى عندما يكون المفتاح غير صالح؛ أما المفتاح الخاطئ، فيعيد «Invalid API key». الإصلاح: انقل Claude إلى نوع Anthropic على https://api.qcode.cc/api.
هل يجب أن يتضمن عنوان API المسار /v1 أو شرطة مائلة في النهاية؟
لا هذا ولا ذاك. أدخل العنوان الجذري فقط، ويضيف Cherry Studio المسار الخاص بالنوع الذي اخترته؛ وإدخال /v1 بنفسك يحوّله إلى /v1/v1. تنص وثيقة نقاط النهاية في QCode أيضًا، كقاعدة عامة لـ BASE_URL، على عدم إضافة شرطة مائلة في النهاية، لأن ذلك ينتج //v1/messages و404. إذا كنت تحتاج فعلاً إلى عنوان كامل، فأنهِه بـ #: عندئذ يتوقف Cherry عن الإضافة ويستخدم ما كتبته تمامًا.
أدخلت المفتاح لكنني ما زلت لا أستطيع الدردشة، أو لا يظهر النموذج. ماذا الآن؟
تحقق من ثلاثة أمور: ما إذا كان مفتاح تمكين المزوّد في أعلى اليمين مفعّلاً (إذا لم يكن كذلك، تبقى نماذجه خارج قائمة الاختيار)؛ وما إذا كان النموذج قد أُضيف إلى القائمة (لا تظهر في منتقيات النماذج إلا النماذج المدرجة)؛ وما إذا كان النوع يطابق العنوان. تشير الأسئلة الشائعة الرسمية لـ Cherry أيضًا إلى ضرورة التأكد من أن النموذج الافتراضي متاح فعلاً لدى ذلك المزوّد، والاختبار بزر التحقق؛ وإذا فشل التحقق، فابحث عن معرّف مكتوب خطأً في قائمة النماذج. لا تحكم من خلال تنفيذ curl على https://api.qcode.cc/api مباشرة: فهو يعيد صفحة تعريف HTML (HTTP 200)، وهي ليست خطأً ولا دليلًا على أن المسار يعمل. سجل طلباتك على probe.qcode.cc بمجرد إدخال مفتاحك.
هل يمكن لـ Cherry Agent استخدام Claude عبر QCode؟
نعم، اضبطه باستخدام نوع Anthropic. تنص وثائق QCode على أن Cherry Agent يحتاج إلى نقطة نهاية تدعم بروتوكول Anthropic، لذلك لاستخدام Agent داخل التطبيق، اضبط نوع Anthropic باستخدام https://api.qcode.cc/api؛ كما تقول صفحة Anthropic الرسمية لـ Cherry إن Agent يحتاج إلى نقطة نهاية ببروتوكول Anthropic. إذا قال Agent إنه يجب تمكين API Gateway، فمكّنه وابدأه مباشرة من ذلك prompt، أو ابدأه يدويًا ضمن Settings → API Gateway.
أي نوع ومعرّفات نماذج أستخدم لـ GPT وDeepSeek؟
نوع OpenAI، مع https://api.qcode.cc/openai كعنوان API ومفتاح cr_ نفسه. بالنسبة لمعرّفات النماذج، يمكنك استخدام gpt-6-sol، وgpt-5.6-terra، وdeepseek-v4.1-flash، وglm-5.3، وkimi-k3 أو qwen3.8-max؛ راجع /models لمعرفة ما هو متاح حاليًا. يعمل نوع OpenAI Responses أيضًا مع العنوان نفسه، لكن نقطة النهاية تلك على QCode تخدم عائلة GPT فقط، لذا لا تتوفر هناك DeepSeek ونماذج صينية أخرى وClaude.
المصادر
خطوات الإعداد وأنواع المزوّدين والعناوين: صفحة وثائق QCode عن Cherry Studio (محدّثة في 2026-09-18) وصفحة نقاط النهاية وتنسيقات API (محدّثة في 2026-09-25؛ أي عائلات النماذج تستخدم أي نقطة نهاية، ونص الخطأ الدقيق ونطاقات الوصول الثلاثة)، وقد تم الزحف إلى كلتيهما في 2026-10-07. واجهة Cherry Studio وقواعدها: وثائق Cherry Studio الرسمية على docs.cherryai.com.cn (النطاق القديم docs.cherry-ai.com يعيد التوجيه الآن إلى هناك باستخدام 301)، أي صفحات المزوّدين المخصصين وإعدادات خدمة النماذج وAnthropic والمرجع السريع للمزوّد والأسئلة الشائعة، وقد تم الزحف إليها في اليوم نفسه. الإصدارات والمنصات: README وReleases في مستودع Cherry Studio على GitHub (ملاحظات الإصدار من v2.0.14 إلى v2.1.4)، وقد تم الزحف إليها في اليوم نفسه.
اربط Cherry Studio بـ QCode
مفتاح cr_ واحد: Claude عبر نوع Anthropic، وGPT والنماذج الصينية عبر نوع OpenAI. الفوترة لكل token؛ راجع /models لمعرفة سعر كل نموذج.
قراءات ذات صلة
إعداد نقطة نهاية مخصصة لـ Claude Code
متغيّرا البيئة، وصيغة settings.json وapiKeyHelper.
مفتاح Claude API دون بطاقة ائتمان: Console مقابل QCode
تم التحقق في 2026-11-05: الخطوات والمتطلبات الرسمية لإنشاء مفتاح وشراء الرصيد، وكيف يمنحك QCode مفتاح cr_ بعد شحن الرصيد وشراء خطة أو باقة، إضافة إلى استخدام المفتاح وانتهاء صلاحيته وBase URL.
كيف تحكم على ما إذا كانت خدمة ترحيل AI API تستحق الاستخدام
أربعة فحوص يمكنك إجراؤها بنفسك.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الخطوات والاقتباسات في هذه الصفحة في 2026-10-07 بالرجوع إلى وثائق QCode ووثائق Cherry Studio الرسمية وملاحظات إصدار GitHub؛ وقد تحدث تغييرات دون إشعار. تتغير تسميات الواجهة بين إصدارات العميل، لذا اعتمد على الإصدار الذي لديك؛ وتوافر النماذج هو ما تعرضه /models.