Mods في Claude Code: ثبّتها واستخدمها وعطّلها بأمان
الـ mods إضافات بـ function hooks تعمل داخل العملية، تستطيع إعادة رسم الواجهة وإضافة أوامر واعتراض استدعاءات الأدوات. تمرّ هذه الجولة بمودك الأول وقائمة المدمج ومفاتيح الإطفاء — وكل حقيقة موثقة مقابل الوثائق الرسمية.
الخلاصة
- الـ mods إضافات في Claude Code تشحن وحدة hooks — كود JavaScript يعمل داخل Claude Code نفسه ويستطيع مراقبة الأحداث أو إعادة كتابتها أو الرد عليها.
- على v2.1.287 أو أحدث تعمل الـ mods من الصندوق: ثبّت بـ /plugin install name@marketplace ويصبح المود نشطًا بعد إعادة تشغيل الجلسة.
- المود المدمج You Should Know اختياري: فعّله مرة واحدة بـ /plugin enable cc-plugin-you-should-know@builtin.
- للانسحاب: عطّل مودًا بعينه في /plugin، أو ابدأ بـ --safe-mode لجلسة واحدة، أو اضبط "disableAllHooks": true فتبقى كل الـ mods المثبتة متوقفة.
Claude Mods Make Claude Code 10x More Powerful
القناة: Firecrawl4:40
Claude Code v2.1.287 — Claude Mods and Agent Plugins
القناة: Claude Code Changelog2:13
Mods overview — official docs (function hooks)
المستندات: code.claude.com/docs
لقطات الشاشة من الفيديوهين أعلاه؛ ولم تُستخدم إلا مقاطع شاشة نظيفة وشرائح طباعية لتغييرات الإصدار — واستبعدت مقاطع المقدمين. وتحققت الوقائع مقابل وثائق الـ mods الرسمية لا مقابل الفيديوهات.
الطوابع الزمنية تعود بروابط مباشرة إلى الفيديوهات المصدر ليحصل المبدعون على الزيارة. Claude Code علامة تجارية مملوكة لـ Anthropic؛ وهذا الدليل مستقل وغير تابع.
ثبّت أول مود لـ Claude Code واستخدمه
افهم ما هو المود
- 1
اعرف ما يغيّره المود
قدّم Claude Code 2.1.287 الـ mods: إضافات تعدّل سلوكًا أعمق في الوكيل نفسه. فيستطيع المود الاستجابة لأحداث الجلسة، والحفاظ على حالته الخاصة، والرسم مباشرة في الواجهة — برنامج صغير يمدّد طرفيتك، لا تعليمة أخرى للنموذج.
ملاحظات الإصدار v2.1.287 تقدم الـ mods كإضافات تعدّل سلوكًا أعمق داخل Claude Code.شاهد عند 0:30 - 2
ضَع الـ mods بين طبقات الإضافات الأخرى
Skills توجّه سلوك النموذج، وخوادم MCP تعرض أدوات خارجية، وshell hooks تنفذ أوامر عند أحداث دورة الحياة. والـ mods هي الطبقة الرابعة: كود يعمل داخل العملية، ويستطيع تغيير الواجهة واعتراض الأحداث قبل حدوثها أو بعدها. وورقة الغش أسفل الجولة تقارن الطبقات الخمس.
- 3
تحقق من إصدار Claude Code لديك
تحتاج الـ mods إلى Claude Code v2.1.287 أو أحدث، حيث مفعّلة افتراضيًا. تحقق بأمر claude --version؛ وإن كنت متأخرًا فاتبع دليل تحديث Claude Code عندنا ثم عُد. وقد تطلب الـ mods الفردية إصدارات أحدث بعد.
تغطي ملاحظات الإصدار v2.1.287: Claude Mods، وإضافة You Should Know، وترشيح agent view، وإدارة المهام الخلفية.شاهد عند 0:09
ثبّت واحدًا وشاهده يعمل
- 4
تجاوز علامة التفعيل القديمة
تخبرك الجولات القديمة بضبط CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 — كانت تلك معاينة الوصول المبكر. ومنذ 2.1.287 الـ mods مفعّلة افتراضيًا والمتغير يُتجاهل، فيمكنك حذفه من إعداداتك. ولا حاجة لشيء آخر لتفعيل الـ mods.
- 5
ثبّت مودًا من سوق إضافات
داخل الجلسة: /plugin install mod-name@marketplace؛ ومن طرفيتك: claude plugin install mod-name@marketplace ثم /reload-plugins إن كانت هناك جلسة مفتوحة أصلًا. وقبل تثبيت كود من طرف ثالث يمكنك فحصه بـ claude plugin validate ./some-mod.
- 6
اقرأ ما هو المود فعلًا
المود هو وحدة hooks: مدخل register(on) يشترك بمعالجات دالّة على أحداث المحرك. ويتلقى كل معالج واجهة الـ mods API والحدث وتابعًا next() — وهو شكل وسائط Express: تراقب الحدث أو تعيد كتابته أو تجيب عليه ثم تمرّره.
ملف register.tsx لمود حقيقي: معالج on('ui.render') يعيد رسم مكوّن AbovePrompt بسطر نص إضافي.شاهد عند 2:35 - 7
شغّل الجلسة وتحقق
ابدأ Claude Code وابحث عن الأدلة: تظهر أوامر الشرطة المائلة الخاصة بالمود في قائمة المساعدة، ويعرض /plugin سطرًا مثل "1 mod active" تحت التبويبات. وإن لم يظهر شيء فأعد قراءة تعليمات المود — الـ mods الرسومية لا تعمل إلا في الطرفية وتبويب Code في تطبيق سطح المكتب.
أمر /hello في قائمة المساعدة جاء من مود مثبت — الـ mods تسجل أوامر مخصصة تُنفذ فورًا دون استهلاك دورة Claude.شاهد عند 2:32
الـ mods المدمجة
- 8
تعرّف على الـ mods المدمجة
افتح /plugin وانظر إلى قسم Built-in: فـ cc-plugin-agents-md يحمل AGENTS.md، وcc-plugin-diff يشغّل لوح /diff، وcc-plugin-plugin-authoring هو مهارة تأليف الإضافات، وcc-plugin-sec-default يحمي سياسة المؤسسة، وcc-plugin-telemetry يتولى التحليلات. ومصادرها في مجلد mods بمستودع Claude Code.
- 9
فعّل مود You Should Know
You Should Know هو الوكيل الجانبي المدمج في Claude Code: بعد تفعيله يراقب جلستك ويشير إلى ما قد فاتك. وهو يأتي معطلًا افتراضيًا — فعّله مرة واحدة بـ /plugin enable cc-plugin-you-should-know@builtin وسيبقى مفعّلًا في الجلسات القادمة.
بطاقة you-should-know الرسمية: وكيل جانبي يراقب جلستك، يُفعّل بأمر /plugin enable cc-plugin-you-should-know@builtin.شاهد عند 0:48 - 10
اعرف مفاتيح الإطفاء الثلاثة
عطّل مودًا بعينه من تبويب Installed في /plugin. أو أطلق claude --safe-mode لجلسة واحدة بلا mods. أو اضبط "disableAllHooks": true في ~/.claude/settings.json فتبقى كل الـ mods المثبتة متوقفة حتى تعيد ذلك. والـ mods المدمجة تواصل العمل في الحالات الثلاث جميعها — وهذا مقصود.
ابقَ متحكمًا
- 11
احترم نموذج الأمان
تعمل الـ mods بصلاحياتك ودون بيئة معزولة: تستطيع قراءة متغيرات البيئة والأسرار، وإعادة كتابة المطالبات، والموافقة المسبقة على استدعاءات الأدوات، وصرف حصتك. فلا تثبّت إلا mods يوافقك أن تشغّلها كودًا عاديًا على جهازك، وراجع بأمر /plugin ما حمّلته الجلسة فعلًا.
- 12
اعرف أين تستطيع الـ mods الرسم
واجهة الـ mods — الألواح بجوار السجل، والأشرطة فوق المطالبة، والتبويبات المخصصة — تُصيَّر في الطرفية وتبويب Code في تطبيق سطح المكتب. ولا ترسم في جلسات WSL، ولا لوحة محادثة VS Code، ولا تشغيلات claude -p، ولا Agent SDK، ولا الجلسات السحابية، ويستطيع المود إعادة تنسيق واجهة Claude Code لكنه لا يلمس مطالبة الأذونات أبدًا.
Mods مقابل plugins مقابل skills مقابل MCP مقابل hooks
في Claude Code الآن خمس طبقات إضافات، وتتلطاخ الأسماء سريعًا. النسخة المختصرة — أين يعمل الكود وماذا يستطيع لمسه:
- 1Skills حزم تعليمات بصيغة markdown توجّه سلوك النموذج عند استدعائها — دون تنفيذ كود من تلقاء نفسها.
- 2خوادم MCP تصل بالأدوات ومصادر البيانات الخارجية عبر Model Context Protocol — خارج العملية، ومعروضة كأدوات.
- 3Shell hooks أوامر من ملفات إعداداتك تعمل عند أحداث دورة الحياة، مثل قبل استدعاء أداة أو بعده.
- 4Plugins تجمع أي مما سبق — أوامر ووكلاء وخوادم MCP وhooks — في حزمة واحدة قابلة للتثبيت.
- 5Mods إضافات تعمل وحدة hooks الخاصة بها داخل العملية: دوال TypeScript تستطيع إعادة رسم الواجهة، واعتراض الأحداث في منتصفها، والاحتفاظ بالحالة بين الأحداث.
قاعدة الإبهام: التعليمات في skills، والتكاملات في MCP، والأتمتة في shell hooks، والتغليف في plugins — وحين تحتاج إلى تغيير شكل Claude Code نفسه أو مصير حدث ما، فذلك مود.