|

إتقان 5 ميزات جديدة في Claude Code v2.1.92: استمرارية نتائج MCP، والملفات التنفيذية للملحقات، والبرامج التعليمية التفاعلية

ملاحظة من الكاتب: شرح مفصل لأبرز التحديثات في إصدارات Claude Code من v2.1.90 إلى v2.1.92، بما في ذلك استمرارية نتائج أدوات MCP (بسعة 500 ألف حرف)، ومجلد bin للإضافات، والبرنامج التعليمي التفاعلي /powerup، وغيرها من 5 ترقيات وظيفية رئيسية.

شهدت الإصدارات الثلاثة الأخيرة من Claude Code (v2.1.90 ~ v2.1.92) سلسلة من التحديثات الهامة، حيث أثارت ميزات استمرارية نتائج أدوات MCP، ومجلد الملفات التنفيذية للإضافات، والبرنامج التعليمي التفاعلي /powerup اهتماماً واسعاً في مجتمع المطورين. نستعرض في هذا المقال التأثير العملي لهذه التحديثات على سير عمل البرمجة بمساعدة الذكاء الاصطناعي.

القيمة الجوهرية: تعرف في 3 دقائق على أحدث ترقيات الوظائف في إصدارات Claude Code الثلاثة الأخيرة، وأتقن طرق تكوين استمرارية MCP ومسار التعلم عبر /powerup.

claude-code-v2-1-92-mcp-persistence-powerup-tutorial-ar 图示


نظرة سريعة على تحديثات Claude Code v2.1.92

أصدرت Claude Code في أوائل أبريل 2026 ثلاثة إصدارات متتالية: v2.1.90، وv2.1.91، وv2.1.92. فيما يلي ملخص كامل للتحديثات الجوهرية عبر هذه الإصدارات:

الإصدار تاريخ الإصدار التحديث الجوهري نطاق التأثير
v2.1.92 2026-04-04 تحديث قسري للإعدادات عن بُعد، معالج تكوين تفاعلي لـ Bedrock إدارة أمن الشركات، مستخدمو AWS
v2.1.91 2026-04-02 استمرارية نتائج MCP بسعة 500 ألف حرف، مجلد bin/ للإضافات مطورو MCP، نظام الإضافات البيئي
v2.1.90 2026-04-01 برنامج تعليمي تفاعلي /powerup، تحسينات كبيرة في الأداء جميع المستخدمين

تحليل معمق لإصدار Claude Code v2.1.92

تتركز التغييرات الجوهرية في إصدار v2.1.92 على اتجاهين: إدارة الأمن على مستوى المؤسسات وتحسين تجربة التطوير:

تعد استراتيجية forceRemoteSettingsRefresh تحديثاً مهماً لفرق العمل في الشركات. عند تفعيل هذه الاستراتيجية، يقوم واجهة سطر الأوامر (CLI) في كل مرة يتم فيها التشغيل بسحب أحدث الإعدادات المدارة عن بُعد، وإذا فشل السحب، يتم إيقاف التشغيل (نموذج أمان fail-closed). وهذا يعني أن فرق تكنولوجيا المعلومات في الشركات يمكنها ضمان أن جميع المطورين يعملون دائماً وفقاً للإعدادات التي تتوافق مع سياسات أمان الشركة، مما يتجنب مشكلة انحراف السياسات الناتجة عن التخزين المؤقت المحلي.

أما معالج التكوين التفاعلي لـ Bedrock فقد جعل تجربة التكوين الأولية لمستخدمي AWS أفضل بكثير. بعد اختيار "3rd-party platform" في واجهة تسجيل الدخول، يرشدك المعالج لإكمال عملية مصادقة AWS، وتكوين المنطقة، والتحقق من بيانات الاعتماد، وربط النموذج بالكامل، دون الحاجة إلى تحرير ملفات التكوين يدوياً.

claude-code-v2-1-92-mcp-persistence-powerup-tutorial-ar 图示

شرح مفصل لنتائج أدوات MCP في Claude Code

الآلية الأساسية لاستمرارية نتائج MCP

تُعد ميزة استمرارية نتائج أدوات MCP التي تم تقديمها في الإصدار v2.1.91 أهم تحديث للمطورين في هذه الدورة. سابقاً، كانت النتائج الضخمة التي تعيدها أدوات MCP (مثل مخطط قاعدة البيانات Schema أو فهارس قواعد الأكواد الكبيرة) تُقتطع بسبب تجاوز الحدود الافتراضية، مما يؤدي إلى فقدان معلومات السياق.

الآن، يمكن لخوادم MCP تجاوز حدود حجم النتائج الافتراضية عن طريق ضبط الحقل _meta["anthropic/maxResultSizeChars"]، مع دعم يصل إلى 500,000 حرف (حوالي 500 كيلوبايت). وهذا يعني:

  • نقل كامل لمخطط قاعدة البيانات (Schema): يمكن تمرير هيكل قاعدة البيانات الكامل للمشاريع الكبيرة إلى Claude دفعة واحدة.
  • عدم اقتطاع فهارس الكود: يمكن الاحتفاظ بفهارس الملفات ورسوم بيانية للعلاقات على مستوى المشروع بالكامل.
  • تحميل كامل لوثائق API: يمكن تمرير الوثائق الكاملة لواجهات البرمجة المعقدة كجزء من السياق.
السيناريو القيود السابقة بعد الاستمرارية التأثير
مخطط قاعدة البيانات اقتطاع لهياكل الجداول 500 ألف حرف كاملة فهم شامل لنموذج البيانات
فهرس ملفات المشروع الاحتفاظ بالملفات الأساسية فقط شجرة دليل كاملة تحديد دقيق لمواقع الكود
وثائق API إصدارات مختصرة شرح كامل للمعاملات اقتراحات دقيقة لاستدعاء الواجهات
تحليل السجلات آخر عشرات الأسطر سجلات واسعة النطاق تشخيص أدق للمشكلات

كيفية تهيئة استمرارية نتائج MCP

ما عليك سوى إضافة حقل _meta في استجابة خادم MCP الخاص بك لتفعيل الميزة:

{
  "content": [
    {
      "type": "text",
      "text": "... محتوى النتائج الضخم ..."
    }
  ],
  "_meta": {
    "anthropic/maxResultSizeChars": 500000
  }
}

عرض مثال كامل لتنفيذ خادم MCP
import { Server } from "@modelcontextprotocol/sdk/server/index.js";

const server = new Server({
  name: "database-schema-server",
  version: "1.0.0"
});

server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "get_database_schema") {
    const schema = await fetchFullDatabaseSchema();

    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(schema, null, 2)
        }
      ],
      _meta: {
        "anthropic/maxResultSizeChars": 500000
      }
    };
  }
});

🎯 نصيحة للمطورين: إذا كنت تطور خادم MCP، يُنصح بضبط قيمة maxResultSizeChars بشكل معقول. ليس من الضروري دائماً ضبطها على الحد الأقصى (500 ألف)، بل اختر حداً أقصى مناسباً بناءً على حجم البيانات الفعلي. بالنسبة للسيناريوهات التي تتطلب استدعاء نماذج ذكاء اصطناعي متعددة للاختبار، يمكنك استخدام منصة APIYI (apiyi.com) لإدارة مفاتيح API مركزياً والتحقق بسرعة من أداء خادم MCP عبر نماذج مختلفة.


دعم الملفات القابلة للتنفيذ في إضافات Claude Code

آلية دليل bin/ للإضافات

أضاف الإصدار v2.1.91 دعماً لدليل bin/ في الإضافات، وهو توسع مهم لنظام إضافات Claude Code. يمكن لمطوري الإضافات الآن تضمين ملفات قابلة للتنفيذ داخل حزمة الإضافة، واستدعاؤها مباشرة كأوامر خام (Bare commands) داخل أداة Bash.

تشمل سيناريوهات الاستخدام النموذجية لهذه الميزة ما يلي:

  • أدوات CLI مخصصة: يمكن تشغيل أدوات سطر الأوامر المرفقة مع الإضافة مباشرة داخل أداة Bash الخاصة بـ Claude.
  • سكربتات البناء: سكربتات مخصصة لبناء واختبار ونشر المشاريع.
  • أدوات معالجة البيانات: أدوات مخصصة لتحويل وتنسيق البيانات.

هيكل دليل bin/ للإضافات

my-claude-plugin/
├── plugin.json
├── src/
│   └── index.ts
└── bin/
    ├── lint-check        # أداة فحص الكود المخصصة
    ├── db-migrate        # سكربت ترحيل قاعدة البيانات
    └── deploy-preview    # أداة نشر المعاينة

بعد التهيئة، يمكن لـ Claude Code استدعاء هذه الأدوات مباشرة عند تنفيذ أوامر Bash:

# يمكن لـ Claude استدعاء الملفات القابلة للتنفيذ للإضافة مباشرة في Bash
lint-check src/
db-migrate --status
deploy-preview --branch feature/new-api

تحديثات هامة أخرى في Claude Code v2.1.91

الميزة الوصف سيناريو الاستخدام
روابط عميقة متعددة الأسطر claude-cli://open?q= تدعم ترميز %0A للأسطر الجديدة تكامل IDE، استدعاء الأدوات الخارجية
disableSkillShellExecution منع تنفيذ Shell المضمن داخل المهارات سياسات أمان المؤسسات
تحسين أداة Edit استخدام نقاط ربط old_string أقصر تقليل استهلاك الرموز (Tokens)
إصلاح –resume إصلاح فقدان سجل الجلسة بسبب فشل الكتابة غير المتزامنة جلسات التطوير الطويلة

💡 نصيحة عملية: يعالج إصلاح --resume مشكلة واسعة النطاق؛ ففي السابق، عند استعادة جلسة باستخدام --resume، إذا فشلت الكتابة غير المتزامنة بصمت، فقد يؤدي ذلك إلى انقطاع سلسلة سجل الجلسة. الآن تم حل هذه المشكلة تماماً، مما يتيح مقاطعة واستئناف جلسات التطوير الطويلة بأمان.

claude-code-v2-1-92-mcp-persistence-powerup-tutorial-ar 图示

نظام الدروس التفاعلية /powerup في Claude Code

نظرة عامة على ميزة /powerup

يُعد /powerup الذي تم تقديمه في الإصدار v2.1.90 أول نظام دروس تفاعلي مدمج في Claude Code. يوفر النظام دروساً داخل الطرفية (Terminal) مع عروض توضيحية متحركة، تغطي 18 نقطة معرفية تتراوح من المستوى المبتدئ إلى المتقدم.

مستوى الصعوبة عدد الدروس المحتوى المغطى المستخدم المستهدف
مبتدئ 6 دروس CLAUDE.md، /clear، /compact، وضع التخطيط، اختيار النموذج المستخدمون الجدد
متوسط 6 دروس المهارات (Skills)، الخطافات (Hooks)، الوكلاء الفرعيون، إعدادات MCP، /rewind المستخدمون اليوميون
متقدم 6 دروس أشجار العمل (Worktrees)، الوضع التلقائي، /schedule، وضع الرأس (Headless) في SDK المستخدمون المحترفون

كيفية استخدام /powerup

ما عليك سوى كتابة الأمر التالي مباشرة في طرفية Claude Code:

/powerup

سيعرض النظام قائمة تفاعلية تتيح لك اختيار وحدة الدرس المحددة. يتضمن كل درس:

  • شرح المفاهيم: المبادئ الأساسية وفلسفة التصميم للميزة.
  • عرض توضيحي متحرك: محاكاة حية للعمليات داخل الطرفية.
  • تمارين عملية: توجيهك لتجربة الميزة في مشاريعك الخاصة.

مسارات التعلم الموصى بها لـ /powerup

نوصي بمسارات التعلم التالية بناءً على مستوى خبرة المطور:

للمبتدئين — ابدأ بإتقان 3 أساسيات:

  1. كيفية كتابة ملف إعدادات المشروع CLAUDE.md.
  2. إدارة نافذة السياق باستخدام أمر /compact.
  3. استخدام وضع التخطيط (Plan Mode) لحل المهام المعقدة خطوة بخطوة.

للمستوى المتوسط — ركز على قدرات الأتمتة:

  1. إعداد الخطافات (Hooks) لأتمتة سير العمل.
  2. استخدام الوكلاء الفرعيين (Sub-agents) لمعالجة المهام بالتوازي.
  3. توسيع قدرات أدوات Claude باستخدام خوادم MCP.

للمستوى المتقدم — أطلق العنان للإمكانات الكاملة:

  1. استخدام أشجار العمل (Worktrees) للتطوير المتوازي في بيئات معزولة.
  2. استخدام /schedule لجدولة تشغيل الوكلاء عن بُعد.
  3. دمج وضع الرأس (Headless) الخاص بـ SDK في خطوط أنابيب CI/CD.

🚀 بداية سريعة: إذا كنت بحاجة إلى استدعاء نماذج لغة كبيرة مختلفة للاختبار أثناء تطوير خوادم MCP، نوصي باستخدام الواجهة الموحدة لـ APIYI (apiyi.com)، حيث يمكنك الوصول إلى النماذج الرائدة مثل Claude وGPT وGemini باستخدام مفتاح API واحد فقط.


ملخص تحسينات الأداء في Claude Code v2.1.92

تحسين أداء أداة الكتابة (Write)

شهد الإصدار v2.1.92 تحسينات على حسابات الـ diff في أداة الكتابة (Write)، مما أدى إلى زيادة في الأداء بنسبة 60% تقريباً عند التعامل مع الملفات الكبيرة التي تحتوي على علامات التبويب (Tab)، ورموز &، وعلامات الدولار $. يعد هذا تحسيناً ملحوظاً في تجربة المطورين الذين يقومون بتعديل ملفات الإعدادات الكبيرة، ونصوص Shell البرمجية، وملفات القوالب بشكل يومي.

تحسينات الأداء في الإصدار v2.1.90

تضمن الإصدار v2.1.90 العديد من تحسينات الأداء الأساسية:

بند التحسين محتوى التحسين التأثير الفعلي
نقل SSE التحسين من التعقيد التربيعي إلى التعقيد الخطي تحسن كبير في سرعة استجابة المحادثات الطويلة
كتابة الجلسة تحسين أداء كتابة ملفات النسخ تقليل حظر الإدخال/الإخراج (I/O)
ذاكرة التخزين المؤقت لـ MCP Schema تحسين البحث في مفاتيح التخزين المؤقت تقليل زمن استجابة استدعاء أدوات MCP
ذاكرة التخزين المؤقت –resume إصلاح تراجع عدم مطابقة ذاكرة التخزين المؤقت الكاملة للـ prompt تقليل كبير في استهلاك الرموز (Tokens) عند استئناف الجلسات

تحسينات أخرى في v2.1.92

  • تعزيز أمر /cost: يمكن للمشتركين الآن عرض تفاصيل التكلفة مقسمة حسب النموذج ومعدل نجاح ذاكرة التخزين المؤقت.
  • ترقية /release-notes: أصبح الآن أداة اختيار تفاعلية للإصدارات، مما يسهل عرض سجل التحديثات لأي إصدار.
  • تسمية جلسات التحكم عن بُعد: تستخدم الآن بادئة اسم المضيف افتراضياً (مثل myhost-graceful-unicorn)، مع دعم التخصيص عبر --remote-control-session-name-prefix.
  • تنبيه انتهاء صلاحية ذاكرة التخزين المؤقت: سيظهر للمستخدمين المحترفين (Pro) تنبيه في التذييل بعد انتهاء صلاحية ذاكرة التخزين المؤقت للـ prompt، يوضح عدداً تقريبياً للرموز (Tokens) غير المخزنة مؤقتاً.

💰 نصيحة حول التكلفة: يوفر أمر /cost في Claude Code الآن تحليلاً للتكاليف مقسماً حسب النموذج. إذا كنت تستخدم نماذج ذكاء اصطناعي متعددة في التطوير، يمكنك استخدام ميزة الفواتير في منصة APIYI (apiyi.com) لعرض استخدام وتكاليف كل نموذج بشكل موحد، مما يسهل التحكم في النفقات.

قائمة إصلاحات أخطاء Claude Code v2.1.92

تم إصلاح العديد من المشكلات التي تؤثر على تجربة المستخدم في الإصدارات الثلاثة الأخيرة:

إصلاحات v2.1.92

  • إصلاح مشكلة فشل إنشاء جلسة tmux للوكيل الفرعي.
  • إصلاح خطأ API 400 الناتج عن كتل التفكير (thinking blocks) التي تحتوي على مسافات بيضاء فقط.
  • إصلاح مشكلة إرسال استبيان التقييم عن طريق الخطأ عند الضغط على مفاتيح معينة في وضع القيادة الذاتية.
  • إصلاح تكرار عرض الرسائل في وضع التمرير بملء الشاشة.
  • إصلاح تعليق خادم MCP الخاص بالإضافة في حالة "الاتصال" (connecting).
  • إزالة الأوامر /tag و /vim.
  • استعادة حظر Unix Socket في بيئة Linux المعزولة (Sandbox).

إصلاحات v2.1.91

  • إصلاح فقدان سجل الجلسة الناتج عن فشل الكتابة غير المتزامنة عند استخدام --resume.
  • إصلاح تعطل اختصار cmd+delete في محطات الطرفية iTerm2 و kitty و WezTerm و Ghostty.
  • إصلاح فقدان حالة وضع التخطيط بعد إعادة تشغيل الحاوية.

إصلاحات v2.1.90

  • إصلاح تراجع في الأداء تسبب في عدم تحقيق تطابق كامل في ذاكرة التخزين المؤقت للموجه (prompt-cache) عند استخدام --resume (منذ الإصدار v2.1.69).
  • إصلاح حلقة مربع حوار حدود المعدل (rate limit) اللانهائية.
  • إصلاح مشكلة تجاهل الوضع التلقائي لحدود المستخدم الصريحة (مثل "don't push").
  • إصلاح خطأ "File content has changed" الذي يظهر عند استخدام أدوات التعديل/الكتابة (Edit/Write) مع تفعيل خطاف التنسيق عند الحفظ (format-on-save).

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

س1: هل حد الـ 500 ألف حرف لاستمرارية نتائج أدوات MCP هو حد أقصى إلزامي؟

نعم، 500,000 حرف هو الحد الأقصى المسموح به حالياً لـ anthropic/maxResultSizeChars. نوصي بضبط الإعدادات بشكل معقول بناءً على حجم البيانات الفعلي، ولا داعي لاستخدام القيمة القصوى افتراضياً. النتائج الكبيرة جداً تستهلك مساحة أكبر من نافذة السياق، مما قد يؤثر على جودة المحادثات اللاحقة. إذا كنت بحاجة إلى معالجة بيانات ضخمة، نوصي بإجراء معالجة أولية وتلخيص لها على جانب خادم MCP.

س2: هل يدعم برنامج تعليمي /powerup الاستخدام دون اتصال بالإنترنت؟

محتوى برنامج /powerup التعليمي مدمج داخل حزمة تثبيت Claude Code، ولا يتطلب تنزيلاً إضافياً. طالما قمت بتثبيت الإصدار v2.1.90 أو أحدث، يمكنك تشغيل /powerup مباشرة في الطرفية للبدء في التعلم دون الحاجة إلى اتصال بالإنترنت. سيتم تحديث محتوى الدورة باستمرار مع تحديثات الإصدارات.

س3: كيف يمكنني الترقية إلى Claude Code v2.1.92؟

يمكنك الترقية عبر تثبيت أحدث إصدار عالمياً باستخدام npm:

npm install -g @anthropic-ai/claude-code@latest

بعد الترقية، قم بتشغيل claude --version للتأكد من رقم الإصدار. إذا كنت بحاجة إلى استدعاء نماذج لغة كبيرة متعددة للاختبار والمقارنة أثناء التطوير، يمكنك الحصول على واجهة API موحدة ورصيد اختبار مجاني عبر منصة APIYI (apiyi.com).


ملخص

أبرز التحديثات الجوهرية في إصدارات Claude Code من v2.1.90 إلى v2.1.92:

  1. استمرارية نتائج MCP: دعم نتائج الأدوات حتى 500 ألف حرف، مما يحل مشكلة اقتطاع المخططات (Schemas) والفهارس الكبيرة.
  2. دليل bin/ للإضافات: يمكن للإضافات الآن احتواء ملفات تنفيذية، مما يوسع قدرات سلسلة أدوات Claude Code.
  3. دروس تفاعلية عبر /powerup: 18 درساً مقسمة إلى ثلاثة مستويات صعوبة، لمساعدة المستخدمين من كافة المستويات على تعلم Claude Code بشكل منهجي.
  4. تعزيز أمن المؤسسات: سياسة forceRemoteSettingsRefresh لضمان اتساق الإعدادات.
  5. تحسين الأداء الشامل: تسريع أداة الكتابة (Write) بنسبة 60%، وتحسين نقل البيانات عبر SSE من تعقيد O(n²) إلى O(n).

تشير هذه التحديثات إلى تحول Claude Code من مجرد مساعد برمجة يعمل بالذكاء الاصطناعي إلى منصة تطوير متكاملة. كما يوفر تعزيز نظام MCP وتطوير نظام الإضافات مرونة أكبر للمطورين لبناء سير عمل مخصص.

نوصي بتجربة واجهات برمجة التطبيقات (API) الخاصة بـ Claude والنماذج الرائدة الأخرى بسرعة عبر منصة APIYI (apiyi.com)، حيث توفر المنصة رصيداً مجانياً وواجهة موحدة للنماذج، مما يسهل عملية التحقق والمقارنة.


📚 المراجع

  1. سجل تحديثات Claude Code الرسمي: سجل تاريخ الإصدارات الكامل.

    • الرابط: code.claude.com/docs/en/changelog
    • ملاحظة: المصدر الأول للحصول على تفاصيل التحديثات الأخيرة.
  2. مستودع Claude Code على GitHub: الكود المصدري وتتبع المشكلات.

    • الرابط: github.com/anthropics/claude-code
    • ملاحظة: للاطلاع على الكود المصدري، وتقديم تقارير الأخطاء، واقتراحات الميزات.
  3. مواصفات بروتوكول MCP: الوثائق الرسمية لبروتوكول سياق النموذج (Model Context Protocol).

    • الرابط: modelcontextprotocol.io
    • ملاحظة: المرجع المعتمد لتطوير خوادم MCP وتنسيق نتائج الأدوات.
  4. دليل تطوير إضافات Claude Code: وثائق البدء في تطوير الإضافات.

    • الرابط: code.claude.com/docs/en/plugins
    • ملاحظة: لفهم هيكل الإضافات، وتكوين دليل bin وعملية النشر.

الكاتب: فريق APIYI التقني
النقاش التقني: نرحب بمشاركتكم تجارب استخدام Claude Code في قسم التعليقات، وللمزيد من مواد تطوير الذكاء الاصطناعي يمكنكم زيارة مركز توثيق APIYI عبر الرابط docs.apiyi.com

موضوعات ذات صلة