سوق إضافات Claude Code: كيف تضيفها وتثبّتها وتديرها
يأتي Claude Code بسوق إضافات رسمي هو claude-plugins-official. تصفحه كمتجر تطبيقات، وثبّت الإضافات بالاسم بأمر واحد، وأدر التحديثات، ثم انشر سوقك الخاص — 16 خطوة من طرفية حقيقية.
الخلاصة السريعة
- السوق الرسمي claude-plugins-official يُضاف تلقائيًا عند أول جلسة تفاعلية — بلا إعداد ولا لصق روابط.
- افتح لوحة /plugin لتتصفح تبويبات Discover وInstalled وMarketplaces وErrors، أو ثبّت من الطرفية مباشرة بأمر claude plugin install frontend-design@claude-plugins-official.
- الإدارة اليومية في قائمة واحدة: التعطيل ثم Mark for update ثم Update now ثم إلغاء التثبيت — وأمر claude plugin marketplace remove يفصل السوق مع كل الإضافات التي جاءت منه.
- نشر سوقك الخاص هو في جوهره كتابة ملف تعريف: أنشئ .claude-plugin/marketplace.json، وتحقق منه محليًا بـ claude plugin validate، وجرّب الإضافة عبر claude --plugin-dir.
Claude Code Plugins Explained In 7 Minutes
القناة: Software Engineer Meets AI7:21
Claude Code Plugins Tutorial: Install & Build Your Own
القناة: Leon van Zyl18:21
Plugins — official Claude Code docs
التوثيق: code.claude.com/docs
اللقطات من فيديو الشرح ذي السبع دقائق لقناة Software Engineer Meets AI — تسجيل شاشة كامل ونظيف. وُفّقت حقائق التثبيت والأسواق والنشر مع البرنامج التعليمي الأوسع ليون فان زيل وتوثيق الإضافات الرسمي.
الإطارات ملك لمبدعيها ويُنسب إليها هنا مع روابط مباشرة إلى اللحظة المحددة؛ والنص من تأليفنا.
سوق إضافات Claude Code في 16 خطوة
اعرف ما الذي ستثبّته
- 1
افهم ما يُعد إضافة
إضافة Claude Code هي امتداد مُعبّأ يجمع المهارات والوكلاء الفرعيين وخوادم MCP والخطافات وخوادم LSP في وحدة واحدة قابلة للتثبيت. ولأن كل شيء يسافر معًا، فالإضافة هي وحدة المشاركة بين المشاريع وداخل الفريق. يغطي هذا الدليل الدورة كاملة: تصفح ثم تثبيت ثم إدارة ثم نشر.
النسخة على السبورة: إضافة واحدة تحوي خمسة أنواع من الامتدادات.المشاهدة عند 0:21 - 2
تعرّف على الإضافة من شجرة ملفاتها
كل إضافة ترتكز على مجلد .claude-plugin الذي يحوي ملف plugin.json، وحوله مجلدات اختيارية للأوامر والوكلاء والمهارات وأنماط المخرجات والخطافات مع ملف .mcp.json. لا يلزم جمعها كلها — أمر واحد يكفي للنشر. الملف التعريفي هو ما يحوّل مجلدًا عاديًا إلى شيء يستطيع Claude Code تثبيته.
التعريف أولًا، ثم مجلد لكل وظيفة — هذا كل الهيكل.المشاهدة عند 0:45 - 3
ابدأ من صفحة الإضافات الرسمية
التوثيق الرسمي على code.claude.com هو المرجع للأوامر وحقول الملف التعريفي، ومنه رابط إلى معرض الإضافات. اطّلع عليه مرة قبل التثبيت لتتطابق أسماء اللوحات والأوامر في هذا الدليل مع ما تراه. كل ما هنا يعمل في الطرفية وتطبيق سطح المكتب وVS Code.
التصفح والتثبيت والبناء في صفحة توثيق واحدة — تستحق الإشارة المرجعية.المشاهدة عند 1:00 - 4
تصفّح شبكة السوق الرسمي
يعرض السوق claude-plugins-official الإضافات في شبكة مع عدّادات التثبيت ومرشّح Claude Code: Frontend Design وSuperpowers وContext7 وCode Review وCode Simplifier وGitHub وPlaywright. العدّاد مؤشر شعبية لا شهادة جودة. دوّن الأسماء الدقيقة — فهي ما ستكتبه عند التثبيت.
تصفحه كمتجر تطبيقات — والأسماء هي ما تنتظره الواجهة الطرفية.المشاهدة عند 1:10
أضف السوق وثبّت الإضافات
- 5
افحص الإضافة من صفحتها التفصيلية
النقر على إضافة يفتح صفحتها التفصيلية: من صانعها، وما تحويه، وكم تثبيتًا جمعت. Frontend Design مثلًا من صنع Anthropic وقد تجاوزت 400 ألف تثبيت. قبل أن تمنح صلاحيات الأدوات، فضّل الإضافات المعلنة لأصحابها والمدعومة باستخدام حقيقي.
الصانع والمحتوى وعدد التثبيتات — ثلاث قراءات قبل التثبيت.المشاهدة عند 1:40 - 6
ثبّت الإضافة بالاسم من الطرفية
أسرع طريق أمر واحد: claude plugin install frontend-design@claude-plugins-official. المعرّف دائمًا بصيغة اسم-الإضافة@اسم-السوق، فالنمط نفسه يصلح لأي سوق تضيفه لاحقًا. وتؤكد الطرفية التثبيت وتسرد ما سجّلته الإضافة للتو.
سطر واحد وعلامة @ بين الإضافة والسوق — انتهى.المشاهدة عند 1:53 - 7
اكتشف الإضافات من لوحة /plugin
تفضّل النقر على الكتابة؟ اكتب /plugin في جلسة تفاعلية وافتح تبويب Discover: superpowers بـ294.8 ألف تثبيت وcontext7 بـ212.2 ألف وcode-review بـ191.9 ألف. التثبيت من هنا يطابق أمر الطرفية تمامًا، ومن اللوحة نفسها تصل التحديثات لاحقًا.
واجهة المتجر داخل التطبيق — الكتالوج نفسه بلا كتابة.المشاهدة عند 2:00 - 8
راجع تبويب Installed
يسرد تبويب Installed كل إضافاتك، كل منها مفعّلة أو معطّلة، بجوار خوادم MCP المتصلة والمقطوعة. إنها الصورة الصادقة لما تحمّله جلساتك فعلًا. عطّل ما لا تستخدمه بدل إلغاء تثبيته — المفتاح قابل للإرجاع دائمًا.
المفعّلة محمّلة؛ والمعطّلة مثبّتة لكن جانبًا.المشاهدة عند 2:10 - 9
أدر الإضافة من قائمتها
افتح إضافة في لوحة /plugin فتظهر قائمة الإدارة: Disable plugin وMark for update وUpdate now وUninstall وBack to plugin list. خيار Mark for update يؤجّل التحديث ليجمعه، وUpdate now يطبّقه فورًا. أما Uninstall فيزيل الإضافة ويُبقي السوق موصولًا.
خمسة خيارات تغطي كل رعاية ما بعد التثبيت.المشاهدة عند 3:38
الإدارة بعد التثبيت
- 10
أعد تحميل الإضافات بعد أي تغيير
يلتقط Claude Code تغييرات الإضافات عند الإقلاع التالي، لكن لا حاجة للخروج: شغّل /reload-plugins فتعيد الجلسة المسح فورًا. يؤكد الناتج ما صار مفعّلًا — Enabled frontend-design في هذا التسجيل — مع ملخّص للإضافات والمهارات والوكلاء المحمّلة. اجعله عادة بعد كل تعديل يدوي.
بلا إعادة تشغيل — أمر سلاش واحد يعيد المسح.المشاهدة عند 3:45 - 11
قرر إن كنت تحتاج إضافة أصلًا
مجلد .claude المستقل مثالي للتعديلات الشخصية غير المُدارة بالإصدارات؛ أما الإضافة فتثبت قيمتها متى دخل زملاء أو مشاريع متعددة — فهي مُدارة بالإصدارات وتُثبَّت بالاسم. الاختبار الصادق: هل يرغب غيرك بهذه الحزمة كما هي؟ إن نعم، عبّئها.
تعديلاتك الشخصية تبقى محلية؛ وكل ما يُشارك يصبح إضافة.المشاهدة عند 4:15 - 12
افهم ما هو السوق
السوق مجرد فهرس — متجر تطبيقات مداخله تشير إلى إضافات للتصحيح والتصميم والبحث وغيرها. إضافته تخبر Claude Code أين يبحث فقط، وهو لا يحمل أي شيفرة بذاته. ويقبل أمر claude plugin marketplace add مسارًا محليًا أو اختصار owner/repo أو رابط git كاملًا.
المتجر قائمة مؤشرات؛ والإضافات هي البضائع.المشاهدة عند 4:46
انشر إضافتك الخاصة
- 13
اجمع وكلاءك وأوامرك ومهاراتك
ابدأ مما يعمل فعلًا: الوكلاء design-implementer وe2e-test-architect وquality-assurance في مجلد .claude لمشروعك مادة إضافة جاهزة. اجمع المجلدات التي تريد شحنها — agents وcommands وskills — في مكان واحد. وما تستبعده لا يقل أهمية عمّا تُضمّن.
نخبة سكان .claude مصفوفون رهن التغليف.المشاهدة عند 5:20 - 14
اطلب من Claude Code بناء الهيكل
لا حاجة لتجميع المجلد يدويًا: اطلب من Claude Code إنشاء إضافة فريق قابلة للمشاركة تجمع وكيل quality-assurance وأمر fix-issue. سيرتّب البنية ويسوّد الملف التعريفي عنك. راجع الهيكل قبل أن تلمس أي حقل.
البناء للوكيل، والمراجعة لك.المشاهدة عند 5:55 - 15
املأ الملف التعريفي plugin.json
يعلن الملف التعريفي في .claude-plugin/plugin.json اسم الإضافة وإصدارها ووصفها، ثم يسرد مصفوفات agents وcommands وskills. كل مدخل هنا يراه المستخدم عند التثبيت، فأبقه دقيقًا ومقتصدًا. هذه شجرة الملفات الإحدى عشرة أصبحت إضافة حقيقية.
الاسم والإصدار والوصف ثم المصفوفات — لا شيء آخر إلزامي.المشاهدة عند 6:25 - 16
انشر ونموذج التهديد في ذهنك
مستودع السوق ثقة قابلة للتنفيذ: كشفت مجتمعية في 2026 عن اختطاف إضافات السوق حين تسلّل مستودع GitHub معدّلٌ حقنَ تعليمات وتغييرات صلاحيات إلى إضافات مثبّتة أصلًا. ثبّت إصداراتك، وراقب تغييرات المستودع، وتذكّر أن كل إضافة تعمل بكامل صلاحياتك.
تشريح الاختراق: تعديل مستودع واحد، ومساران للهجوم.المشاهدة عند 6:50
مرجع الطرفية: كل أوامر الإضافات
ستة أوامر تغطي الدورة كاملة. تعيش حالة الإضافات في ~/.claude/plugins، وتتبع النطاقات المستويات المعتادة user وproject وlocal.
- 1claude plugin marketplace add — يربط سوقًا من مسار محلي أو اختصار owner/repo أو رابط git كامل؛ ويُضاف السوق الرسمي claude-plugins-official تلقائيًا عند أول جلسة تفاعلية.
- 2claude plugin validate ./my-marketplace — فحص محلي للسوق قبل النشر يكشف أخطاء الملف التعريفي والمصادر مبكرًا.
- 3claude plugin list — يسرد كل إضافة مثبّتة وسوقها؛ وتفاصيل إضافة بعينها من لوحة /plugin.
- 4claude plugin install frontend-design@claude-plugins-official — تثبيت بالمعرّف، دائمًا بصيغة اسم-الإضافة@اسم-السوق.
- 5claude plugin marketplace remove — يفصل السوق ويلغي تثبيت كل ما جاء منه.
- 6claude --plugin-dir ./my-plugin — تشغيل مع تحميل مجلد إضافة محلي دون سوق، الأنسب للاختبار أثناء التطوير.
داخل الجلسة توفر لوحة /plugin العمليات نفسها عبر تبويبات Discover وInstalled وMarketplaces وErrors — ويعيد /reload-plugins المسح بلا إعادة تشغيل.
أمان السوق: اقرأ قبل أن تضغط Install
الإضافات تعمل بصلاحياتك داخل جلساتك، فالإضافة الخبيثة نسخة أخرى منك. خمس عادات تُبقيك آمنًا.
- 1اقرأ الملف التعريفي أولًا. قبل التثبيت افتح plugin.json والمستودع: ما الأوامر والخطافات وخوادم MCP التي يسجلها؟ خطاف على كل طلب التزام أكبر بكثير من أمر سلاش.
- 2مستودعات الأسواق قابلة لإعادة الكتابة. وثّقت إفصاحات المجتمع في 2026 حالات اختطاف إضافات وتسميم تبعيات — الإضافة المثبّتة تتغير بتغير مستودعها، فراجع التحديثات كما تراجع التبعيات.
- 3الأسماء الرسمية محجوزة. معرّفات مثل claude-plugins-official ترفض انتحال الغير، فمعرّف @ الذي يشير إلى السوق الرسمي أصيل — تحقق من لاحقة السوق قبل أن تثق باسم إضافة.
- 4الشركات تستطيع ضبط البوابات. تسمح الإعدادات المُدارة بمنح الأسواق أو حجبها، فتُثبَّت أجهزة الشركة على سوق داخلي معتمد.
- 5ثبّت بأقل الصلاحيات. كل إضافة تعمل بحسابك: ثبّت الأدنى، وعطّل ما لا تستخدم، وألغِ التثبيت بدل التراكم.
تبويب Errors في لوحة /plugin هو صفارة الإنذار: إضافة تفشل فجأة في التحميل بعد تحديث تستحق مقارنة ملفها التعريفي قبل الجلسة التالية.