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

التنقل

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

الفئات

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

الأدوات

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

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

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

ما هي 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)"مطالبات" في نوافذ 5 ساعات + سقف أسبوعي1
Pro$72×4 عن Lite1
Max$160×16 عن Liteحتى 30

ما يشتكي منه المشتركون (سلاسل Hacker News وGitHub):

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

الاستنتاج بسيط: بالنسبة للتطوير الفردي الهادئ، يعمل الاشتراك بأمانة. ولكن كلما كان وضعك أكثر "عاملية" (تعدد المهام، جلسات ذاتية طويلة، عمليات ليلية) — كلما تحول نموذج الحصص إلى يانصيب. البديل هو الدفع مقابل الرموز الفعلية: بدون نوافذ زمنية أو مضاعفات أو طوابير انتظار — ما يستهلكه الوكيل يتم خصمه فقط. هذا بالضبط هو النموذج الذي يوفره آلية custom provider المدمجة في ZCode، ويتم إعداده في خمس دقائق.

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

يدعم ZCode رسمياً خاصية BYOK: تسمح الوثائق صراحةً بإضافة "أي خدمة متوافقة مع بروتوكولات OpenAI أو Anthropic" — واجهات برمجة التطبيقات العامة، قنوات الشركات، وحتى تثبيتات 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 فقط من خلال نقطة النهاية https://api.z.ai/api/coding/paas/v4؛ أما النقطة العامة /api/paas/v4 مع مفتاح الاشتراك ستعيد خطأ — وهو السبب الكلاسيكي لرسالة "لدي خطأ 401/429 رغم دفع الاشتراك".
  • «العمل في Claude Code ≠ العمل في ZCode». لا يقرأ ZCode متغيرات البيئة مثل ANTHROPIC_BASE_URL التي يتم بها إعداد Claude Code: لديه مخزن خاص لإعدادات المزودين. قم بالتكوين من خلال الإعدادات (Settings) حصراً.
  • «النموذج يظهر في المحدد ≠ المفتاح لديه رصيد». يتم جلب قائمة النماذج من API المزود، ولكن التوفر يعتمد على الرصيد وحدود المفتاح المحدد.

الخطوة التالية هي الممارسة: توصيل بوابة JoinGonka بـ ZCode والحصول على حزمة GLM مقابل الرموز الرقمية (tokens).

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

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

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

الخطوةالإجراء
1. المفتاحسجل — gate.joingonka.ai/register (الحسابات الجديدة تحصل على 10M توكن مجاني)، أنشئ مفتاح API في قسم Keys. المزيد من التفاصيل — في API Quick Start.
2. المزودZCode → Settings → Model Settings → Add Provider. Name: JoinGonka
3. Base URLhttps://gate.joingonka.ai/v1
4. مفتاح APIمفتاحك بصيغة jg-…
5. صيغة APIChat completions (/chat/completions)
6. النموذجAdd Model → Model ID deepseek-ai/DeepSeek-V4-Flash-0731، نافذة السياق 380000. يتم إضافة moonshotai/Kimi-K2.6 و MiniMaxAI/MiniMax-M2.7 بنفس الطريقة؛ القائمة المحدثة — 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 — قم بتغيير مستوى التفكير إلى High وأعد المحاولة.

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

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

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

القناةالإدخال، $/1Mالإخراج، $/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)$0.93$3.00لكل رمز؛ لا يوجد خيار مجاني لـ GLM-5.2
JoinGonka Gateway$0.0032$0.0097لكل رمز، شبكة Gonka

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

إخلاء مسؤولية صادق بشأن GLM-5.2: ستحدد الشبكة السعر الدقيق للنموذج في وقت التفعيل (الجدول أعلاه يوضح السعر المباشر الحالي لنماذج الشبكة). يتم تحديث الأرقام الموجودة في هذه الصفحة تلقائياً، ولا داعي لإعادة الحساب يدوياً.

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

تمت إضافة النموذج zai-org/GLM-5.2-FP8 بالفعل إلى سجل الـ on-chain لشبكة Gonka: يحدد الإعداد نافذة سياق تصل إلى 400K رمز، والنموذج نفسه من النماذج الثقيلة (تحتاج النسخة الواحدة إلى أكثر من تيرابايت من ذاكرة الفيديو VRAM). الآن تجري عملية الطرح: عقد الشبكة تقوم بتسخين الأوزان. بمجرد أن تصبح الفحوصات خضراء، سيظهر النموذج تلقائياً في قائمة نماذج البوابة — عنوان الـ base URL والمفتاح لا يتغيران، في ZCode يكفي اختياره من محدد النماذج.

حول النموذج نفسه: أوزان مفتوحة بموجب ترخيص MIT، معمارية MoE بحوالي 750B معلمة (حوالي 40B نشطة لكل رمز)، نافذة أصلية تصل إلى 1M رمز. وفقاً لبيانات Z.ai، في SWE-bench Pro يحقق النموذج 62.1 — أعلى من GPT-5.5، وفي FrontierSWE يتأخر عن Claude Opus 4.8 بنسبة واحد بالمائة تقريباً. بالنسبة لنموذج بوزن مفتوح، هذا هو الصف الأول في البرمجة.

أسئلة شائعة:

  • لماذا تظهر أخطاء 429 فور تشغيل نموذج جديد؟ — هذه مرحلة الطرح: لا تزال بعض العقد تحمل الأوزان. أعد محاولة الطلب بعد بضع ثوانٍ — سيجد موازن التحميل عقدة نشطة.
  • ما هو المتاح اليوم؟ — Kimi K2.6 و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 Gateway كمزود مخصص (custom provider) وادفع مقابل الرموز المميزة الفعلية بأسعار شبكة Gonka اللامركزية، وهي أقل بمئات المرات من واجهات برمجة التطبيقات المركزية. GLM-5.2 موجود بالفعل في سجل الشبكة وسيظهر في محدد النماذج الخاص بك تلقائيًا، بينما تعمل Kimi K2.6 و MiniMax M2.7 و DeepSeek V4 Flash اليوم. ابدأ بـ 10 ملايين رمز مجاني.

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

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

احصل على 10M توكن مجانية →