كيفية استخدام GLM-5.2 مع كود كلود وكلاين والمؤشر

GLM-5.2 هو نموذج ترميز مفتوح الأوزان من Z.ai، ويتصل بأدوات الترميز الثلاث التي يستخدمها معظم المطورين بالفعل: Claude Code، Cline، وCursor. المشكلة هي أن كل واحدة تتصل بطريقة مختلفة. يستخدم Claude Code تنسيق Anthropic API، بينما تتطلب Cline وCursor نقطة نهاية متوافقة مع OpenAI. يرشدك هذا الدليل عبر الأدوات الثلاث، من البداية إلى النهاية، باستخدام خطة ترميز GLM كأساس.

إذا كنت تريد حقائق النموذج أولاً، فابدأ بـ نظرة عامة على GLM-5.2 ومرجع واجهة برمجة تطبيقات GLM-5.2. هذه المقالة هي دليل الاتصال.

button

ما تحتاجه قبل أن تبدأ

GLM-5.2 هو نموذج "مزيج الخبراء" (Mixture-of-Experts) بحوالي 753 مليار معلمة، ويُقدم مع نافذة سياق بحجم 1 مليون توكن (1,048,576 توكن بالضبط). إنه موجه للترميز أولاً، مع قدرة قوية على الاستدلال واستخدام الأدوات كوكيل. المعيار الرئيسي، وفقًا لـالنتائج المنشورة لـ Z.ai، هو Terminal-Bench 2.1 عند 81.0، بزيادة عن GLM-5.1 الذي كان 62.0. وصفتها VentureBeat بأنها تتفوق على GPT-5.5 في معايير الترميز طويلة الأفق بحوالي سدس التكلفة.

لمتابعة هذا الدليل تحتاج إلى:

حساب Z.ai ومفتاح API. بالنسبة لـ Claude Code وأدوات الوكيل، ستحتاج إلى مفتاح خطة ترميز GLM بدلاً من مفتاح الدفع حسب الاستخدام الخام، حيث أن نقطة نهاية الترميز هي ما ترتبط به هذه المفاتيح.
إحدى أدوات الترميز الثلاث المثبتة: Claude Code، Cline (إضافة VS Code)، أو Cursor.
معرف النموذج (model id)، وهو glm-5.2 في كل مكان باستثناء داخل Claude Code، حيث تستخدم المتغير ذو السياق 1M وهو glm-5.2[1m].

ملاحظة سريعة حول التكلفة. تكلفة واجهة برمجة التطبيقات القياسية هي 1.40 دولار لكل مليون توكن إدخال و 4.40 دولار لكل مليون توكن إخراج (تم التأكيد بواسطة OpenRouter)، مع إدخال مخبأ بحوالي 0.26 دولار لكل مليون (وفقًا لـ VentureBeat). خطة ترميز GLM هي اشتراك منفصل مع مستويات Lite و Pro و Max و Team. تحركت أسعار المستويات العامة، لذا اعتبر أي رقم تراه تقريبيًا (اعتبارًا من يونيو 2026، تحقق من الأسعار الحالية على z.ai قبل الالتزام).

إعداد GLM-5.2 في Claude Code

Claude Code يتصل بنقطة نهاية متوافقة مع Anthropic، وZ.ai توفر واحدة خصيصًا لأدوات الترميز. يمكنك توجيه Claude Code إلى نقطة النهاية هذه باستخدام متغيرات البيئة، ثم تشغيله بشكل طبيعي.

هنا الكتلة الكاملة. ضعها في ملف تعريف Shell الخاص بك (~/.zshrc أو ~/.bashrc)، أو قم بتعيينها مباشرة قبل التشغيل.

export ANTHROPIC_BASE_URL="https://api.z.ai/api/coding/paas/v4"
export ANTHROPIC_API_KEY="your-glm-coding-plan-key"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2[1m]"
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000
export API_TIMEOUT_MS=3000000

ثم قم بتشغيل Claude Code بالطريقة المعتادة:

claude

تستحق بعض هذه المتغيرات شرحًا، لأن تخطيها هو ما يتسبب في تعطل معظم الإعدادات.

عنوان URL الأساسي. https://api.z.ai/api/coding/paas/v4 هو نقطة نهاية الترميز المتوافقة مع Anthropic. تعرض بعض المقالات القديمة https://open.z.ai/api/paas/v4 بدلاً من ذلك. كلاهما تم تداولهما، لذا إذا فشلت الطلبات (404) أو فشل المصادقة، فجرّب المضيف الآخر وتحقق من القيمة الحالية في وثائق Z.ai GLM-5.2 (تحقق مباشرة).

اللاحقة [1m]. يؤدي تعيين متغيرات نموذج Sonnet و Opus إلى glm-5.2[1m] إلى إخبار Claude Code بتوجيه كل مستوى من مستويات النموذج إلى المتغير ذي السياق 1M الخاص بـ GLM-5.2. بدون اللاحقة تحصل على السياق الافتراضي؛ معها تحصل على مليون توكن كامل. ربط Sonnet و Opus بنفس النموذج يعني أن أي مستوى يصل إليه Claude Code، ستستخدم GLM-5.2.

CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000. يقوم Claude Code تلقائيًا بضغط المحادثة عندما يقترب من حد السياق. تفترض النافذة الافتراضية ميزانية سياق أصغر. يؤدي رفعها إلى 1,000,000 إلى تمكين Claude Code من استخدام نافذة GLM-5.2 الكاملة قبل أن يبدأ في التلخيص، وبالتالي تحتفظ بالمزيد من قاعدة التعليمات البرمجية الخاصة بك في السياق.

API_TIMEOUT_MS=3000000. هذا الخيار ليس اختياريًا للعمل ذي السياق الكبير. هذا هو مهلة 3,000 ثانية (50 دقيقة). عندما تقوم بتغذية مهمة وكيل طويلة الأفق بنافذة بحجم 1M توكن، يمكن للنموذج أن يفكر لفترة طويلة قبل وصول التوكن الأول، خاصة عند أقصى جهد للتفكير. المهلة الافتراضية أقصر بكثير، لذا ينهي Claude Code الطلب في منتصف الطريق وتظهر لك رسالة خطأ اتصال مربكة. ارفع المهلة وستكتمل المكالمات الطويلة.

بخصوص جهد التفكير: GLM-5.2 لديه مستويان، عالي (High) وأقصى (Max)، وتوصي Z.ai بـ أقصى (Max) للترميز. تطبق نقطة نهاية الترميز إعدادًا افتراضيًا معقولاً، ولكن إذا كانت أداتك تسمح لك بتمرير reasoning_effort، فعيّنه على max للمهام الأصعب. يمكن أيضًا تعطيل التفكير تمامًا عندما تريد إكمالًا سريعًا ورخيصًا.

إذا كنت قد أتيت من نموذج سابق، فإن مسار الترحيل هو نفسه الذي غطيناه لـ GLM-5.1 في Claude Code وGLM-4.5 مع Claude Code. قم بتبديل معرف النموذج وعنوان URL الأساسي، وحافظ على الهيكل.

إعداد GLM-5.2 في Cline

Cline هو إضافة لـ VS Code تشغل وكيل ترميز مستقل داخل محرر التعليمات البرمجية الخاص بك. على عكس Claude Code، يقرأ Cline من نقطة نهاية متوافقة مع OpenAI، لذا يختلف الاتصال.

قم بتثبيت إضافة Cline من سوق VS Code وافتح إعداداتها (أيقونة الترس في لوحة Cline).
بالنسبة لـ مزود واجهة برمجة التطبيقات (API Provider)، اختر متوافق مع OpenAI (OpenAI Compatible).
عيّن عنوان URL الأساسي (Base URL) إلى https://api.z.ai/api/paas/v4/. لاحظ الشرطة المائلة اللاحقة وأن هذا هو الأساس العام لواجهة برمجة التطبيقات، وليس مسار الترميز.
الصق مفتاح API الخاص بـ Z.ai في حقل مفتاح API (API Key).
بالنسبة لـ معرف النموذج (Model ID)، أدخل glm-5.2 (لا توجد لاحقة [1m] هنا، فهذه اتفاقية خاصة بـ Claude Code فقط).
ابحث عن إعداد نافذة السياق (context window) وعينه إلى 1000000. يستخدم Cline هذا لتحديد متى يتم اقتطاع السجل، لذا فإن تركه على القيمة الافتراضية يهدر معظم نافذة GLM-5.2.

هذا هو إعداد GLM-5.2 Cline بالكامل. احفظ، ابدأ مهمة، وشاهد Cline وهو يخطط ويحرر الملفات ويشغل الأوامر ضد النموذج.

ملاحظة خاصة بـ Cline: نظرًا لأن Cline يمكنه إطلاق العديد من استدعاءات الأدوات لكل مهمة، فإن نافذة السياق صغيرة الحجم تجبره على إسقاط الخطوات السابقة. يؤدي تعيين النافذة إلى مليون كامل إلى الاحتفاظ بالخطة والاختلافات ومخرجات الاختبار كلها في النطاق، وهذا هو بالضبط المكان الذي يكتسب فيه السياق الطويل لـ GLM-5.2 قيمته.

إعداد GLM-5.2 في Cursor

Cursor هو محرر مستقل يعتمد على الذكاء الاصطناعي أولاً. وهو أيضًا يدعم التنسيق المتوافق مع OpenAI، لذا فإن الإعدادات تعكس Cline عن كثب.

افتح إعدادات Cursor، انتقل إلى النماذج (Models)، ومرّر إلى قسم مفتاح OpenAI API.
قم بتمكين عنوان URL الأساسي المخصص (custom base URL) (يُسمى أحيانًا "تجاوز عنوان URL الأساسي لـ OpenAI").
عيّن عنوان URL الأساسي إلى https://api.z.ai/api/paas/v4/.
أدخل مفتاح API الخاص بـ Z.ai.
أضف نموذجًا مخصصًا بمعرف glm-5.2، ثم تأكد من أنه النموذج النشط.
تحقق من الاتصال باستخدام اختبار مفتاح API المدمج في Cursor، ثم أرسل إشعارًا.

هذا يغطي إعداد GLM-5.2 Cursor. بمجرد التحقق، يقوم GLM-5.2 بتشغيل الدردشة والتعديلات المضمنة في Cursor.

إذا كنت قد استخدمت Cursor سابقًا مع إصدارات GLM أخرى، فإن المفاضلات التي كتبناها في Claude Code مقابل Cursor مع GLM-4.7 لا تزال سارية: واجهة مستخدم Cursor هي الأكثر سلاسة للتحرير المضمن، بينما يميل Claude Code وCline بشكل أكبر إلى تشغيل الوكلاء المستقلين متعدد الخطوات.

إعدادات جنبًا إلى جنب

إليك كل قيمة في مكان واحد لتتمكن من نسخ القيمة الصحيحة لكل أداة.

الإعداد	Claude Code	Cline	Cursor
تنسيق API	متوافق مع Anthropic	متوافق مع OpenAI	متوافق مع OpenAI
عنوان URL الأساسي	`https://api.z.ai/api/coding/paas/v4` (تحقق مباشرة)	`https://api.z.ai/api/paas/v4/`	`https://api.z.ai/api/paas/v4/`
معرف النموذج	`glm-5.2[1m]`	`glm-5.2`	`glm-5.2`
نوع المفتاح	مفتاح خطة ترميز GLM	مفتاح API	مفتاح API
نافذة السياق	`CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000`	عينه إلى `1000000`	النموذج الافتراضي
المهلة	`API_TIMEOUT_MS=3000000`	لا ينطبق	لا ينطبق
جهد التفكير	أقصى (موصى به للترميز)	عبر الإعداد الافتراضي للمزود	عبر الإعداد الافتراضي للمزود

أكثر شيئين يسببان الارتباك للناس: استخدام عنوان URL الأساسي الخاطئ لنوع الأداة، ونسيان اللاحقة [1m] والمهلة في Claude Code.

اختبر إعدادك باستدعاء API حقيقي

قبل أن تثق بأي أداة، تأكد من أن المفتاح والنموذج يعملان بطلب خام. هذا الاستدعاء يضرب واجهة برمجة التطبيقات العامة مباشرة ويعزل إعدادات الأداة عن مشاكل بيانات الاعتماد.

curl https://api.z.ai/api/paas/v4/chat/completions \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-5.2",
    "messages": [
      {"role": "user", "content": "Write a Python function that reverses a linked list."}
    ],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "max",
    "stream": false
  }'

إذا أرجع ذلك إكمالًا، فإن مفتاحك ومعرف النموذج صحيحان، وأي مشكلة متبقية تتعلق بإعداد الأداة. هذا أيضًا مكان مناسب لإدخال عميل API في العملية. إذا كنت تختبر GLM-5.2 بالفعل جنبًا إلى جنب مع نقاط نهاية الواجهة الخلفية الخاصة بك، فإن Apidog يتيح لك حفظ الطلب، وإدارة ANTHROPIC_API_KEY أو رأس Authorization كمتغير بيئة، وإعادة تشغيله دون إعادة كتابة أمر curl. يمكنك تنزيل Apidog واستيراد الطلب مباشرة من أمر curl أعلاه.

أي أداة يجب أن تستخدمها

لا يوجد فائز واحد. يعتمد الأمر على طريقة عملك المفضلة.

Claude Code هو الأنسب لتشغيل الوكلاء ذوي الأفق الطويل والموجهين للطرفية، وهو الوحيد من الثلاثة الذي يحصل على السياق الكامل بحجم 1M عبر glm-5.2[1m]. الأفضل لعمليات إعادة الهيكلة الكبيرة والتغييرات على مستوى المستودع.
يجلب Cline الوكيل داخل VS Code دون مغادرة المحرر الخاص بك، مع رؤية واضحة لكل استدعاء أداة. حل وسط جيد.
Cursor هو الأكثر صقلًا للتحرير السريع المضمن وعمليات الإكمال التلقائي، مع أخف إعداد.

لمقارنة أعمق للميزات عبر الخطط، راجع Claude Code مقابل Codex مقابل Cursor مقابل MiniMax مقابل خطة GLM. لمعرفة كيفية مقارنة GLM-5.2 بالنماذج المتطورة، تحقق من GLM-5.2 مقابل GPT-5.5 وClaude Opus وGemini وتحليل المعايير المستقل. وإذا كنت تفكر في الترقية، فإن GLM-5.2 مقابل GLM-5.1 يوضح ما تغير.

الأسئلة الشائعة

لماذا أستخدم `glm-5.2[1m]` في Claude Code ولكن `glm-5.2` في Cline و Cursor؟

اللاحقة [1m] هي اتفاقية خاصة بـ Claude Code تختار المتغير ذو السياق 1M عبر نقطة نهاية الترميز. تمرر Cline و Cursor معرف النموذج العادي glm-5.2 إلى نقطة النهاية العامة المتوافقة مع OpenAI، حيث يتم تعيين نافذة السياق في واجهة مستخدم الأداة بدلاً من المعرف.

ماذا لو انتهت مهلة Claude Code في المهام الطويلة؟

هذا دائمًا تقريبًا هو السبب في انتهاء المهلة. قم بتعيين API_TIMEOUT_MS=3000000 حتى ينتظر Claude Code وقتًا كافيًا لإنهاء الاستجابات ذات السياق الكبير والجهد الأقصى. بدون ذلك، تقوم الأداة بإلغاء الطلب قبل أن يعود النموذج.

هل أحتاج إلى خطة ترميز GLM، أم يمكنني استخدام الدفع حسب الاستخدام؟

كلاهما يعمل، ولكن مفتاح خطة ترميز GLM هو ما تتوقعه نقطة نهاية الترميز لـ Claude Code، وعادة ما تتفوق المستويات الشهرية الثابتة للخطة (Lite، Pro، Max، Team) على الفواتير لكل توكن للترميز اليومي المكثف. تأكد من أسعار المستويات الحالية على z.ai، حيث تغيرت الأرقام المنشورة (تحقق اعتبارًا من يونيو 2026).

ما هو عنوان URL الأساسي الصحيح لـ Claude Code؟

استخدم https://api.z.ai/api/coding/paas/v4. تسرد بعض المصادر https://open.z.ai/api/paas/v4. إذا فشل أحدهما بسبب أخطاء المصادقة أو 404، فجرّب الآخر وتحقق من وثائق Z.ai المباشرة. الأساس العام لواجهة برمجة التطبيقات (https://api.z.ai/api/paas/v4/) مخصص لـ Cline و Cursor، وليس Claude Code.

هل يمكن لـ GLM-5.2 التعامل مع الصور؟

لا يوجد متغير رؤية مؤكد لـ GLM-5.2. إنه نموذج ترميز واستدلال يعتمد على إدخال النص وإخراج النص. لا تتوقع "GLM-5.2V" حتى تقوم Z.ai بإطلاقه.

خاتمة

ثلاث أدوات، نموذج واحد، تنسيقان لنقاط النهاية. احصل على عنوان URL الأساسي ومعرف النموذج الصحيح للأداة التي تستخدمها، تذكر اللاحقة [1m] والمهلة لـ Claude Code، واضبط نافذة السياق على مليون كامل في Cline. من هناك، يعمل GLM-5.2 مثل أي واجهة خلفية ترميز أخرى، فقط بأوزان مفتوحة وبتكلفة تشغيل أرخص. إذا كنت ترغب في تشغيله بدون أداة على الإطلاق، فراجع كيفية استخدام GLM-5.2 مجانًا وتحليل تسعير GLM-5.2. احصل على الأوزان من Hugging Face أو اسحب النموذج باستخدام Ollama عندما تريد نسخة محلية.