Claude Desktop مع API لطرف ثالث: إعداد Gateway 3P والحدود والأسئلة الشائعة
اعتبارًا من 2026-10-07، يستطيع Claude Desktop استخدام API لطرف ثالث، لكن من نوع واحد فقط: بوابة تطبّق Anthropic Messages API. تصف الوثائق الرسمية ذلك بأنه طريقة لاستخدام نماذج Claude، ولا يعرض اكتشاف النماذج سوى نماذج Claude. نقطة الدخول هي وضع المطور: Help → Troubleshooting → Enable Developer Mode، ثم Developer → Configure Third-Party Inference، حيث تضبط مزوّد الاستدلال على Gateway وتُدخل Base URL والمفتاح. لا يقرأ تطبيق سطح المكتب ANTHROPIC_BASE_URL أو settings.json الخاص بـ Claude Code CLI، ولا يمكن ربط GPT. تعرض هذه الصفحة الخطوات، واختلافها عن Claude Code، والأسئلة الشائعة، استنادًا إلى الوثائق الرسمية لـ Anthropic ووثائق QCode.
آخر تحديث 2026-11-13
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربعة أمور يجب معرفتها قبل البدء
مزوّد الاستدلال الذي تختاره
في قسم Connection من نافذة Configure Third-Party Inference، اضبط مزوّد الاستدلال على Gateway، ثم املأ Base URL الخاص بـ Gateway ومفتاح API الخاص بـ Gateway ونظام المصادقة. وفقًا للوثائق الرسمية، تتحقق النافذة من القيم أثناء الكتابة ويمكنها اختبار الاتصال بنقطة النهاية لديك.
ما الذي يجب أن تطبّقه البوابة
المتطلب الرسمي هو Anthropic Messages API: يلزم POST /v1/messages مع البث واستخدام الأدوات. GET /v1/models اختياري؛ إذا طبّقته البوابة، تُكتشف النماذج لك، وإذا لم تفعل، تسردها في inferenceModels.
أي النماذج يمكنك اختيارها
تتناول صفحة البوابة الرسمية استخدام نماذج Claude على بوابة، ولا يعرض اكتشاف النماذج سوى النماذج التي يمكن التعرف على معرّفاتها بأنها Claude. تذكر وثائق QCode أن نماذج GPT لا يمكنها استخدام نقطة نهاية Anthropic، لذلك لا يعمل GPT في تطبيق سطح المكتب.
سطح المكتب وCLI يقرأ كل منهما تكوينه الخاص
يقرأ تطبيق سطح المكتب إعدادات البوابة الخاصة به من تكوين الاستدلال الخاص بطرف ثالث، وليس من ANTHROPIC_BASE_URL أو settings.json. أما Claude Code CLI فالعكس: يصل إلى البوابة عبر متغيرات البيئة أو ملف إعدادات.
ما هو وضع 3P في Claude Desktop
حتى 2026-10-07، يمر ربط Claude Desktop بـ API لطرف ثالث عبر وضع نشر تسميه Anthropic Claude Desktop on 3P: يُرسل كل استدلال النماذج إلى مزوّد تكوّنه، ويمكن أن يكون Google Cloud's Agent Platform أو Amazon Bedrock أو Microsoft Foundry أو بوابة متوافقة تشغلها أو Anthropic API نفسها. يوضح جدول البنية الرسمي الفروق: يرسل Claude Desktop القياسي الاستدلال إلى Anthropic API، بينما يستخدم وضع 3P نقطة النهاية التي كوّنتها؛ ويتم تضمين تطبيق الويب داخل التطبيق بدلًا من تحميله من claude.ai؛ وهوية المستخدم هي الجهاز المحلي فقط (ما لم تتم إدارتها من وحدة تحكم المسؤول في claude.ai)؛ وتُخزّن المحادثات على القرص المحلي. تقول Anthropic إن وضع 3P يحتفظ بـ Chat وCowork وCode، مع تولّي المزوّد الذي تختاره الاستدلال والفوترة (لا يتم التحقق في هذه الصفحة مما إذا كان Cowork يعمل عبر QCode). وهو مصمم للمؤسسات التي تمنعها متطلباتها الأمنية أو التنظيمية أو التعاقدية من إرسال البيانات عبر منتجات Anthropic الخاصة بها؛ ويمكن أيضًا تكوين جهاز واحد مباشرة في التطبيق، وهو مسار تصفه الوثائق للتقييم أو التجارب الأولية أو المؤسسات التي لا تستخدم MDM.
آخر التغييرات في الوثائق الرسمية (حتى 2026-10-07)
حتى 2026-10-07، أحدث إصدار في سجل تغييرات تكوين Claude Desktop on 3P هو v2.26454.0 (2026-10-06). هناك نقطتان تهمان مستخدمي البوابة مباشرة. أولًا، تقول صفحة البوابة الرسمية إنه في الإصدارات الأقدم من v2.19675.0 (2026-10-01) تفترض الجلسة نافذة سياق بسعة 200K token على إدخال النموذج القياسي لكل نموذج؛ وتفترض الإصدارات الأحدث 1M للنماذج المعروفة بأن لديها نافذة أصلية بسعة 1M و200K لكل معرّف نموذج آخر. ثانيًا، يقبل نظام مصادقة Gateway الآن قيمتين فقط، bearer وx-api-key، مع bearer كقيمة افتراضية. تطلب الوثائق أيضًا من البوابات الحفاظ على التخزين المؤقت للـ prompt: البوابة التي تزيل cache_control، أو تغيّر system prompt أو قائمة الأدوات من طلب إلى آخر، تجعل كل دور يعيد معالجة المحادثة كاملة بتكلفة الإدخال الكاملة للـ token. تم آخر تحديث لصفحة إعداد Claude Desktop في QCode في 2026-09-25.
الجدول الزمني
يضيف Claude Desktop v1.3036.0 إعداد نظام مصادقة Gateway، بحيث يمكن إرسال بيانات اعتماد البوابة كترويسة Authorization: Bearer أو ترويسة x-api-key.
تم تحديث صفحة إعداد QCode Claude Desktop؛ وتذكر أنها تستند إلى الوثائق الرسمية لبوابة استدلال تابعة لطرف ثالث، وتسحب النسخة الحالية الادعاء بأن ربط QCode يتيح لك استخدام Cowork دون Pro.
تمت مراجعة الخطوات والاقتباسات في هذه الصفحة مقابل الصفحات الرسمية في هذا التاريخ؛ واعتبارًا من ذلك اليوم، فإن أحدث إصدار في سجل تغييرات الإعدادات الرسمي هو v2.26454.0 (2026-10-06).
مؤكد مقابل غير متحقق منه
مؤكد (بالنص الحرفي في الوثائق الرسمية)
يمكن التحقق من كل ما يلي كلمة بكلمة في الوثائق الرسمية لـ Anthropic أو وثائق QCode: نقطة الدخول هي Help → Troubleshooting → Enable Developer Mode، ثم Developer → Configure Third-Party Inference؛ يجب أن تنفّذ البوابة Anthropic Messages API، مع دعم POST /v1/messages للبث واستخدام الأدوات، بينما GET /v1/models اختياري؛ يعرض اكتشاف النماذج نماذج Claude فقط؛ مخطط المصادقة هو Bearer افتراضيًا ويمكن تبديله إلى x-api-key؛ لا يقرأ تطبيق سطح المكتب ANTHROPIC_BASE_URL أو settings.json؛ Remote Control غير متاح ما دام إعداد البوابة نشطًا؛ لا يتوفر في وضع 3P تطبيق جوال، ولا وصول ويب إلى claude.ai، ولا وضع صوتي، ولا مشاركة بين المستخدمين، ولا جلسات في سحابة Anthropic؛ 3P استهلاك قائم على token دون ترخيص حسب المقاعد؛ على QCode، لا يمكن لنماذج Claude استخدام سوى نقطة نهاية Anthropic، على https://api.qcode.cc/api.
غير متحقق منه، أو تختلف المصادر
لا تخلص هذه الصفحة إلى نتيجة بشأن ثلاثة أمور. أولًا، Cowork: تقول Anthropic إن وضع 3P يحتفظ بـ Chat وCowork وCode، لكن وثائق QCode سحبت الادعاء بأن ربط QCode يتيح لك استخدام Cowork دون Pro وطلبت من القراء ألا يعدّوا Cowork حالة استخدام لـ QCode، لذلك لا تعد هذه الصفحة بأن Cowork يعمل عبر QCode. ثانيًا، النماذج غير التابعة لـ Claude: تقول الوثائق الرسمية إن اكتشاف النماذج يعرض نماذج Claude فقط، وتقول وثائق بوابة Claude Code إن Anthropic لا تدعم توجيه Claude Code إلى نماذج غير تابعة لـ Claude عبر أي بوابة، لذلك لا تقدّم هذه الصفحة أي إعداد لنماذج أخرى في تطبيق سطح المكتب. ثالثًا، البحث على الويب، وهو غير متحقق منه: تقول حاشية في جدول الميزات الرسمي إن البوابات التي لا تمرّر أدوات خادم Anthropic تحتاج إلى مزوّد بحث على الويب يُضبط أولًا؛ ولا تصف وثائق QCode سلوك البحث على الويب في تطبيق سطح المكتب، ولم تتحقق هذه الصفحة مما إذا كان يعمل عبر QCode.
كيف يختلف عن Claude Code Desktop وClaude Code CLI
مقابل Claude Code Desktop
لا يوجد تطبيقان اثنان. تقول الوثائق الرسمية إن تطبيق Claude Desktop يحتوي على ثلاث علامات تبويب: Chat للمحادثات، وCowork لـ Dispatch والعمل الوكيلي الأطول، وCode لتطوير البرمجيات؛ وClaude Code Desktop هو علامة التبويب Code تلك. في وضع 3P، يشغّل Code محرك Claude Code نفسه الذي يستخدمه CLI المستقل، ويرث إعداد الاستدلال الخاص بطرف ثالث في تطبيق سطح المكتب تلقائيًا، ويستخدم المزوّد ونقطة النهاية وبيانات الاعتماد نفسها التي تستخدمها جلسات Cowork. لذلك، بمجرد إعداد البوابة في تطبيق سطح المكتب، تستخدمها علامة التبويب Code أيضًا، دون أي إعداد إضافي.
مقابل Claude Code CLI
يقع الإعداد في مكان مختلف. يصل CLI إلى البوابة عبر ANTHROPIC_BASE_URL إضافة إلى متغير بيانات اعتماد (تستخدم وثائق QCode المتغير ANTHROPIC_AUTH_TOKEN)؛ ولا يقرأ تطبيق سطح المكتب أيًا منهما. تقول الوثائق الرسمية إنه ما دامت بيانات اعتماد البوابة نشطة، فتحمل الطلبات هذه البيانات بدلًا من تسجيل الدخول إلى اشتراك claude.ai، ولا تنطبق حدود استخدام الاشتراك؛ وإن ضبط ANTHROPIC_BASE_URL فقط دون بيانات اعتماد لا يستبدل الاشتراك. أيّهما تستخدم: تقترح الوثائق تطبيق سطح المكتب لإدارة الجلسات المتوازية في نافذة واحدة، أو ترتيب الألواح جنبًا إلى جنب، أو مراجعة التغييرات بصريًا، وCLI للبرمجة النصية أو الأتمتة أو سير عمل الطرفية. تطبيق سطح المكتب تفاعلي فقط، ولا يوفر إخراجًا بنمط --print.
ست خطوات لتوصيل بوابة في تطبيق سطح المكتب
① ثبّت Claude Desktop من claude.com/download وشغّله دون تسجيل الدخول أو إنشاء حساب Anthropic. ② من شريط قوائم macOS (على Windows، من قائمة التطبيق ☰ أعلى يسار شاشة تسجيل الدخول)، اختر Help → Troubleshooting → Enable Developer Mode؛ يعيد التطبيق التشغيل مع ظهور قائمة Developer. ③ اختر Developer → Configure Third-Party Inference…، وفي قسم Connection عيّن Inference provider على Gateway. ④ أدخل عنوان البوابة في Gateway base URL والمفتاح الذي أصدرته بوابتك في Gateway API key؛ واترك Credential kind على القيمة الافتراضية Static API key وGateway auth scheme على القيمة الافتراضية Bearer، ولا تنتقل إلى x-api-key إلا إذا كانت بوابتك تتطلب ذلك. ⑤ Models: إذا كانت البوابة تنفّذ GET /v1/models، فسيتم اكتشاف النماذج لك؛ وإلا فاسرد كل معرّف نموذج كامل تقبله بوابتك في inferenceModels ضمن Models، وسيصبح الإدخال الأول هو النموذج الافتراضي. ⑥ انقر Apply Changes، ثم Save & Restart؛ بعد إعادة التشغيل تعرض شاشة تسجيل الدخول خيارًا للبدء بهذا التكوين. للعودة إلى Claude Desktop القياسي، اختر خيار تسجيل الدخول إلى Anthropic في تلك الشاشة.
على QCode
وفقًا لوثائق QCode، املأ الخطوة ④ هكذا: يكون Gateway base URL هو https://api.qcode.cc/api (من دون /v1، ومن دون شرطة مائلة في النهاية؛ وللشبكات في البر الرئيسي للصين توصي الوثائق بـ https://asia.qcode.cc/api)، ويكون Gateway API key هو مفتاح cr_ أنشئته في وحدة التحكم، ويبقى مخطط المصادقة على القيمة الافتراضية bearer. على QCode، لا يمكن لنماذج Claude استخدام سوى نقطة نهاية Anthropic، لذا اختر في تطبيق سطح المكتب نماذج Claude مثل claude-sonnet-5-5 أو claude-opus-5-5 أو claude-sonnet-5. لا يمكن لنماذج GPT استخدام نقطة نهاية Anthropic؛ ولاستخدام GPT، استخدم عميلًا يدعم بروتوكول OpenAI. يعمل المفتاح نفسه أيضًا مع Claude Code CLI: عيّن ANTHROPIC_BASE_URL على https://api.qcode.cc/api وANTHROPIC_AUTH_TOKEN على مفتاح cr_ الخاص بك. تتم الفوترة لكل token؛ راجع /models لمعرفة سعر كل نموذج. يمكن الاستعلام عن كل طلب على probe.qcode.cc بإدخال مفتاحك.
الأسئلة الشائعة
هل يمكن لـ Claude Desktop استخدام API من طرف ثالث أو API مخصص؟
نعم، لكن فقط بوابة تنفّذ Anthropic Messages API؛ وتصف الوثائق الرسمية ذلك كطريقة لاستخدام نماذج Claude، ويعرض اكتشاف النماذج نماذج Claude فقط. اعتبارًا من 2026-10-07، تسمي Anthropic هذا Claude Desktop on 3P: افتح Configure Third-Party Inference في وضع المطوّر، وعيّن مزوّد الاستدلال على Gateway، وأدخل Base URL ومفتاحًا. يجب أن تدعم البوابة POST /v1/messages مع البث واستخدام الأدوات. يرسل Claude Desktop القياسي، خارج وضع 3P، الاستدلال إلى Anthropic API.
هل يمكنني استخدام GPT في Claude Desktop؟
لا. تشترط الوثائق الرسمية أن تنفّذ البوابة Anthropic Messages API، ويعرض اكتشاف النماذج نماذج Claude فقط؛ وتذكر وثائق QCode أن نماذج GPT لا يمكنها استخدام نقطة نهاية Anthropic. لاستخدام GPT على سطح المكتب، تنصح وثائق QCode باختيار عميل يدعم بروتوكول OpenAI.
عيّنت ANTHROPIC_BASE_URL في settings.json. لماذا لا يستخدمه تطبيق سطح المكتب؟
لأن تطبيق سطح المكتب لا يقرأه. تقول وثائق بوابة Claude Code الرسمية إن تطبيق سطح المكتب يقرأ إعدادات بوابته من تكوين الاستدلال الخاص به عبر طرف ثالث، وليس من ANTHROPIC_BASE_URL أو settings.json؛ فكلاهما يؤثر فقط في Claude Code CLI. لتوجيه تطبيق سطح المكتب (بما في ذلك تبويب Code) عبر بوابة، كوّنه ضمن Developer → Configure Third-Party Inference. إذا كانت تلك النافذة للقراءة فقط، فقد وزّع مسؤول تكوينًا، ويكون لهذا التكوين الأولوية.
هل ما زلت بحاجة إلى حساب Claude أو اشتراك Pro مع بوابة طرف ثالث؟
لا تسجّل الدخول. تقول الخطوات الرسمية للجهاز الواحد ألا تسجّل الدخول أو تنشئ حساب Anthropic؛ وبعد التكوين، تعرض شاشة تسجيل الدخول خيار تخطي مصادقة Anthropic والبدء بتكوين المزوّد الخاص بك. تصف الوثائق 3P بأنه استهلاك قائم على token تتم فوترته من مزوّدك، ومن دون تراخيص مقاعد، ويظل استخدامك لتطبيق سطح المكتب نفسه خاضعًا لشروط الخدمة التجارية لـ Anthropic. المقابل هو ميزات أقل: في جدول الميزات الرسمي، لا يوفر وضع 3P تطبيق جوال، ولا وصولًا إلى ويب claude.ai، ولا وضعًا صوتيًا، ولا مشاركة بين المستخدمين، ولا جلسات في سحابة Anthropic. للعودة، اختر خيار تسجيل الدخول إلى Anthropic في شاشة تسجيل الدخول.
منتقي النماذج فارغ، أو أرى «Gateway was unreachable». ماذا الآن؟
تحقق من العنوان أولًا، ثم من قائمة النماذج. وفقًا للوثائق الرسمية، تعني رسالة Gateway was unreachable أن التطبيق لم يتمكن من الوصول إلى Base URL المهيأ عند بدء التشغيل، لذا تحقق من URL ومسار الشبكة. إذا كان منتقي النماذج فارغًا، تقول الوثائق إن عليك التحقق من استجابة GET /v1/models الخاصة ببوابتك ومن قائمة inferenceModels: عندما يتعذر الوصول إلى /v1/models أو يعيد خطأً، يعود منتقي النماذج إلى inferenceModels، وإذا كانت تلك القائمة فارغة كان منتقي النماذج فارغًا أيضًا. تضيف وثائق QCode أن Base URL يجب ألا ينتهي بشرطة مائلة، وأن المفتاح يجب أن يبدأ بـ cr_ من دون مسافات بادئة أو لاحقة؛ وإذا ظل منتقي النماذج فارغًا، فأدرج بنفسك معرّفات كاملة مثل claude-sonnet-5-5 في inferenceModels.
هل يمكنني تشغيل تطبيق سطح المكتب وClaude Code CLI في الوقت نفسه باستخدام مفتاح QCode واحد؟
نعم. تقول الوثائق الرسمية إن تطبيق سطح المكتب يشغّل المحرك الأساسي نفسه الذي يشغّله CLI، ويمكنك تشغيل كليهما في الوقت نفسه على الجهاز نفسه، حتى في المشروع نفسه. تقول وثائق QCode إن كلًا منهما يقرأ تهيئته الخاصة، فتطبيق سطح المكتب يقرأ تهيئته وCLI يقرأ ~/.claude/settings.json، مع مشاركة مفتاح API نفسه الخاص بـ QCode من دون تعارض. ملاحظة واحدة: الأمر /desktop الذي ينقل جلسة CLI إلى تطبيق سطح المكتب يتطلب تسجيل الدخول باستخدام اشتراك Claude، وتقول الوثائق إنه غير متاح مع مصادقة مفتاح API.
المصادر
وضع 3P وتهيئة البوابة: وثائق Claude Desktop on 3P الرسمية من Anthropic على claude.com/docs (نظرة عامة، ومقارنة الميزات، والتثبيت والتهيئة، والتهيئة داخل التطبيق، وبوابة LLM، والنماذج ومستويات الجهد، وChat، وCode، وصفحات الشؤون القانونية والامتثال، إضافة إلى سجل تغييرات التهيئة)، تم الزحف إليها في 2026-10-07. علاقة تطبيق سطح المكتب بـ CLI: وثائق Claude Code الرسمية على code.claude.com (صفحة تطبيق سطح المكتب، وصفحة الاتصال بـ LLM gateway، وصفحة بوابات LLM الأخرى)، تم الزحف إليها في اليوم نفسه. عناوين QCode ومفاتيحها وقواعد نقاط النهاية: صفحة تهيئة Claude Desktop في وثائق QCode (محدّثة في 2026-09-25)، وصفحة نقاط النهاية وصيغ API، وصفحة متغيرات البيئة، وصفحة الاشتراكات ومفتاح QCode، تم الزحف إليها في اليوم نفسه.
اربط Claude Desktop بـ QCode
اضبط مزوّد الاستدلال على Gateway، واستخدم https://api.qcode.cc/api عنوانًا، واستخدم مفتاح QCode يبدأ بـ cr_، واختر نموذج Claude. تتم المحاسبة لكل token؛ راجع /models لمعرفة سعر كل نموذج.
قراءات ذات صلة
إعادة تصميم Claude Code Desktop في 2026
إعادة التصميم في 2026-04-14: شريط جانبي Mission Control، وجلسات متوازية، وطرفية مدمجة.
توجيه Claude Code إلى نقطة نهاية مخصصة
من جهة CLI: كيفية ضبط ANTHROPIC_BASE_URL وAUTH_TOKEN.
ميزات Claude الخفية: 20 استخدامًا وفحص مفتاح API (2026-11-03)
أين يتم تفعيل كل ميزة من ميزات Claude الـ 20، وأي الخطط تحصل عليها، وما إذا كان مفتاح API (بما في ذلك QCode) يعمل - تم التحقق في 2026-11-03 مقابل الصفحات الرسمية وجدول QCode، مع تصحيح أربعة مفاهيم خاطئة شائعة.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من الخطوات والاقتباسات في هذه الصفحة في 2026-10-07 مقابل وثائق Anthropic الرسمية ووثائق QCode؛ وقد تحدث تغييرات من المزوّد من دون إشعار. تتغير أسماء القوائم والأزرار في تطبيق سطح المكتب بين الإصدارات، لذا اعتمد على الإصدار الذي لديك؛ أما توفر النماذج فهو ما يعرضه /models.