إعداد Qoder مع QCode (BYOK)

أضف QCode إلى إعدادات النماذج المخصصة في Qoder: OpenAI Compatible (Chat Completions أو Responses) لنماذج GPT والنماذج الصينية، وAnthropic Compatible لـ Claude.

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-11-10 · 📄 وفقًا للوثائق الرسمية (Qoder 0.5.7 وQoder CLI 1.1.86، وكلاهما صدر في 2026-11-09؛ وقد قُرئت الوثائق في 2026-11-10)

لمحة سريعة¶

Qoder IDE، منتج منفصل في العائلة نفسها، لديه صفحة نماذج مخصصة خاصة به (docs.qoder.com/user-guide/chat/custom-models) تسرد المزوّدين المعدّين مسبقًا فقط. تتوفر عناوين Base URL مخصصة في تطبيق Qoder لسطح المكتب (منذ 0.1.8، 2026-09-05) وفي Qoder CLI، حيث يديرها مستخدمو الإصدار الشخصي من صفحة مخصص في /model (منذ 1.1.50، 2026-09-11)؛ تغطي هذه الصفحة هذين المنتجين.

أي بروتوكول¶

تتيح استمارة نقطة النهاية المخصصة نوعين من المزوّدين، ولدى OpenAI Compatible خيار ثانٍ لنوع API. اختر الصف الذي يطابق عائلة النموذج:

تعمل نماذج Claude فقط عبر بروتوكول Anthropic، لذا استخدم معرّفات claude-… مع Anthropic Compatible؛ وتعمل نماذج GPT فقط عبر بروتوكولي OpenAI. وتعمل العائلات الصينية الأربع عبر كليهما. راجع نقاط النهاية ومسارات API للاطلاع على الجدول الكامل، وانسخ معرّفات النماذج من qcode.cc/models حرفًا بحرف.

صيغة Base URL. يقول توثيق Qoder نفسه: «أدخل Base URL الدقيق الذي يقدّمه مزوّد النموذج. يعرض Qoder https://api.example.com/v1 مثالًا على التنسيق.» ينتهي ذلك المثال بـ /v1، لذا أدخل لخيارات OpenAI رابط QCode الذي ينتهي بـ /v1. بالنسبة لخيار Responses API، يعمل هذا لأن QCode يقدّم /openai/responses و/openai/v1/responses بالطريقة نفسها. لا توضّح وثائق Qoder أي مسار يضيفه Qoder من أجل Anthropic Compatible. ابدأ بعنوان Base URL الخاص بـ Anthropic من QCode: https://api.qcode.cc/api (دون شرطة مائلة في النهاية). إذا فشل Validate and add model، فأدخل https://api.qcode.cc/api/v1 وتحقق مرة أخرى: يصل كلاهما إلى نقطة النهاية نفسها في QCode /api/v1/messages، والفرق الوحيد هو عدد مقاطع المسار التي يضيفها Qoder بنفسه.

في آسيا أو أمريكا الشمالية يمكنك استبدال النطاق بـ asia.qcode.cc أو us.qcode.cc؛ وتبقى المسارات كما هي.

التثبيت¶

نزّل تطبيق سطح المكتب من صفحة تنزيل Qoder (macOS 12+ أو Windows 10+ أو Linux) وسجّل الدخول. وتعرض الصفحة نفسها للـ CLI ما يلي:

# macOS / Linux
curl -fsSL https://qoder.com/install | bash

# Windows PowerShell
irm https://qoder.com/install.ps1 | iex

لدى Qoder CN تطبيقه ووثائقه الخاصة على docs.qoder.cn. تحقّق من الإصدار الذي تشغّله مقابل الإصدارات أعلاه.

الإعداد¶

سطح المكتب: الإعدادات → النماذج¶

هذه هي الخطوات الواردة في صفحة النماذج المخصصة الرسمية، وفق صياغة الواجهة في الوثائق الإنجليزية:

1. افتح الإعدادات، ثم اختر النماذج من شريط التنقل الأيسر.
2. انقر على إضافة نموذج. لنقطة نهاية مخصصة، افتح المزوّد واختر متوافق مع OpenAI أو متوافق مع Anthropic ضمن مخصص.
3. بالنسبة إلى متوافق مع OpenAI، اختر Chat Completions API أو Responses API.
4. أدخل Base URL ومفتاح API الخاص بك ومعرّف نموذج واحدًا على الأقل. لتهيئة مزيد من النماذج لنقطة النهاية نفسها، انقر على إضافة معرّف نموذج.
5. اضبط القدرات التي تسردها الصفحة: اسم العرض، ونافذة السياق (اختر القيم المدعومة، ثم نافذة السياق الافتراضية)، والرؤية (فعّلها عندما يقبل النموذج الصور)، والتفكير (فعّله عندما يدعم النموذج الاستدلال، ثم اختر مستويات الجهد).
6. انقر على التحقق وإضافة النموذج. «يتحقق Qoder من الاتصال ويحفظ النموذج بعد نجاح التحقق.»
7. اختر النموذج الجديد في واجهة الدردشة.

القيم التي تُدخلها لـ QCode (عنصر نائب للمفتاح cr_xxx):

أضف مدخلًا واحدًا لكل بروتوكول تحتاجه؛ يأخذ كل مدخل Base URL الخاص به.

الفروق بين العالمي وCN. المزوّدون المعدّون مسبقًا المدرجون في الصفحة العالمية هم Alibaba Cloud Model Studio وDeepSeek وZ.ai وKimi وMiniMax وXiaomi MIMO وOpenAI وGoogle وOpenRouter. تسرد صفحة CN كلًّا من Alibaba Cloud Model Studio وDeepSeek وZhipu وKimi وMiniMax وXiaomi MIMO، دون OpenAI وGoogle وOpenRouter. تسرد كلتاهما المزوّدين المخصصين نفسيهما، متوافق مع OpenAI ومتوافق مع Anthropic، والخطوات نفسها.

لتغيير المفتاح لاحقًا، استخدم إجراء تحرير في لوحة النماذج؛ حذف يزيل النموذج.

CLI: /model → مخصص¶

1. شغّل Qoder CLI وأدخل /model.
2. انتقل إلى علامة التبويب مخصص.
3. اختر إضافة نموذج مخصص... واضغط Enter.
4. اتبع المعالج: «المزوّد → نوع النموذج → النموذج»، ثم أدخل مفتاح API وأي معلومات أخرى يطلبها.
5. بعد نجاح التحقق، يُحفظ الإعداد تلقائيًا ويمكن اختيار النموذج فورًا. اختره من علامة التبويب مخصص؛ واضغط d على نموذج هناك لحذفه.

تقول الصفحة الرسمية أيضًا: «لا تهيئ BYOK يدويًا في settings.json؛ يحدد كتالوج BYOK المتاح للحساب الحالي المزوّدين والنماذج وحقول بيانات الاعتماد المتاحة.» لا تسرد صفحة CLI حقول المعالج. تقول ملاحظات إصدار CLI 1.1.50 إن مستخدمي النسخة الشخصية يمكنهم تهيئة نماذج BYOK «بنقاط نهاية URL مخصصة من صفحة مخصص في /model»، ووصفها حساب Qoder الرسمي على X بأنها إدخال Base URL ومعرّف النموذج ومفتاح API. استخدم قيم QCode الواردة في الجدول أعلاه لتلك الحقول.

التحقق¶

1. اختر النموذج الذي أضفته وأرسل رسالة قصيرة مثل ping.
2. افتح probe.qcode.cc، وأدخل مفتاح QCode الخاص بك وتحقق من ظهور الطلب بذلك النموذج.
3. لاختبار المفتاح والمسار دون Qoder:

KEY="cr_your_key"

# OpenAI Compatible, Chat Completions API
curl -sS https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY" \
  -H "content-type: application/json" \
  -d '{"model":"gpt-6.1-sol","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

# Anthropic Compatible
curl -sS https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":32,
       "messages":[{"role":"user","content":"ping"}]}'

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

تسرد الأسئلة الشائعة الرسمية لإضافة نموذج يفشل خمسة فحوص. وهي تقابل QCode على النحو التالي:

رسالتان خاصتان بـ QCode: تعني model_not_available_on_endpoint أنه أُضيف معرّف claude-… ضمن اختيار OpenAI، لذا أضفه ضمن Anthropic Compatible بدلًا من ذلك؛ إنه عدم تطابق في البروتوكول وليس مشكلة في المفتاح. Invalid API key مشكلة في المفتاح.

تقول الصفحة الرسمية بخصوص CLI: إذا كانت علامة التبويب المخصص أو إدخال الإضافة مفقودًا، فتأكد من أن BYOK متاح للحساب والخطة الحاليين؛ وإذا كان أحد المزوّدين أو النماذج مفقودًا، فإن الكتالوج المباشر لمعالج الإعداد هو مصدر الحقيقة.

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

• الرسمي: «توليد الصور والفيديو غير متاح حاليًا عند استخدام نماذج متصلة بمفتاح API الخاص بك (BYOK).»
• الرسمي: تُحتسب رسوم النموذج المخصص على حساب API الخاص بالمزوّد لديك و«لا تستخدم Qoder Credits». يستخدم Repo Wiki نموذجًا ثابتًا ولا يزال يستهلك Qoder Credits.
• يعرض Qoder المثال https://api.example.com/v1 كتنسيق فقط؛ لا تصف الوثائق المسار الذي يضيفه Qoder لكل بروتوكول، لذا فإن نتيجة التحقق من النموذج وإضافته هي الحكم النهائي.
• QoderWork منتج منفصل. تسرد صفحة النماذج الخاصة به الفئات Premium وAdvanced وStandard إضافة إلى Qwen3.7-Max وQwen3.7-Plus، دون وجود إدخال لنموذج مخصص حتى 2026-11-10. تقول صفحة تنزيل Qoder إن QoderWork ستوقف العمليات في 5 سبتمبر 2027، وتوصي بالانتقال إلى Qoder Desktop، الذي يتضمن أدوات استيراد البيانات.
• أُزيلت فئة نموذج Lite من محدد النموذج في 18 سبتمبر 2026 عند الساعة 14:00 بتوقيت سنغافورة (UTC+8)، وفقًا للإشعار الرسمي.

مواضيع ذات صلة¶

• نقاط النهاية ومسارات API — جدول البروتوكول × عائلة النموذج
• نظرة عامة على توافق الأدوات — أي الأدوات تتحدث بأي بروتوكول
• DeepSeek Harness — أداة أخرى فيها استمارة لإضافة نموذج مخصص
• LobsterAI — وكيل سطح مكتب تقبل مزوّداته المخصصة أيضًا تنسيقي Anthropic وOpenAI
• النماذج الصينية — معرّفات ومسارات GLM / Kimi / DeepSeek / Qwen
• دليل Qoder للنموذج المخصص وBYOK على qcode.cc — التواريخ والخلفية

المؤسسات ←