ما هو plugin في Claude Code وما هو الـ marketplace؟ اجمع ميزاتك وشاركها

كلما توسّعت في استخدام Claude Code، تراكمت لديك أوامر slash خاصة بك، وsubagents تستعملها كثيرًا، وخوادم MCP، وhooks. الـ plugin هو الآلية التي تجمعها في وحدة واحدة يمكنك إصدارها وإدارة نسخها ومشاركتها وإعادة استخدامها عبر الفرق والمشاريع، أما الـ marketplace فهو حيث يجري توزيعها (ظهرت الـ plugins في النسخة التجريبية العامة في أكتوبر 2025، وفي 2026 أُضيف دليل رسمي وبحث/قائمة عبر /plugin).

يتناول هذا المقال ما هو الـ plugin، وبنيته، وكيفية استخدامه، والـ marketplaces، وكيفية بناء ما يخصّك ونشره، ونطاق التوزيع والأمان — استنادًا إلى التوثيق الرسمي. ثلاث خلاصات في البداية. (1) الـ plugin هو دليل واحد يجمع «skills / commands / subagents / hooks / خوادم MCP»، مع .claude-plugin/plugin.json كملف بيان (manifest). (2) استخدم /plugin لإضافة marketplace وinstall لإضافة plugin. (3) بناء ما يخصّك سهل — ضع plugin.json وSKILL.md، واختبر بـ claude --plugin-dir، ثم انشر عبر git.

1. ما هو plugin في Claude Code

التعريف الرسمي: الـ plugin هو «دليل قائم بذاته يجمع وظائف مخصّصة في Claude Code بحيث يمكن إصدارها ومشاركتها وإعادة استخدامها». ويمكن أن يتضمّن plugin واحد أي تركيبة من:

باختصار، الـ plugin هو «امتداد لـ Claude Code مُعبّأ في صورة قابلة للمشاركة». التخصيصات التي كنت تضبطها متفرّقة تُجمَع في مستودع واحد بحيث يُعيد فريقك بأكمله إنتاج الإعداد نفسه. ويمكنك أيضًا تضمين خوادم LSP، ومراقبات تعمل في الخلفية، وملفات تنفيذية (bin/)، لكن الستة أعلاه كافية للبدء.

2. بنية الـ plugin

هناك قاعدة واحدة مهمة بخصوص التخطيط: لا يُوضَع داخل .claude-plugin/ سوى plugin.json. أما أدلّة commands/ وagents/ وskills/ وhooks/ فتقع في جذر الـ plugin (وليس داخل .claude-plugin/).

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # manifest — ONLY this file lives here
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

الحدّ الأدنى من ملف البيان plugin.json:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

الـ name هو المعرّف وهو أيضًا مساحة أسماء الـ skill (يُستدعى الـ skill بصيغة /my-first-plugin:hello). والـ version اختياري: إن ضبطته، لا يحصل المستخدمون على التحديثات إلا عندما ترفع رقمه. وإن حذفت version عند التوزيع عبر git، فإن الـ commit SHA يعمل بمثابة الإصدار (كل commit هو إصدار جديد).

3. كيفية الاستخدام — /plugin والـ marketplaces

التثبيت يكون عبر /plugin، الذي يفتح مديرًا بعلامات تبويب (Discover / Installed / Marketplaces / Errors). الأوامر الأساسية:

# Add a marketplace (the distribution catalog)
/plugin marketplace add anthropics/claude-code        # a GitHub owner/repo
/plugin marketplace add ./my-marketplace              # a local path
/plugin marketplace add https://example.com/marketplace.json

# Install / manage plugins (user scope by default)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# List (filter with --enabled / --disabled). /plugin also has a search bar
/plugin list
/plugin list --enabled

# Apply changes without restart
/reload-plugins

«إضافة marketplace» = «تسجيل كتالوج»، وهي بذاتها لا تثبّت أي plugins — تضيف الكتالوج، ثم تستخدم install لتثبيت الـ plugins فرديًا. ولأغراض البرمجة النصية توجد مكافئات CLI غير تفاعلية مثل claude plugin install …. وإذا تعذّر اتصال خادم MCP المُضمّن في plugin، فراجع حلول خطأ اتصال MCP.

4. ما هو الـ marketplace

الـ marketplace هو كتالوج يحتوي على .claude-plugin/marketplace.json يسرد الـ plugins ومن أين يُجلب كلٌّ منها (مستودع git، أو مسار محلي، أو ملف مُستضاف). توجد منه نسخ رسمية وأخرى مجتمعية.

إذًا إن كنت تريد مجرد استخدام الـ plugins، فالـ marketplace الرسمي جاهز فورًا. أضِف الكتالوج المجتمعي أو كتالوجك الداخلي الخاص حسب الحاجة.

5. أنشئ ما يخصّك وانشره

بناء واحد سهل على نحوٍ مفاجئ. ابدأ بـ وضع ملف بيان وskill، ثم الاختبار محليًا.

# 1) Scaffold
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# write .claude-plugin/plugin.json and skills/hello/SKILL.md

# 2) Test without installing (a .zip works too)
claude --plugin-dir ./my-first-plugin

للنشر، يكفي وضع .claude-plugin/marketplace.json في جذر مستودع git. يضيفه المستخدمون بـ /plugin marketplace add owner/repo.

{
  "name": "my-plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "quality-review-plugin",
      "source": "./plugins/quality-review-plugin",
      "description": "Adds a quick code-review skill"
    }
  ]
}

إدارة الإصدارات تُحَلّ بالترتيب التالي: version في plugin.json ← (وإلا) version في مدخلة الـ marketplace ← (وإلا) الـ commit SHA. إن ثبّتّ version، فـ ارفع رقمه في كل إصدار (إن نسيت، لن يحصل المستخدمون على التحديث). تحقّق قبل النشر بـ claude plugin validate .. ولإدراج plugin في الكتالوج المجتمعي الرسمي، قدّم طلبًا عبر نموذج التقديم (تنطبق شروط Team/Enterprise وغيرها).

6. نطاق التوزيع والأمان

لعمليات التثبيت نطاق: user (الافتراضي، كل المشاريع) / project (كل المتعاونين في المستودع، مُسجَّل في .claude/settings.json) / local (أنت فقط، هذا المستودع) / managed (موزَّع من المسؤول، غير قابل للتعديل من المستخدم). لتوزيع الفريق، ضَع extraKnownMarketplaces وenabledPlugins في .claude/settings.json الخاص بالمشروع، فيُطلَب من الأعضاء التثبيت عندما يوثّقون المجلد.

الخلاصة

الـ plugin في Claude Code يجمع skills وأوامر slash وsubagents وhooks وخوادم MCP في دليل واحد يمكنك إصداره ومشاركته وإعادة استخدامه (ملف البيان هو .claude-plugin/plugin.json؛ وcommands/ وغيرها تقع في الجذر). تُوزَّع عبر marketplaces، والـ marketplace الرسمي (claude.com/plugins) متاح جاهزًا من الصندوق. ثبّت بـ /plugin marketplace add ← /plugin install ← (حسب الحاجة) /plugin list، والبحث، و/reload-plugins.

بناء ما يخصّك مسارٌ قصير: ضع plugin.json وSKILL.md، واختبر بـ claude --plugin-dir، ثم انشر بوضع marketplace.json في مستودع git. النطاقات هي user / project / local / managed، مع توزيع الفريق عبر .claude/settings.json. لكن الـ plugins يمكنها تنفيذ شيفرة عشوائية، لذا ثبّت فقط من ناشرين موثوقين وقيّد المصادر بـ strictKnownMarketplaces في المؤسسات. كما يمكن للـ plugins أن تتضمّن hooks تعمل تلقائيًا عند نقاط دورة الحياة؛ راجع الشرح المفصّل لمعرفة كيفية عملها. ذات صلة: Claude Agent Skills، وMCP، وClaude Code Artifacts.

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

Q. ما الفرق بين plugin وskill؟
A. الـ skill هو أحد المكوّنات داخل plugin. أما الـ plugin فهو وحدة توزيع (دليل) تجمع skills إضافةً إلى أوامر slash وsubagents وhooks وخوادم MCP. الـ plugin هو «الصندوق» الذي تشحن به skills وأوامرك المتكرّرة إلى فريق؛ والـ skill هو أحد «أوراق التعليمات» داخل ذلك الصندوق.

Q. كيف أثبّت plugin؟
A. أولًا أضِف marketplace (كتالوجًا) بـ /plugin marketplace add owner/repo، ثم ثبّت فرديًا بـ /plugin install plugin-name@marketplace-name. الـ marketplace الرسمي (claude-plugins-official) متاح تلقائيًا من أول تشغيل، ويمكنك التصفّح على claude.com/plugins أو عبر Discover في /plugin. بدّل الحالة بـ /plugin enable|disable؛ واسرد بـ /plugin list.

Q. هل يمكنني بناء plugin خاص بي وتوزيعه؟
A. نعم. ضع .claude-plugin/plugin.json (ملف بيان) وskills/…/SKILL.md، واختبر دون تثبيت عبر claude --plugin-dir ./your-plugin. للنشر، يكفي وضع .claude-plugin/marketplace.json في جذر مستودع git؛ يضيفه المستخدمون بـ /plugin marketplace add owner/repo. تذكّر: لا يُوضَع داخل .claude-plugin/ سوى plugin.json — وskills/ وغيرها تقع في الجذر.

Q. كيف تعمل إدارة الإصدارات؟
A. تُحَلّ كالتالي: version في plugin.json ← (وإلا) version في مدخلة الـ marketplace ← (وإلا) الـ git commit SHA. إن ضبطت version، فلا تصل التحديثات إلى المستخدمين إلا عندما ترفع رقمه، لذا ارفعه في كل إصدار (وإلا بقي المستخدمون على القديم). احذف version ويصبح كل commit إصدارًا جديدًا. تحقّق قبل النشر بـ claude plugin validate ..

Q. هل plugins الجهات الخارجية آمنة؟
A. ليست آمنة دون شروط. يشير التوثيق الرسمي إلى أن الـ plugin «يمكنه تنفيذ شيفرة عشوائية بصلاحياتك»، ولا تتحقّق Anthropic من plugins الجهات الخارجية ولا من MCP المُضمَّن فيها. ثبّت فقط من ناشرين موثوقين، وراجع الشيفرة إن لم تكن متأكدًا. ويمكن للمؤسسات تقييد المصادر المسموح بها عبر strictKnownMarketplaces ([] لإغلاق كامل).