مزوّد ZCode المخصص: واجهة API خاصة بك لنماذج Claude وGPT والنماذج الصينية (نوفمبر 2026)
نعم. اعتبارًا من 2026-11-10، تقول صفحة Connect Models الرسمية لـ ZCode إنه يمكن إضافة مزوّد مخصص متوافق مع بروتوكولات Anthropic / OpenAI: في التطبيق المكتبي، انقر على Manage Models في أسفل منتقي النموذج لفتح Settings -> Model Settings، ثم انقر على Add Provider في أسفل قائمة المزوّدين، وأدخل نقطة النهاية ومفتاح API، ثم أضف معرّفات النماذج عبر Add Model. بعد الاختبار باستخدام ZCode CLI 0.17.1، تعمل بروتوكولات QCode الثلاثة جميعها دون تسجيل الدخول إلى حساب Z.ai أو BigModel: عنوان Base URL الخاص بـ Anthropic هو https://api.qcode.cc/api، ويستخدم كل من OpenAI Chat وResponses العنوان https://api.qcode.cc/openai/v1، والمفتاح هو مفتاح QCode الخاص بك ذو البادئة cr_.
آخر تحديث 2026-11-14
وجّه هذه الأداة إلى نقطة نهاية QCode — مفتاح واحد لـ Claude وGPT والنماذج الصينية.
- الفوترة حسب token — الأسعار المباشرة على /models
- الدفع بالبطاقة (Visa / Mastercard) أو Apple Pay أو Google Pay أو العملات الرقمية
- خدمة ذاتية: شحن الرصيد والتفعيل فورًا
أربع نقاط رئيسية: الوثائق الرسمية واختبار 2026-11-10
جميعها تنجح على CLI 0.17.1
اعتبارًا من 2026-11-10، تم الاختبار باستخدام ZCode CLI 0.17.1: anthropic-messages مع https://api.qcode.cc/api (claude-haiku-5-5)، وopenai-chat-completions وopenai-responses كلاهما مع https://api.qcode.cc/openai/v1 (deepseek-v4-flash، gpt-6.1-terra). أعادت الثلاثة ردًا دون تسجيل الدخول إلى حساب Z.ai أو BigModel.
عنوان Anthropic لا يتضمن /v1
في شيفرة ZCode المصدرية، يُضاف /v1 إلى عنوان Base URL الخاص بـ Anthropic الذي لا ينتهي بـ /v1، ثم يضيف SDK المسار /messages، لذا يطلب https://api.qcode.cc/api المسار /api/v1/messages. ويضيف OpenAI Chat وResponses المسار /chat/completions أو /responses مباشرة، لذا يستخدمان https://api.qcode.cc/openai/v1.
يستخدم التطبيق المكتبي وCLI ملفات إعدادات مختلفة
يحفظ التطبيق المكتبي المزوّدين في ~/.zcode/v2/config.json، مع baseURL ضمن خيارات المزوّد. ويقرأ CLI الملف ~/.zcode/v2/provider_config.json (وليس config.json) ويستخدم api.type وapi.baseUrl؛ وتشير وثائق CLI الرسمية إلى أن api.baseUrl يُكتب بشكل مختلف عن options.baseURL القديم.
أحدث إصدار اعتبارًا من 2026-11-10
أحدث إصدار على GitHub هو v3.17.2: يحدد README وسجل التغييرات تاريخه بـ 2026-11-03، ونُشر الإصدار في 2026-11-04 (UTC). مستودع zai-org/ZCode مرخّص بموجب Apache License 2.0، ويُبلّغ CLI المبني من مصدره عن الإصدار 0.17.1.
ما هو ZCode، وهل يمكنه استخدام مفتاح API الخاص بك؟
نعم. اعتبارًا من 2026-11-10، تقول صفحة Connect Models الرسمية لـ ZCode إنه يمكن إضافة أي خدمة نماذج متوافقة مع بروتوكولات Anthropic / OpenAI بوصفها مزوّدًا مخصصًا، بما في ذلك الخدمات العامة والقنوات التي تديرها الفرق والخدمات المستضافة ذاتيًا على شبكة خاصة. ZCode هو مساحة عمل مفتوحة المصدر للبرمجة بالذكاء الاصطناعي من Z.ai (Zhipu): تسميه الأسئلة الشائعة الرسمية بيئة تطوير وكيلية (ADE) جديدة متمركزة حول ZCode Agent الخاص بالجهة نفسها، ويصفه README بأنه «مساحة عمل للبرمجة بالذكاء الاصطناعي بواجهات سطح المكتب والمتصفح والطرفية». يدعم التطبيق المكتبي macOS (Apple Silicon / Intel) وWindows (x64 / ARM64) وLinux (AppImage، DEB، RPM)؛ ويبدأ إصدار سطر الأوامر بالأمر zcode، ويشغّل zcode --web واجهة الويب، وتوضح وثائق المستودع بناء CLI من المصدر. وتُدرج الصفحة الرسمية ثلاث طرق للحصول على نموذج: تسجيل الدخول بحساب Z.ai أو BigModel واستخدام حصة GLM Coding Plan الخاصة به مباشرة؛ أو تحويل صفحة Z.ai / BigModel إلى وضع API Key وإدخال مفتاح من تلك المنصة؛ أو إضافة مزوّد مخصص، حيث يُحتسب الاستخدام لدى الخدمة التي توجّه المزوّد إليها. ويستخدم QCode الطريقة الثالثة.
v3.17.2: أحدث إصدار اعتبارًا من 2026-11-10
اعتبارًا من 2026-11-10، أحدث إصدار على GitHub هو v3.17.2: يحدد README وسجل التغييرات تاريخه بـ 2026-11-03، ونُشر إصدار GitHub في 2026-11-04 (UTC). ويذكر سجل التغييرات لهذا الإصدار أنه لم يعد يُكتب فوق ملفات الإعدادات التالفة، ما يمنع فقدان البيانات. ويُبلّغ CLI المبني من الفرع main في المستودع عن الإصدار 0.17.1، وهو رقم مختلف عن إصدار التطبيق المكتبي؛ وهذا CLI هو البناء المستخدم في اختبار QCode بتاريخ 2026-11-10.
الجدول الزمني
أُنشئ مستودع zai-org/ZCode على GitHub.
صدر v3.17.2 (التاريخ في README وسجل التغييرات؛ ونُشر إصدار GitHub في 2026-11-04 UTC).
تمت مراجعة الوثائق الرسمية وREADME وReleases؛ ولا يزال v3.17.2 هو الأحدث. وبعد الاختبار باستخدام ZCode CLI 0.17.1، تعمل بروتوكولات QCode الخاصة بـ Anthropic وOpenAI Chat وResponses جميعها.
ما تنص عليه وثائق ZCode، وما يجيب عنه الاختبار وشيفرة المصدر
موثّق من ZCode
① إضافة مزوّد مخصص في تطبيق سطح المكتب: افتح الإعدادات -> إعدادات النموذج، وانقر على إضافة مزوّد في أسفل قائمة المزوّدين، وسمّه، وأدخل نقطة النهاية ومفتاح API، وأضف معرّفات النماذج يدويًا باستخدام إضافة نموذج، وشغّل مفتاح التمكين. ② مثال DeepSeek الرسمي: نقطة نهاية Anthropic https://api.deepseek.com/anthropic ونقطة نهاية OpenAI https://api.deepseek.com/v1. ③ في ملف سطح المكتب ~/.zcode/v2/config.json، لا يتعرف options الخاص بالمزوّد إلا على إعدادات الاتصال مثل apiKey وbaseURL وapiKeyRequired وheaders؛ أما المفاتيح الأخرى التي تُضاف يدويًا فتُتجاهل بصمت ولا تُكتب أبدًا في جسم الطلب. ④ وثائق CLI في المستودع: توجد المزوّدات الشخصية في ~/.zcode/v2/provider_config.json، وأنواع API هي openai-chat-completions وopenai-responses وanthropic-messages، ويُكتب api.baseUrl بشكل مختلف عن options.baseURL القديم. ⑤ تقول وثائق CLI نفسها إن الملف يحتفظ بالمفتاح بنص صريح، لذا قيّد صلاحياته وابقِه خارج Git. ⑥ تقبل بعض عمليات النشر من جهات خارجية حتى xhigh فقط، لذا يعيد أعلى مستوى للتفكير خطأ معامل 400؛ واختيار high يعمل. ⑦ يحافظ نموذج GLM نفسه على الصور في نقطة نهاية متوافقة مع Anthropic، لكنه يُعامل على أنه لا يدعم الصور في نقطة نهاية متوافقة مع OpenAI Chat. ⑧ بعد الإعداد، اختر القناة في محدّد النموذج وأرسل تعليمات اختبار قصيرة.
ما تتركه الوثائق مفتوحًا، يجيب عنه الاختبار والشيفرة المصدرية
اعتبارًا من 2026-11-10: ① كيفية ضم المسار: لا تذكر الوثائق ذلك؛ في الشيفرة المصدرية لـ ZCode، يُضاف /v1 إلى Base URL الخاص بـ Anthropic الذي لا ينتهي بـ /v1، ثم يضيف SDK المسار /messages، بينما يلحق OpenAI Chat وResponses المسار /chat/completions أو /responses مباشرة، لذا يستخدم QCode https://api.qcode.cc/api وhttps://api.qcode.cc/openai/v1. ② هل يجب عليك تسجيل الدخول إلى حساب Z.ai أو BigModel أولًا: باختبار ZCode CLI 0.17.1، يكفي إعداد المزوّد الشخصي وحده. ③ Responses: تعرض صفحة إعداد سطح المكتب بروتوكولي Anthropic وOpenAI ولا تحتوي على إدخال خاص بـ Responses؛ ويعمل نوع openai-responses في CLI في الاختبار، وذلك أيضًا باستخدام https://api.qcode.cc/openai/v1. ④ لا تزال طريقة اختيار تطبيق سطح المكتب غير موثقة عندما يملك المزوّد نفسه عنواني Anthropic وOpenAI، لذا فإن إعداد مزوّد واحد لكل بروتوكول هو الأوضح.
تطبيق سطح المكتب مقابل CLI: نقطتا دخول، وملفا إعداد
تطبيق سطح المكتب: أضف مزوّدًا في واجهة المستخدم
وفقًا للوثائق الرسمية: الإعدادات -> إعدادات النموذج ← إضافة مزوّد. بالنسبة إلى نقطتي نهاية Anthropic وOpenAI، استخدم العنوانين نفسيهما اللذين نجحا في اختبار CLI (https://api.qcode.cc/api وhttps://api.qcode.cc/openai/v1)، ثم أضف معرّفات النماذج باستخدام إضافة نموذج. يُحفظ الإعداد في ~/.zcode/v2/config.json، حيث تحمل options الخاصة بالمزوّد baseURL.
CLI: اكتب provider_config.json
يقرأ CLI الملف ~/.zcode/v2/provider_config.json، وليس ملف سطح المكتب config.json. لكل مزوّد قيمة واحدة لـ api.type: anthropic-messages مع https://api.qcode.cc/api، أو openai-chat-completions / openai-responses مع https://api.qcode.cc/openai/v1؛ يوضع المفتاح في access.apiKey والنماذج في personalModelIds. اعتبارًا من 2026-11-10، وبالاختبار باستخدام ZCode CLI 0.17.1، تعمل الأنواع الثلاثة جميعها.
كيفية ربط ZCode بـ QCode: خطوات سطح المكتب وCLI
سطح المكتب: ① ثبّت ZCode من zcode.z.ai (على macOS اسحب ZCode.app إلى مجلد Applications، وعلى Windows شغّل المثبّت، وعلى Linux استخدم AppImage أو DEB أو RPM). ② انقر على اسم النموذج في مربع الدردشة، ثم على إدارة النماذج في أسفل القائمة لفتح الإعدادات -> إعدادات النموذج. ③ انقر على إضافة مزوّد في أسفل قائمة المزوّدين، وسمّه QCode Claude، واضبط نقطة نهاية Anthropic على https://api.qcode.cc/api، وأدخل مفتاح cr_ الخاص بك، وأضف نماذج مثل claude-sonnet-5-5 باستخدام إضافة نموذج، وشغّل مفتاح التمكين. ④ أضف مزوّدًا ثانيًا، QCode OpenAI، بنقطة نهاية OpenAI https://api.qcode.cc/openai/v1 ونماذج مثل gpt-6.1-sol وdeepseek-v4-flash. ⑤ اختر نموذجًا في محدّد النموذج وأرسل تعليمات اختبار قصيرة. CLI: في ~/.zcode/v2/provider_config.json، أضف مزوّدًا ضمن providerRules، وضع مفتاح cr_ الخاص بك في access.apiKey، واضبط api.type على anthropic-messages وapi.baseUrl على https://api.qcode.cc/api (أو openai-chat-completions / openai-responses مع https://api.qcode.cc/openai/v1)، واذكر معرّفات النماذج في personalModelIds ووجّه defaultModelSelection إليه. يحتفظ الملف بالمفتاح بنص صريح، لذا قيّد صلاحياته وابقِه خارج Git.
تشغيل ZCode باستخدام مفتاح API الخاص بـ QCode
اعتبارًا من 2026-11-10، يمنحك مفتاح API واحد من QCode نقطتي نهاية متوافقتين مع كل من Anthropic وOpenAI: نماذج Claude على نقطة نهاية Anthropic https://api.qcode.cc/api، ونماذج GPT على نقطة نهاية OpenAI https://api.qcode.cc/openai/v1 (العنوان نفسه لـ Chat وResponses)، وعائلات GLM وKimi وDeepSeek وQwen على نقطة نهاية Anthropic أو OpenAI Chat. يُحتسب الاستخدام لكل token وفق أسعار لكل نموذج على /models؛ ومن معرّفات النماذج الشائعة: claude-sonnet-5-5، claude-opus-5-5، gpt-6.1-sol، deepseek-v4-pro، glm-5.3، kimi-k3 وqwen3.8-max. ثلاث خطوات: ① أنشئ حسابًا واشحن الرصيد (Alipay وطرق الدفع الرئيسية الأخرى مدعومة)؛ ② اشترِ خطة شخصية أو باقة الدفع حسب الاستخدام وانسخ مفتاح API الخاص بك، الذي يبدأ بـ cr_؛ ③ أضف المزوّدين في ZCode كما سبق؛ يستعرض مقال وثائق QCode https://docs.qcode.cc/en/docs/ide/zcode الإعداد نفسه. ألست مستعدًا لخطة شهرية؟ تبدأ باقات الدفع حسب الاستخدام (/pay-as-you-go) من $4 مقابل حصة تُستخدم لمرة واحدة خلال 7 أيام؛ إذا كانت لديك خطة شخصية بالفعل، فأضف باقة تعزيز عندما تحتاج إلى المزيد من الحصة.
الأسئلة الشائعة
هل يمكن لـ ZCode استخدام مفتاح API الخاص بي؟
نعم. تقول صفحة Connect Models الرسمية في ZCode إنه يمكن إضافة أي خدمة نماذج متوافقة مع بروتوكولي Anthropic / OpenAI بوصفها مزوّدًا مخصصًا: اختر إضافة مزوّد، وأدخل نقطة النهاية ومفتاح API، ثم أضف معرّفات النماذج يدويًا عبر إضافة نموذج. اعتبارًا من 2026-11-10، وبعد الاختبار باستخدام ZCode CLI 0.17.1، تعمل بروتوكولات QCode الثلاثة مباشرة: عنوان Base URL الخاص بـ Anthropic هو https://api.qcode.cc/api، ويستخدم OpenAI Chat وResponses العنوان https://api.qcode.cc/openai/v1، والمفتاح هو مفتاح QCode الخاص بك الذي يبدأ بـ cr_؛ ويُحتسب الاستخدام لكل token وفق أسعار لكل نموذج على /models.
أين يمكنني إعداد نموذج مخصص في ZCode؟
سطح المكتب: انقر على اسم النموذج في مربع الدردشة، ثم انقر على إدارة النماذج أسفل محدّد النموذج لفتح الإعدادات -> إعدادات النموذج، ثم انقر على إضافة مزوّد أسفل قائمة المزوّدين؛ عند أول تشغيل دون نموذج قابل للاستخدام، يؤدي استخدام مفتاح API في شاشة الترحيب أيضًا إلى إعدادات النموذج. CLI: حرّر ~/.zcode/v2/provider_config.json، وليس ~/.zcode/v2/config.json الخاص بسطح المكتب، وضع العنوان في api.baseUrl بدلًا من options.baseURL. وتقول وثائق CLI الرسمية أيضًا إن ZCODE_BASE_URL يتعلق بنقطة نهاية خدمة المنتج نفسه، لذا لا يوضع عنوان API الخاص بالنموذج هناك.
هل يمكن لـ ZCode استخدام Claude؟
يدعم المزوّد المخصص في ZCode بروتوكول Anthropic، لذا يمكنك إدخال Base URL الخاص بـ Anthropic لدى QCode وهو https://api.qcode.cc/api واستدعاء نماذج Claude؛ اعتبارًا من 2026-11-10، استجاب claude-haiku-5-5 مباشرةً في اختبار باستخدام ZCode CLI 0.17.1، كما يوجد claude-sonnet-5-5 وclaude-opus-5-5 على /models أيضًا. تُقدَّم نماذج Claude على هذا العنوان فقط؛ وتستخدم نماذج GPT عنوان Base URL الخاص بـ OpenAI https://api.qcode.cc/openai/v1.
هل يحتاج Base URL في ZCode إلى /v1؟
لا بالنسبة إلى Anthropic، ونعم بالنسبة إلى OpenAI. يضيف مصدر ZCode /v1 إلى Base URL الخاص بـ Anthropic إذا لم يكن ينتهي به بالفعل، ثم يضيف SDK المسار /messages، لذا أدخل https://api.qcode.cc/api (وفقًا للمصدر، يصل https://api.qcode.cc/api/v1 إلى المسار نفسه /api/v1/messages). ويضيف OpenAI Chat وResponses المسار /chat/completions أو /responses مباشرةً، لذا أدخل https://api.qcode.cc/openai/v1. اعتبارًا من 2026-11-10، اجتازت الثلاثة جميعًا اختبارًا باستخدام ZCode CLI 0.17.1؛ واترك أي شرطة مائلة لاحقة خارج العنوان.
هل يدعم ZCode Responses أو Gemini؟
يدعم CLI استخدام Responses: اضبط api.type على openai-responses وapi.baseUrl على https://api.qcode.cc/openai/v1؛ اعتبارًا من 2026-11-10، نجح ذلك في اختبار باستخدام ZCode CLI 0.17.1 (gpt-6.1-terra). تعرض صفحة إعدادات سطح المكتب بروتوكولي Anthropic وOpenAI دون وجود إدخال خاص بها لـ Responses؛ وبالنسبة إلى نماذج GPT في تطبيق سطح المكتب، أدخل نقطة نهاية OpenAI https://api.qcode.cc/openai/v1. لا تتضمن أنواع API في وثائق ZCode نوعًا لـ Gemini؛ وعلى QCode يمكنك استخدام Claude وGPT وعائلات GLM وKimi وDeepSeek وQwen، مع معرّفات النماذج على /models.
يعيد ZCode رمز 400 أو 404 مع QCode، فماذا الآن؟
طابِق الخطأ. model_not_available_on_endpoint: أُضيف نموذج Claude إلى المزوّد ذي عنوان OpenAI؛ ضع نماذج claude-… في المزوّد الذي عنوانه https://api.qcode.cc/api. خطأ في المعامل 400 عند أعلى مستوى للتفكير: تقول الوثائق إن بعض عمليات النشر من طرف ثالث لا تقبل إلا حتى xhigh، فاختر high. خطأ 404: من الأسباب الشائعة وجود شرطة مائلة زائدة في النهاية، مما يحوّل المسار إلى //v1/messages؛ أدخل /api و/openai/v1 تمامًا كما هو مذكور أعلاه. الصور تُسقَط: في المثال الرسمي، يُبقي النموذج GLM نفسه الصور على نقطة نهاية متوافقة مع Anthropic، لكنه يُعامَل على أنه لا يدعم الصور على نقطة نهاية متوافقة مع OpenAI Chat؛ وبالنسبة إلى نموذج مخصص، صرّح بقدرته على الصور في إعداد النموذج.
المصادر
ZCode: صفحات Connect Models والتثبيت والأسئلة الشائعة وسجل التغييرات على zcode.z.ai، وصفحة ZCode على docs.bigmodel.cn، وREADME وLICENSE ودليل استخدام CLI ووثيقة الإعداد، والدالة normalizeAnthropicBaseURL في الشيفرة المصدرية، وبيانات المستودع وReleases في zai-org/ZCode على GitHub، وكلها قُرئت في 2026-11-10. الاختبار: 2026-11-10، ZCode CLI 0.17.1 مبني من مصدر المستودع. QCode: qcode.cc/models، وqcode.cc/pricing، وqcode.cc/pay-as-you-go، وصفحة Endpoints & API Paths على docs.qcode.cc، استُرجعت في 2026-11-10.
شغّل ZCode باستخدام مفتاحك الخاص
ضع مفتاح API واحدًا من QCode في مزوّد مخصص في ZCode: نقطة نهاية Anthropic لـ Claude، ونقطة نهاية OpenAI لـ GPT، وأي منهما للنماذج الصينية؛ تُحتسب التكلفة لكل token، مع أسعار لكل نموذج على /models.
قراءات ذات صلة
باقات الدفع حسب الاستخدام
باقات حصة لمرة واحدة صالحة لمدة 7 أيام، بدون اشتراك؛ وتضاف الباقات الإضافية إلى المفتاح نفسه
Claude Code مع النماذج الصينية: دليل الإعداد
مفتاح cr_ واحد لـ DeepSeek وGLM وKimi وQwen في Claude Code: العنوان نفسه، وبدّل باستخدام /model.
دليل إعداد النموذج المخصص في Trae
كيف تملأ نموذجًا مخصصًا في Trae: تنسيق API، وعنوان URL للطلب، ومعرّف النموذج، ومفتاح API، إضافة إلى حد وضع Auto والأخطاء الشائعة.
دليل الدفع بالعملات المشفرة
تسع عملات، و56 شبكة، وبدون رسوم منصة لرصيد API للبرمجة بالذكاء الاصطناعي.
تم التحقق من العبارات الواردة في هذه الصفحة في 2026-11-10 مقابل وثائق ZCode والمستودع والشيفرة المصدرية، واختُبرت عناوين QCode باستخدام ZCode CLI 0.17.1؛ والصفحات الرسمية هي المرجع. تتبع أسماء القوائم والخيارات الإصدار الذي تثبّته، وتتبع إتاحة نماذج QCode المسار /models.