أقسام قاعدة المعرفة ▾

التنقل

▸ ابدأ من هنا حسب الدور

الفئات

أدوات 52
قاموس المصطلحات 12

الأدوات

ZCode: استنتاج GLM رخيص بدلاً من GLM Coding Plan

في يونيو 2026، أصدرت Z.ai برنامج ZCode 3.0 — وهي بيئة تطوير برمجية تعتمد على الوكلاء (agentic environment) لسطح المكتب، والتي تصفها الشركة نفسها بأنها "Official Harness for GLM-5.2". جذب المنتج الانتباه بسرعة: نواة وكيل خاصة، مهام ذاتية عبر /goal، وضع تعدد الوكلاء (multi-agent)، والتحكم عن بعد في الجلسات مباشرة من Telegram. ولكن مع موجة المراجعات جاءت موجة من الأسئلة من أوائل المشتركين في خطة GLM Coding Plan: يتم حساب الحصة بـ "المطالبات" (prompts) في نوافذ زمنية مدتها خمس ساعات، وفي ساعات الذروة يتضاعف الاستهلاك ثلاث مرات، وفي الخطط الأقل توجد طلب واحد متوازٍ فقط، وتتوالى الشكاوى على Hacker News بشأن الحظر المفاجئ بعد يوم عمل حافل.

الخبر السار: يدعم ZCode رسمياً custom provider — حيث يمكنك ربط أي API متوافق مع OpenAI أو Anthropic به والدفع مقابل الرموز الفعلية بدلاً من حصص الاشتراك. في هذا الدليل، سنشرح ما هو ZCode وكيف تعمل خطة GLM Coding Plan، ثم سنقوم خطوة بخطوة بإعداد ZCode على JoinGonka Gateway — بوابة شبكة Gonka اللامركزية، التي تخدم GLM-5.3 Flash — وهو نموذج استنتاج مفتوح من Z.ai نفسها. النتيجة: نفس الأداة، نفس النماذج مفتوحة الوزن، ولكن اقتصاديات تعتمد على الرموز وأرخص بعدة أضعاف من واجهات برمجة التطبيقات المركزية.

ما هي ZCode: بيئة التطوير العاملة من Z.ai

ZCode ليست مجرد "محرر بشريط جانبي للدردشة" بل هي ADE: أنت تصف الهدف، ويقوم الوكيل ببناء الخطة وتعديل الملفات وتشغيل الاختبارات والتكرار حتى الوصول إلى النتيجة. تعمل كتطبيق سطح مكتب على macOS وWindows (نسخة Linux لا تزال في مرحلة تجريبية).

الميزات الرئيسية للإصدار 3.0:

  • ZCode Agent — نواة عاملة خاصة مع تكامل عميق لنموذج GLM-5.2؛ بالإضافة إليه يمكنك توصيل وكلاء تابعين لجهات خارجية (Claude Code, Codex, Gemini CLI وغيرها)؛
  • وضع الهدف (/goal) — مهام ذاتية طويلة: خطة → تنفيذ → تحقق خطوة بخطوة؛
  • Multi-agent — عمل متزامن للعديد من الوكلاء في مشروع واحد؛
  • التحكم عن بعد — إطلاق ومراقبة الجلسات من Telegram وWeChat وFeishu: يعمل الوكيل على جهازك، وأنت تجيب على الأسئلة من هاتفك.

العميل نفسه مجاني، وتمنح Z.ai المستخدمين الجدد حصة يومية من رموز GLM-5.2 للاطلاع عليها. بعد ذلك — إما اشتراك GLM Coding Plan أو استخدام مفتاح API الخاص بك. وهنا يجب الخوض في التفاصيل، لأن هيكل الاشتراك هو الجزء الأكثر مناقشة في المنتج.

GLM Coding Plan: السعر والقيود والحصص

GLM Coding Plan هو اشتراك Z.ai، يمنح الوصول إلى نماذج GLM في ZCode وفي أكثر من عشرين أداة خارجية. وقت النشر (يوليو 2026)، تبدو الشبكة الأساسية هكذا — لكن الأسعار والعروض تتغير، فتحقّق من صفحة z.ai/subscribe الحية:

الخطةالسعر، $/شهرالحصةالطلبات المتوازية
Lite$18 (بالعروض — من ~$12.6)«Prompts» في نوافذ 5 ساعات + سقف أسبوعي1
Pro$72×4 مقارنة بـ Lite1
Max$160×16 مقارنة بـ Liteحتى 30

ممّ يشكو المشتركون (خيوط Hacker News وGitHub):

  • مضاعف الذروة. في ساعات الذروة (14:00—18:00 UTC+8 — مساء آسيا، صباح-ظهر أوروبا) يخصم كل طلب من الحصة بمعامل ×3، وخارج الذروة ×2. عليك تخطيط الاستهلاك حسب توقيت بكين.
  • الحصة محسوبة بـ «prompts» لا بـ tokens. كم بقي بالضبط من tokens — غير شفاف؛ وفي الخيوط قصص من نوع «استهلكت ~17M token على GLM — فحصلت على حظر أربعة أيام».
  • طلب متوازٍ واحد فقط في Lite وPro. في بيئة الـ agent يعدّ هذا ملموسًا: وضع multi-agent في ZCode نفسه وأي sub-agents متوازية تصطدم بالطابور.
  • GLM-5.2 يستهلك الحصة أسرع من النماذج الأصغر — العلم يحرق الحد بمضاعفه الخاص.

الخلاصة بسيطة: لتطوير فردي هادئ، يعمل الاشتراك بصدق. لكن كلما صار وضعك أكثر «agent» — مهام متوازية، جلسات مستقلة طويلة، تشغيلات ليلية — تحوّل نموذج الحصص أكثر إلى يانصيب. البديل هو الدفع مقابل الرموز الفعلية: بلا نوافذ ولا مضاعفات ولا طوابير — ما استهلكه الـ agent، يُخصم مثله. هذا بالضبط النموذج الذي توفره آلية custom provider المدمجة في ZCode، وتُضبط في خمس دقائق.

BYOK في ZCode: مفتاح API الخاص بك وcustom provider

يدعم ZCode رسمياً وبنائياً خاصية BYOK: تسمح الوثائق صراحةً بإضافة "أي خدمة متوافقة مع بروتوكولات OpenAI أو Anthropic" — واجهات API العامة، والقنوات المؤسسية، وحتى النشرات self-hosted. يمكن الإعداد بثلاث طرق:

  • زر Connect في شاشة الترحيب → "Set Your API Key"؛
  • Manage Models في محدد النموذج؛
  • أيقونة الترس → Settings → Model Settings → Add Provider.

يُضبط للمزوّد حقل OpenAI Base URL و/أو Anthropic Base URL بالإضافة إلى API Key — وسيسحب ZCode قائمة النماذج المتاحة تلقائياً.

ثلاث عقبات يتعثر بها معظم المستخدمين:

  • نقاط نهاية Z.ai تختلف. اشتراك Coding Plan يعمل فقط عبر coding-endpoint https://api.z.ai/api/coding/paas/v4؛ أما المسار العام /api/paas/v4 مع مفتاح اشتراك فسيُرجع خطأ — وهذا هو السبب الكلاسيكي لعبارة "أواجه 401/429 رغم أن الاشتراك مدفوع".
  • "يعمل في Claude Code ≠ يعمل في ZCode". متغيرات البيئة مثل ANTHROPIC_BASE_URL التي يُضبط بها Claude Code لا يقرأها ZCode: فلديه مخزن إعدادات خاص به للمزوّدين. قم بالإعداد مباشرة عبر Settings.
  • "النموذج يظهر في المحدد ≠ المفتاح لديه حصة". تُسحب قائمة النماذج من API المزوّد، أما التوفر فيعتمد على الرصيد وحدود المفتاح المحدد.

والآن إلى الجانب العملي: نوصّل بوابة JoinGonka بـ ZCode ونحصل على مجموعة نماذج GLM مقابل التوكنات.

إعداد بوابة JoinGonka في ZCode: GLM مقابل الرموز الرقمية

JoinGonka Gateway — بوابة إلى شبكة Gonka اللامركزية مع بروتوكولين أصليين: /v1/chat/completions المتوافق مع OpenAI و /v1/messages الخاص بـ Anthropic. الاقتصاد يعتمد على الدفع لكل توكن (pay-per-token): لا توجد نوافذ زمنية مدتها 5 ساعات، ولا مضاعفات ذروة ×3، ولا حدود لطلب متزامن واحد؛ يمكن رؤية الاستهلاك في لوحة التحكم في الوقت الفعلي، والبوابة لا تخزن محتوى المطالبات (prompts).

خطوة بخطوة (واجهة Custom Provider الحالية):

الخطوةالإجراء
1. المفتاحسجّل — gate.joingonka.ai/register (الحسابات الجديدة تحصل على 3M توكن مجاني)، أنشئ مفتاح API في قسم Keys. تفاصيل أكثر في API Quick Start.
2. المزودZCode → Settings → Model Settings → Add Provider. Name: JoinGonka
3. Base URLhttps://gate.joingonka.ai/v1
4. API Keyمفتاحك بصيغة jg-…
5. API formatChat completions (/chat/completions)
6. النموذجAdd Model → Model ID deepseek-ai/DeepSeek-V4-Flash-0731, Context window 380000. يتم إضافة MiniMaxAI/MiniMax-M2.7 و zai-org/GLM-5.3-Flash بنفس الطريقة — نموذج الاستدلال (reasoning) الخاص بـ Z.ai؛ القائمة الحالية والحدود — GET /v1/models.

في إصدارات ZCode القديمة، توجد بدلاً من ذلك خانتان منفصلتان: OpenAI Base URL (https://gate.joingonka.ai/v1) و Anthropic Base URL (https://gate.joingonka.ai — العميل سيضيف المسار بنفسه).

التحقق: اختر النموذج الذي أنشأته واسأل الوكيل (agent) أي سؤال. إذا وصل الرد — كل شيء يعمل؛ خطأ 401 — تحقق من المفتاح، 402 — رصيد الحساب. إذا ظهر «Model request failed» على DeepSeek V4 Flash عند مستوى Thought Level Max — قم بتحويل Thought Level إلى High وأعد المحاولة.

تلميح. الأمر npx @joingonka/setup --tool zcode سيطبع القيم الجاهزة لهذه الخانات — الـ base URL، المفتاح، معرف النموذج وحدوده الفعلية: نافذة السياق وسقف الاستجابة — وسيتحقق بطلب مباشر من أن البوابة تقبلها. يتم إعداد ZCode نفسه عبر واجهة المستخدم فقط — لا يحتوي على ملف يمكن تعديله بأمان، لذا يجب إدخال القيم يدوياً.

مقارنة الأسعار: Coding Plan، Z.ai API، OpenRouter و Gonka

تكلفة استنتاج GLM (GLM-inference) عبر قنوات مختلفة (الأسعار لكل 1 مليون توكن؛ أسعار المنافسين مسجلة لشهر سبتمبر 2026، أما سعر JoinGonka فيتم إدراجه في الصفحة مباشرة من API البوابة):

القناةالمدخلات (Input)، $/1Mالمخرجات (Output)، $/1Mنموذج الدفع
Z.ai API (GLM-5.2)$1.40 (المدخلات المخزنة مؤقتاً — $0.26)$4.40لكل توكن
GLM Coding Plan$18—160/شهراشتراك: حصص «المطالبات»، مضاعف ×3 في وقت الذروة، حدود التوازي
OpenRouter (z-ai/glm-5.2)$1.40$4.40لكل توكن
OpenRouter (z-ai/glm-5.3-flash)$0.09$0.30لكل توكن
JoinGonka Gateway$0.0069$0.021لكل توكن، شبكة Gonka

الفارق الذي يصل لمرتبتين أو ثلاث ليس تقريباً تسويقياً، بل هو اقتصاد مختلف: العمليات الحسابية يقوم بها المشاركون في الشبكة اللامركزية، الذين يربحون من العمل نفسه وليس من هوامش أرباح مركز البيانات. تحليل مفصل لكيفية عمل ذلك وحدود التطبيق — في المقالة حول أرخص API للذكاء الاصطناعي.

سطر JoinGonka هو سعر GLM-5.3 Flash في شبكة Gonka: جميع نماذج الشبكة لديها تعريفة موحدة. يتم تحديث الأرقام في هذه الصفحة تلقائياً، ولن تضطر لإعادة الحساب يدوياً.

GLM في شبكة Gonka: GLM-5.3 Flash والأسئلة الشائعة

تخدم شبكة Gonka نموذج Z.ai: تم اعتماد zai-org/GLM-5.3-Flash عبر مقترح الحوكمة #101 ويتم توفيره عبر البوابة جنباً إلى جنب مع MiniMax M2.7 و DeepSeek V4 Flash. نموذج GLM-5.2 الرئيسي، الذي تمت الإشارة إليه في النسخ الأولى من هذا الدليل، لم يدخل في الخدمة الفعلية حيث اختارت الشبكة نموذجاً أخف وأسرع من نفس العائلة. رابط الأساس (Base URL) والمفتاح هما نفس الشيء: في ZCode يكفي إضافة النموذج في custom provider.

حول النموذج نفسه: أوزان مفتوحة تحت ترخيص MIT، بنية MoE بـ 320B من المعايير (18B نشطة لكل رمز)، انتباه هجين متناثر وخطي. الميزة الرئيسية هي كونه نموذج reasoning: قبل الإجابة يقوم النموذج بالتفكير، وتستغرق عملية التفكير عدة مئات من الرموز (tokens) حتى في الأسئلة البسيطة. بالنسبة لـ ZCode، هذا يعني أمرين: لا تقلل من حد طول الإجابة في إعدادات النموذج (من 600 رمز حتى للردود القصيرة) وللتعديلات السريعة قم بخفض مستوى التفكير (Thought Level) — على مستوى API يكون reasoning_effort: low. تحليل مفصل للنموذج وحدوده موجود في المقال GLM-5.3 Flash في شبكة Gonka.

أسئلة متكررة:

  • لماذا قد تظهر أخطاء 429 أو طوابير انتظار في النموذج الجديد؟ — يخدم النموذج حالياً جزء صغير من مضيفي الشبكة؛ في دقائق الذروة قد تنتظر الطلبات توفر فتحة شاغرة. أعد المحاولة بعد بضع ثوانٍ — سيجد موازن التحميل عقدة نشطة. الحالة الحالية موجودة على صفحة حالة البوابة.
  • ما المتاح أيضاً؟ — بالإضافة إلى GLM-5.3 Flash هناك MiniMax M2.7 و DeepSeek V4 Flash: تعمل النماذج الثلاثة في ZCode عبر نفس الـ custom provider، والتكوين الوارد في هذا الدليل يعمل بالكامل.
  • ماذا عن الخصوصية؟ — البوابة لا تخزن محتوى المطالبات (prompts) أو الإجابات؛ الإحصائيات تحتوي فقط على بيانات مجمعة للاستهلاك.
  • متى تكون خطة Coding Plan أكثر ربحية؟ — إذا كنت تعمل بمفردك، وتلتزم بحصة Lite ولا تشغل وكلاء متوازيين، فإن الاشتراك بمبلغ ثابت يكون مريحاً ويمكن التنبؤ به. احسب وفقاً لملفك الشخصي: عند العمل النشط للوكلاء، يكون الدفع مقابل الرموز عبر الشبكة أرخص بمراحل، أما عند تعديلات الكود الخفيفة بضع مرات يومياً فقد لا تشعر بالفرق.
  • هل هذا مناسب لأدوات أخرى؟ — نعم: نفس الـ endpoint يعمل في Claude Code و Cursor و Cline وأي عميل متوافق مع OpenAI/Anthropic.
ZCode 3.0 هي IDE متطورة للوكلاء، لكن اشتراكها الأصلي GLM Coding Plan يعمل بنظام الحصص: "مطالبات" في نوافذ 5 ساعات، ومضاعف ×3 في ساعات الذروة، وطلب متوازي واحد في الخطط المبتدئة. كلما زاد عبء الوكلاء، أصبح الأمر أكثر تكلفة وغير متوقع. خاصية BYOK الرسمية تحل المشكلة: اربط بوابة JoinGonka كـ custom provider — وادفع مقابل الرموز الفعلية بأسعار شبكة Gonka اللامركزية، وهي أرخص بمئات المرات من الـ API المركزية. GLM-5.3 Flash — نموذج الاستدلال المفتوح الخاص بـ Z.ai — مدعوم بالفعل من الشبكة، بجانبه MiniMax M2.7 و DeepSeek V4 Flash. ابدأ بالرموز الترحيبية المجانية.
← أرخص واجهة برمجة تطبيقات (API) لوكلاء AI في 2026 JetBrains IDE + JoinGonka Gateway — endpoint الخاص بك بدلاً من الرصيد →

تريد معرفة المزيد؟

استكشف الأقسام الأخرى أو ابدأ في كسب GNK الآن.

الحصول على رموز مجانية →