أصبح بإمكان مستخدمي Claude Code تغيير واجهة المساعد وسلوكه عبر وظائف JavaScript أو TypeScript مجمّعة في صورة إضافات. وقد أطلقت Anthropic الإضافات في 1 أكتوبر، مع دعمها في CLI وعلامة Code في Claude Desktop. يمكن للمطورين إضافة عرض لاستخدام السياق داخل المحادثة.

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

هذا الدليل مخصص للمطورين الذين يستخدمون Claude Code بالفعل ويريدون تخصيصًا صغيرًا ومرئيًا. تتمثل المهمة في إنشاء عرض لاستخدام نافذة السياق، وفحص الإضافة الناتجة، وتحديد ما إذا كان ينبغي الاحتفاظ بها. تستند التعليمات إلى الوثائق التي روجعت في 2 أكتوبر لإصدار Claude Code v2.1.287 والإصدارات الأحدث. لم تنفذ BIG CHANGE هذا الإجراء ولم تختبر الكود الناتج بصورة مستقلة.

التغيير الأبرز

  • ما الذي تغير: تضيف إضافات Claude Code وظائف يمكنها تغيير الأحداث والرسم داخل واجهة المساعد، وتُجمّع عبر نظام الإضافات القائم.
  • لماذا يهم ذلك: يمكن للمطورين إضافة عرض أو تحكم في سير العمل إلى جلستهم، مع منح الكود إمكانية الوصول إلى أجهزتهم ومحادثتهم.
  • ما الذي ينبغي مراقبته: مدى توافق الاستدعاءات والسلوك الفعليين للإضافة مع غرضها، والضوابط المؤسسية السارية، وتغييرات API بين إصدارات Claude Code.

تحقق من الإصدار والحساب ومساحة العمل

شغّل claude --version في shell. تشترط وثائق الإضافات الحالية الإصدار v2.1.287 أو أحدث، وتذكر أن الإضافات مفعلة افتراضيًا. لا تتحكم إعدادات متغيرات البيئة القديمة الخاصة بالوصول المبكر في هذا الإصدار.

تحتاج إلى إمكانية استخدام Claude Code ومساحة عمل وافقت على اعتبارها موثوقة. تسرد وثائق الإعداد لدى Anthropic حسابات Pro وMax وTeam وEnterprise وConsole، إلى جانب موفري API خارجيين مدعومين. لا تتضمن خطة Claude chat المجانية Claude Code. قد تمنع إعدادات المؤسسة تحميل الإضافات التي ينشئها المستخدمون.

استخدم جلسة طرفية تفاعلية. تعرض جلسات CLI وDesktop المدعومة واجهات الإضافات. كما تعمل hooks في لوحة محادثة VS Code والجلسات عديمة الواجهة، حيث لا تظهر الرسومات. ولا تدعم جلسات WSL في Desktop الإضافات.

أنشئ العرض وافحصه

يتناول درس Anthropic في 1 أكتوبر أداة Token Weather، وهي عرض يقرأ استخدام السياق بعد كل دور. تستند النسبة المئوية إلى السياق المستخدم في آخر رد وإلى نافذة سياق النموذج. إنها مؤشر للاستخدام، ولا يوجد مقياس موثق لجودة الإجابة.

  1. ابدأ claude في مساحة العمل الموثوقة. اطلب منه إنشاء إضافة تعرض نسبة السياق والرموز المستخدمة وحجم نافذة السياق فوق حقل المطالبة، وتحدّثها بعد اكتمال كل دور للوكيل الرئيسي. اطلب استخدام API استخدام الجلسة الموثق وتنفيذًا يقتصر على العرض، بلا وصول إلى الملفات أو تشغيل عمليات أو طلبات شبكة أو استدعاءات للنموذج. هذه مواصفاتنا الأضيق لمسار الإنشاء الموثق؛ ولا يفرض الطلب نفسه تلك القيود.
  2. راجع الملفات التي ينشئها Claude. يضع دليل الإنشاء الإضافة في دليل الجلسة تحت ~/.claude/dev-mods/. افحص manifest وإعدادات hooks والكود. يسأل Claude Code عما إذا كنت تريد تفعيل إعادة التحميل الساخن؛ والموافقة تشغل إضافات هذه الجلسة وإصداراتها اللاحقة.
  3. قبل تفعيلها، شغّل claude plugin validate متبوعًا بدليل الإضافة الفعلي في shell. اقرأ hooks الأحداث واستدعاءات API التي يعرضها. يحتاج السلوك المقصود إلى قراءة الاستخدام وحفظ الحالة والرسم. افحص أي وصول إلى الملفات أو متغيرات البيئة أو العمليات أو الشبكة أو النماذج، واقرأ أيضًا تغييرات الأحداث في المصدر. نجاح التحقق يعني التوافق مع أداة التحميل، ولا يمثل ضمانًا للأمان.
  4. بعد الموافقة على تنفيذ خضع للمراجعة، شغّل /plugin وتحقق من ظهور الإضافة في علامة Installed. أرسل طلبًا عاديًا وتأكد من تحديث الشريط بعد انتهاء الدور. علامة الاكتمال هي تحميل الإضافة وظهور قيم الاستخدام وتحديثها؛ إنشاء ملف وحده لا يثبت أنها تعمل.

لا تضمن هذه الخطوات أن ينشئ Claude التنفيذ المقصود من المحاولة الأولى. ويمكن الاستعانة بالتنفيذ الكامل لـ Token Weather ومثال اختباره للمقارنة بما يكتبه. يقول الدرس إن قراءة استخدام الجلسة العادية مجانية؛ وقد يؤدي طلب تفصيل الاستخدام إلى إرسال طلب لعدّ الرموز. كما أن مطالبة Claude بكتابة الإضافة أو مراجعتها تستهلك الاستخدام المعتاد لـ Claude Code.

راقب الكود وصلاحياته

الإضافة التي تُنشأ في جلسة مؤقتة. يوضح دليل الإنشاء أنه للاحتفاظ بها، انسخ دليلها إلى موقعك، ثم ابدأ الجلسات باستخدام claude --plugin-dir متبوعًا بذلك الموقع. تكتب كل عملية تحميل تعريفات خاصة بالإصدار تحت .claude-plugin/types/؛ افحصها عند التحديث لأن API قد تتغير.

يوضح دليل الإدارة لدى Anthropic قيدًا قد تحجبه قواعد أذونات الأدوات. يُحمّل حاجز الأمان المضمّن لمستخدمي Team أو Enterprise، أو على الأجهزة ذات الإعدادات المُدارة. في الإعداد الافتراضي، تكون قواعد الرفض أعلى أولوية من إضافات المستخدم التي تسمح باستدعاءات أدوات Claude. ولا تقيد هذه القواعد استدعاءات الإضافة نفسها لواجهات الملفات أو العمليات. يمكن للمسؤولين حظر الإضافات التي يثبتها المستخدمون أو تطبيق إضافة سياسات على استدعاءاتها.

أفاد تحقيق Pluto Security في 22 سبتمبر بوصول إلى بيانات الاعتماد، وخداع الواجهة، وتغيير الكود عن بُعد في اختبارات للتنفيذ السابق للإصدار. تبيع Pluto برامج أمان لهذه الامتدادات، ويذكر تقريرها صراحة أنه يسبق الإتاحة العامة. وهو دليل مفيد عند قراءة مصدر الإضافة وتبعياتها التي تم تنزيلها؛ لكن نتائجه المحددة لا تثبت سلوك v2.1.287. توضح وثائق Anthropic الحالية تفاصيل أذونات الإصدار.

عطّل الإضافة من خلال عناصر التحكم الخاصة بها. --safe-mode يستبعد الإضافات المثبتة والتخصيصات الأخرى في جلسة واحدة.

الاستخدام والتكلفة

لا تحدد مواد الإطلاق وأدلة mods من Anthropic رسومًا منفصلة للإضافات. وتذكر وثائق تكلفة Claude Code أن استخدام الاشتراك يُخصم من مخصصات الخطة، بينما تُحاسب استخدامات Console ومزودي السحابة بحسب الرموز. وقد تستهلك الإضافة التي تستدعي نموذجًا ذلك الاستخدام. راجع /usage وواجهة الفوترة وفق طريقة تسجيل الدخول؛ فنسبة السياق ليست فاتورة ولا حدًا للإنفاق.

سجّل إصدار Claude Code بجانب الإضافة التي راجعتها. تتطلب إضافة موافقات الأوامر أو أدوات مساعدة تم تنزيلها مراجعة أخرى لأنها تغير ما يستطيع الكود فعله.

المصادر ومزيد من القراءة

  • Anthropic، تخصيص Claude Code باستخدام mods، 1 أكتوبر 2026: إعلان الإطلاق، وحزم الإضافات، وتحذير صريح من الوصول إلى الجهاز. تطور Anthropic Claude Code وتبيعه.
  • نظرة عامة على mods، روجعت في 2 أكتوبر: الإصدار، وواجهات الجلسة، وصلاحيات المضيف، والتحقق، وعناصر التعطيل.
  • إنشاء mod، روجعت في 2 أكتوبر: الإنشاء والموافقة وإعادة التحميل الساخن والاحتفاظ وتعريفات الأنواع الخاصة بكل إصدار. توثق السلوك المتوقع ولا تمثل اختبارًا من BIG CHANGE.
  • البدء باستخدام إضافات Claude Code، Addy Osmani، 1 أكتوبر: مقياس Token Weather وكوده ومثال الاختبار. العرض من Anthropic.
  • إدارة الإضافات في مؤسستك، روجعت في 2 أكتوبر: مدى توفر حاجز الأمان، ونطاق قواعد الرفض، وخيارات المسؤولين. ولا يعني ذلك عزل إضافات المستخدمين عمومًا عن الجهاز.
  • إعداد متقدم وإدارة التكاليف بفعالية، روجعت في 2 أكتوبر: متطلبات الحساب والفوترة بحسب طريقة المصادقة وتتبع الاستخدام. لم تحدد مصادر الإطلاق التي روجعت سعرًا منفصلًا للإضافات.
  • Pluto Security، «Inside Claude Code Function Hooks»، 22 سبتمبر: اختبارات أجراها باحثون على التنفيذ السابق للإصدار وحدودها. تبيع Pluto برامج أمان لهذه الامتدادات؛ ولم نكرر الاختبارات.