Qoder BYOK: إعداد النموذج المخصص وBase URL (نوفمبر 2026)
اعتبارًا من 2026-11-10، يمكن لـ Qoder استخدام مفتاح API الخاص بك (الخطة الفردية): في تطبيق سطح المكتب انتقل إلى الإعدادات > النماذج > إضافة نموذج واختر OpenAI Compatible أو Anthropic Compatible ضمن المخصص، ثم أدخل Base URL ومفتاح API ومعرّف النموذج؛ وفي CLI، أضف النموذج عبر المعالج في علامة التبويب المخصص من /model. وفقًا لملاحظات الإصدار الرسمية، جعل Qoder 0.1.8 (2026-09-05) BYOK في الخطة الشخصية يقبل Base URL مخصصًا. مع QCode: اختر Anthropic Compatible وأدخل https://api.qcode.cc/api لـ Claude، أو اختر OpenAI Compatible (Chat Completions API) وأدخل https://api.qcode.cc/openai/v1 لـ GPT والنماذج الصينية، باستخدام مفتاح cr_ الخاص بك.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربع نقاط من المصادر الرسمية
متوافق مع OpenAI وAnthropic
تسرد الصفحة الرسمية مزوّدين مخصصين هما OpenAI Compatible وAnthropic Compatible؛ بعد OpenAI Compatible تختار Chat Completions API أو Responses API.
Base URL مخصص اعتبارًا من 2026-09-05
ملاحظات إصدار Qoder 0.1.8: يدعم BYOK في الخطة الشخصية الآن عناوين Base URL مخصصة لأي خدمة نموذج متوافقة مع OpenAI أو Anthropic. اعتبارًا من 2026-11-10، أحدث إصدار لسطح المكتب هو 0.5.7 (2026-11-09).
نقطة الدخول على سطح المكتب
الإعدادات، ثم النماذج في التنقل الأيسر، ثم إضافة نموذج؛ ضمن المخصص اختر نوع المزوّد، وأدخل Base URL ومفتاح API ومعرّف نموذج واحدًا على الأقل، ثم انقر على التحقق من النموذج وإضافته.
لا يستهلك رصيد Qoder
الأسئلة الشائعة الرسمية: تُحتسب رسوم النموذج المخصص مباشرةً على حساب API الخاص بك لدى المزوّد ولا تستهلك رصيد Qoder؛ ويستخدم Repo Wiki نموذجًا ثابتًا ولا يزال يستهلك الرصيد. إنشاء الصور والفيديو غير متاح مع نماذج BYOK.
هل يمكن لـ Qoder استخدام مفتاح API الخاص بك؟
اعتبارًا من 2026-11-10، نعم. تقول صفحة النماذج المخصصة الرسمية: «يدعم Qoder الوصول إلى موارد نماذج المزوّدين الخارجيين عبر مفاتيح API». وتقول صفحة CLI: «الإصدار المتاح: الخطة الفردية»، وتسرد صفحة الأسعار «Bring Your Own Key (BYOK)» في عمود Free ضمن الخطط الفردية. يختلف تطبيق سطح المكتب وCLI وQoderWork. سطح المكتب: الإعدادات > النماذج > إضافة نموذج، ثم نقطة نهاية مخصصة مع Base URL ومفتاح API ومعرّف النموذج. CLI: أدخل /model، وانتقل إلى علامة التبويب المخصص واختر إضافة نموذج مخصص... لاتباع المعالج. QoderWork: تسرد صفحة النماذج الرسمية الخاصة به Premium وAdvanced وStandard إضافةً إلى Qwen3.7-Max وQwen3.7-Plus، دون وجود إدخال لنموذج مخصص اعتبارًا من 2026-11-10؛ وتقول صفحة تنزيل Qoder إن QoderWork سيتوقف رسميًا عن العمل في 2027-09-05، ويظل متاحًا للتنزيل والاستخدام حتى ذلك الحين، وتوصي بالانتقال إلى Qoder Desktop مسبقًا، الذي يتضمن أدوات مدمجة لاستيراد البيانات. يستخدم الموقع العالمي qoder.com وموقع الصين Qoder CN خطوات التخصيص نفسها؛ تختلف فقط قوائم المزوّدين المعدّة مسبقًا، ولا تتضمن قائمة Qoder CN أي OpenAI أو Google أو OpenRouter.
2026-09-05: يضيف Qoder 0.1.8 عناوين Base URL مخصصة إلى BYOK في الخطة الشخصية
تحمل ملاحظات إصدار Qoder 0.1.8 (2026-09-05) عنوان «Custom Base URLs for BYOK» وتقول إن BYOK في الخطة الشخصية يدعم الآن عناوين Base URL مخصصة لأي خدمة نموذج متوافقة مع OpenAI أو Anthropic. على صعيد CLI، تقول ملاحظات إصدار 1.1.50 (2026-09-11) إن مستخدمي الإصدار الشخصي يمكنهم تهيئة نماذج BYOK وإدارتها بنقاط نهاية URL مخصصة من صفحة Custom في /model، وفي 2026-09-12 كتب حساب Qoder الرسمي على X أنه بدءًا من v1.1.50، يدعم Qoder CLI تكامل النماذج المخصصة لجميع المستخدمين الأفراد: تُدخل Base URL ومعرّف النموذج ومفتاح API للاتصال. تسرد ملاحظات سابقة لـ CLI 0.2.5 (2026-04-29) بالفعل «BYOK Custom URL». اعتبارًا من 2026-11-10، أحدث إصدار لسطح المكتب هو 0.5.7 وCLI هو 1.1.86، وكلاهما صدر في 2026-11-09.
الخط الزمني
يطلق Qoder IDE 0.16.0 (وهو منتج منفصل عن تطبيق سطح المكتب) إصدار Community Edition؛ وتقول ملاحظات الإصدار إن Community Edition أتاحت BYOK، مع خدمات MaaS الصينية السائدة مثل Alibaba Cloud وKimi وDeepSeek وZ.ai وMiniMax.
Qoder 0.1.8: يدعم BYOK في الخطة الشخصية عناوين Base URL مخصصة لأي خدمة نموذج متوافقة مع OpenAI أو Anthropic.
Qoder CLI 1.1.50: يمكن لمستخدمي الإصدار الشخصي تهيئة نماذج BYOK بنقاط نهاية URL مخصصة من صفحة Custom في /model.
ما توثقه Qoder وما تتركه دون توضيح
موثّق من Qoder
① ضمن Custom في تطبيق سطح المكتب يوجد OpenAI Compatible وAnthropic Compatible؛ وبعد OpenAI Compatible تختار Chat Completions API أو Responses API. ② تدخل Base URL ومفتاح API ومعرّف نموذج واحد على الأقل؛ وتضيف «إضافة معرّف النموذج» مزيدًا من النماذج لنقطة النهاية نفسها. ③ بالصياغة الرسمية: أدخل Base URL الدقيق الذي تقدمه خدمة النموذج؛ ويعرض Qoder https://api.example.com/v1 كصيغة مثال. ④ يتحقق «التحقق وإضافة النموذج» من الاتصال ويحفظ النموذج فقط بعد نجاح التحقق. ⑤ تُفوتر الرسوم مباشرة على حساب API الخاص بالمزوّد ولا تستخدم رصيد Qoder. ⑥ توليد الصور والفيديو غير متاح مع نماذج BYOK. ⑦ تذكر صفحة CLI عدم تكوين BYOK يدويًا في settings.json واستخدام معالج Custom في /model. ⑧ إذا فشلت إضافة نموذج، فإن الفحوص الرسمية هي: اكتمال Base URL وتطابق البروتوكول ونوع API، وصحة المفتاح، وصحة معرّف النموذج، وكفاية الرصيد، وسلامة الشبكة. ⑨ تسرد صفحة الأسعار «Bring Your Own Key (BYOK)» في عمود Free ضمن الخطط الفردية.
ما تتركه الصفحات الرسمية مفتوحًا
اعتبارًا من 2026-11-10: ① لا تذكر صفحة النماذج المخصصة في تطبيق سطح المكتب نفسها أي إصدار؛ وتقول صفحة CLI «الإصدار المتاح: خطة Individual»، وتقول ملاحظات إصدار تطبيق سطح المكتب «BYOK للخطة الشخصية». ② Qoder IDE منتج منفصل ضمن العائلة نفسها؛ وتعرض صفحة النماذج المخصصة فيه المزوّدين المعدّين مسبقًا فقط، وتقول إنها تنطبق على المستخدمين الذين لديهم خطط Individuals، في حين تخص عناوين Base URL المخصصة تطبيق سطح المكتب الجديد وCLI. ③ لا تسرد صفحة CLI حقول المعالج واحدًا واحدًا، وتقول إن كتالوج المزوّدين هو ما يعرضه المعالج مباشرةً؛ وصياغة نقطة نهاية URL المخصصة تأتي من ملاحظات الإصدار ومنشور X الرسمي. ④ لا توضح الوثائق، بروتوكولًا ببروتوكول، أي مسار يضيفه Qoder إلى Base URL، وتقدم صيغة مثال واحدة، https://api.example.com/v1؛ ونتيجة «التحقق وإضافة النموذج» هي الاختبار العملي. ⑤ يبلغ بعض مستخدمي المجتمع عن اختفاء النماذج المخصصة بعد انتهاء الفترة التجريبية؛ وتعرض صفحة الأسعار الرسمية BYOK في عمود Free، وخطوة استكشاف الأخطاء وإصلاحها في صفحة CLI هي التأكد من توفر BYOK للحساب والخطة الحاليين.
نقاط دخول تطبيق سطح المكتب وCLI
سطح المكتب: الإعدادات > النماذج
انقر على «إضافة نموذج»، واختر OpenAI Compatible أو Anthropic Compatible ضمن Custom، وأدخل Base URL ومفتاح API ومعرّف النموذج، ثم انقر على «التحقق وإضافة النموذج». يستخدم موقع الصين Qoder CN الخطوات نفسها.
CLI: /model > مخصص
أدخل /model، وانتقل إلى علامة التبويب Custom، واختر «إضافة نموذج مخصص...» واضغط Enter، واتبع المعالج عبر المزوّد ونوع النموذج والنموذج، وأدخل مفتاح API؛ وبعد التحقق يُحفظ تلقائيًا، ويحذف d النموذج المحدد.
كيفية استخدام مفتاح API الخاص بك في Qoder وتعيين Base URL
① ثبّت تطبيق سطح المكتب من صفحة تنزيل Qoder (macOS 12+ أو Windows 10+ أو Linux) وسجّل الدخول؛ أما CLI فاستخدم curl -fsSL https://qoder.com/install | bash (في Windows PowerShell: irm https://qoder.com/install.ps1 | iex). ② سطح المكتب: الإعدادات > النماذج في شريط التنقل الأيسر > إضافة نموذج > افتح المزوّد، وضمن Custom اختر OpenAI Compatible أو Anthropic Compatible؛ وفي حالة OpenAI Compatible اختر أيضًا Chat Completions API أو Responses API. ③ أدخل Base URL ومفتاح API ومعرّف النموذج، واضبط اسم العرض ونافذة السياق وخيارات الرؤية والتفكير لتطابق النموذج، وانقر على «التحقق وإضافة النموذج»، ثم اختر النموذج في الدردشة. ④ CLI: /model > Custom > إضافة نموذج مخصص...، واتبع المعالج ولا تعدّل settings.json يدويًا. ⑤ أدخل Base URL الدقيق الذي تقدمه لك خدمة النموذج؛ يعرض Qoder https://api.example.com/v1 كصيغة مثال. لا تسرد الوثائق المسار الذي يضيفه Qoder لكل بروتوكول، لذا إذا فشل التحقق فراجع العنوان في وثائق المزوّد أولًا.
تشغيل Qoder باستخدام مفتاح API من QCode
اعتبارًا من 2026-11-10، يخدم مفتاح QCode واحد كلاً من نقاط النهاية المتوافقة مع Anthropic ونقاط النهاية المتوافقة مع OpenAI، وتُحتسب التكلفة لكل token بأسعار لكل نموذج على /models. ولـ Claude اختر Anthropic Compatible، وأدخل https://api.qcode.cc/api في حقل Base URL، وأدخل Model ID مثل claude-sonnet-5-5 أو claude-opus-5-5. ولـ GPT اختر OpenAI Compatible مع Chat Completions API، وأدخل https://api.qcode.cc/openai/v1 وModel ID مثل gpt-6.1-sol؛ لاستخدام Responses API اخترها وأدخل نفس https://api.qcode.cc/openai/v1 (على QCode فإن /openai/responses و/openai/v1/responses متكافئان)، مع نموذج GPT. تعمل GLM وKimi وDeepSeek وQwen على Anthropic Compatible أو على OpenAI Compatible مع Chat Completions API، على سبيل المثال deepseek-v4.1-flash وglm-5.3 وkimi-k3 وqwen3.8-max؛ وتتبع معرّفات النماذج /models. اترك أي شرطة مائلة زائدة، وانقر على Validate and add model، واعتمد نتيجة التحقق من Qoder؛ وإذا لم يتم التحقق من Anthropic Compatible، فغيّر العنوان إلى https://api.qcode.cc/api/v1 وتحقق مرة أخرى. ثلاث خطوات: ① أنشئ حسابًا واشحن الرصيد (Alipay وطرق الدفع الرئيسية الأخرى)؛ ② اشترِ خطة شخصية أو إحدى باقات الدفع حسب الاستخدام وانسخ مفتاح API الخاص بك، الذي يبدأ بـ cr_؛ ③ أدخله في Qoder كما هو موضح أعلاه؛ يشرح مقال الوثائق في QCode https://docs.qcode.cc/en/docs/ide/qoder الإعداد نفسه خطوة بخطوة. لست مستعدًا لخطة شهرية؟ تبدأ باقات الدفع حسب الاستخدام من $4 مقابل حصة تُستخدم لمرة واحدة خلال 7 أيام.
الأسئلة الشائعة
هل يستطيع Qoder استخدام مفتاح API الخاص بي؟
نعم. تقول صفحة النماذج المخصصة الرسمية إن Qoder يدعم الوصول إلى موارد نماذج المزوّدين الخارجيين عبر مفاتيح API؛ ومدخل تطبيق سطح المكتب هو Settings > Models > Add model، ومدخل CLI هو علامة التبويب Custom في /model. وتذكر صفحة CLI أن الإصدار هو خطة Individual. وفي تطبيق سطح المكتب، تأتي نقاط النهاية المخصصة بنوعين: OpenAI Compatible وAnthropic Compatible. وقيم QCode مذكورة أعلاه.
كيف أضبط Base URL في Qoder؟
ضمن Add model، اختر نقطة نهاية مخصصة واملأ Base URL؛ وتطلب الصفحة الرسمية Base URL الدقيق الذي يوفره مزوّد خدمة النموذج، وتعرض https://api.example.com/v1 كمثال على الصيغة. وبالنسبة إلى QCode، يستخدم Anthropic Compatible العنوان https://api.qcode.cc/api ويستخدم OpenAI Compatible العنوان https://api.qcode.cc/openai/v1، من دون شرطة مائلة في النهاية؛ وإذا لم يُجتز Anthropic Compatible التحقق، فجرّب https://api.qcode.cc/api/v1. وإذا فشل التحقق، فالنصيحة الرسمية هي التحقق أولًا من أن Base URL كامل وأن البروتوكول ونوع API يطابقان نقطة النهاية، ثم من المفتاح وModel ID والرصيد والشبكة.
هل لا يزال Qoder يستهلك Credits عند استخدام مفتاحي الخاص؟
تجيب الأسئلة الشائعة الرسمية: تُحتسب رسوم النماذج المخصصة مباشرة على حساب API لدى المزوّد ولا تستهلك Qoder Credits. والاستثناء وارد في الإجابة نفسها: يستخدم Repo Wiki نموذجًا ثابتًا ويستهلك Qoder Credits، مع ظهور prompt عند التوليد. وباستخدام مفتاح QCode، يُحتسب الاستخدام لكل token بأسعار خاصة بكل نموذج على /models.
كيف أضيف نموذجًا مخصصًا في Qoder CLI؟
في CLI أدخل /model، وانتقل إلى علامة التبويب Custom، واختر Add custom model... واضغط Enter، ثم اتبع المعالج عبر Provider ونوع النموذج والنموذج وأدخل مفتاح API وأي معلومات أخرى يطلبها؛ وبعد التحقق يُحفظ الإعداد تلقائيًا ويمكنك التبديل إليه فورًا. وتنص الصفحة الرسمية على عدم إعداد BYOK يدويًا في settings.json. وإذا كانت علامة التبويب Custom غير موجودة، فتأكد من أن BYOK متاح لحسابك وخطتك.
هل يمكنني إضافة نموذج مخصص في QoderWork؟
اعتبارًا من 2026-11-10، تعرض صفحة النماذج الرسمية لـ QoderWork الخطط Premium وAdvanced وStandard إضافة إلى Qwen3.7-Max وQwen3.7-Plus، من دون أي مدخل لنموذج مخصص. وتذكر صفحة تنزيل Qoder أن QoderWork سيتوقف رسميًا عن العمل في 2027-09-05، وسيبقى متاحًا للتنزيل والاستخدام حتى ذلك الحين، وأن حساب Qoder والرصيد الخاص بك سيبقيان قابلين للاستخدام مع منتجات Qoder الأخرى؛ وتوصي بالانتقال إلى Qoder Desktop مسبقًا، إذ تنقل أدوات استيراد البيانات المدمجة فيه سجل المهام والمهارات والذكريات. ولجلب نموذجك الخاص، أضفه في تطبيق Qoder لسطح المكتب أو في CLI كما هو موضح أعلاه.
هل يمكنني استخدام مفتاح API الخاص بي في خطة Free من Qoder؟
نعم. اعتبارًا من 2026-11-10، تُدرج صفحة أسعار Qoder «Bring Your Own Key (BYOK)» في عمود Free ضمن الخطط الفردية، وفي 2026-09-12 كتب حساب Qoder الرسمي على X أنه بدءًا من v1.1.50، يدعم Qoder CLI تكامل النماذج المخصصة لجميع المستخدمين الأفراد. وإذا كان تبويب Custom أو خيار الإضافة مفقودًا، فتقول صفحة CLI إنه يجب التأكد من توفر BYOK للحساب والخطة الحاليين. وبشكل منفصل، ينص الإشعار الرسمي (المنشور في 2026-09-04) على أن فئة نموذج Lite أُزيلت من منتقي النماذج في جميع منتجات Qoder في 2026-09-18 عند الساعة 14:00 بتوقيت سنغافورة (UTC+8)؛ ويتعلق هذا التغيير بفئة نموذج، ولا تزال صفحة الأسعار تُدرج خطة Lite.
المصادر
Qoder: صفحات النماذج المخصصة على docs.qoder.com (بالصينية والإنجليزية واليابانية)، وصفحة النماذج المخصصة في CLI، وصفحة منتقي النماذج، وصفحة الأسعار، وصفحة نماذج QoderWork، وإشعار إيقاف فئة Lite، وصفحة النماذج المخصصة على docs.qoder.cn، وملاحظات إصدار تطبيق سطح المكتب وCLI وQoder IDE على changelog.qoder.com، وصفحة التنزيل على qoder.com، ومنشور Qoder الرسمي على X بتاريخ 2026-09-12، وجميعها قُرئت في 2026-11-10. QCode: qcode.cc/models، وqcode.cc/pricing، وqcode.cc/pay-as-you-go، وصفحة Endpoints & API Paths على docs.qcode.cc، تم استرجاعها في 2026-11-10.
شغّل Qoder باستخدام مفتاحك الخاص
مفتاح API واحد من QCode في Qoder: Claude عبر Anthropic Compatible، وGPT والنماذج الصينية عبر OpenAI Compatible، وتُحتسب الفاتورة لكل token؛ أسعار كل نموذج على /models.
قراءات ذات صلة
باقات الدفع حسب الاستخدام
باقات حصة لمرة واحدة صالحة لمدة 7 أيام، دون اشتراك؛ وتُضاف الباقات الإضافية إلى المفتاح نفسه.
مفتاح API المخصص وBase URL في Cursor
أين تُوضع المفاتيح في Settings → Models، وأي حقل يمكنه تغيير Base URL، ولماذا يتخطى Tab مفتاحك، وإعداد QCode.
دليل إعداد نموذج مخصص في Trae
كيف تملأ نموذجًا مخصصًا في Trae: تنسيق API، وURL الطلب، ومعرّف النموذج، ومفتاح API، إضافة إلى حد وضع Auto والأخطاء الشائعة.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من العبارات الواردة في هذه الصفحة في 2026-11-10 مقابل وثائق Qoder الرسمية وملاحظات الإصدار؛ وتكون الصفحات الرسمية هي المرجع. يصدر Qoder تحديثات متكررة، لذا تتبع أسماء القوائم والخيارات الإصدار الذي تثبته. وتتبع إتاحة نماذج QCode صفحة /models.