وثائق إضافات Claude Code: ما هي الإضافات، كيفية تثبيتها، ومتى تستخدم MCP بدلاً منها

إذا كنت تبحث عن وثائق إضافات Claude Code، فالإجابة المختصرة هي: الإضافات هي طبقة التغليف لملحقات Claude Code. يمكن للإضافة أن تحزم المهارات (skills)، الوكلاء (agents)، الخطافات (hooks)، خوادم MCP، خوادم LSP، والمراقبين في وحدة واحدة قابلة للتثبيت، بينما تبقى MCP هي طبقة ربط الأدوات الأساسية. إذا بحثت عن “mcp plugin” أو “doc plugin”، فهذا هو عادةً التقسيم الذي تريد الوثائق توضيحه: الإضافات توزع الإعداد، MCP يربط الأدوات، والوثائق المرجعية تشرح الشكل التقني لكل جزء.

أصبح لدى Claude Code الآن سطح تمديد كافٍ لدرجة أن المصطلحات قد تصبح غامضة بسرعة. غالباً ما يُستخدم مصطلح “إضافة” كاختصار لكل شيء، حتى عندما تكون الميزة الفعلية المستخدمة هي مهارة، خطاف، أو خادم MCP. هذا الارتباك مهم لأن خطوات التثبيت، نموذج الأمان، وعبء الصيانة مختلفة لكل منها.

قبل أن ندخل في الإعداد، ملاحظة عملية للفرق التي تريد مرونة أكبر في الواجهة الخلفية أكثر من سير عمل يعتمد فقط على النماذج المغلقة: طبقة التمديد في Claude Code منفصلة عن النموذج الذي يعمل خلفه. هذا يعني أنه يمكنك الاحتفاظ بنفس إعداد الإضافة، المهارة، و MCP بينما توجيه الاستدلال من خلال نموذج ترميز مفتوح الوزن على Novita AI مثل qwen/qwen3-coder-480b-a35b-instruct، وهو خيار موثوق للعمل الحقيقي على المستودعات عندما تريد تحكماً أكبر في التكلفة دون التخلي عن الأدوات الوكيلة.

ما تؤكد عليه الوثائق الحالية

الوثائق الحالية لـ Claude Code تفصل أربعة أشياء بوضوح شديد:

• الإضافات (plugins)، التي تحزم التمديدات القابلة لإعادة الاستخدام؛
• MCP، الذي يربط Claude Code بالأدوات ومصادر البيانات الخارجية؛
• المهارات والوكلاء الفرعيون (skills and subagents)، الذين يحملون السلوك القابل لإعادة الاستخدام؛
• الخطافات (hooks)، التي تؤتمت الإجراءات على أحداث دورة الحياة.

هذا يعني أن العديد من عمليات البحث عن “وثائق إضافات Claude Code” تطلب في الواقع مرجع الإضافات، سير عمل الاكتشاف/التثبيت، أو وثائق MCP التي تشرح كيفية عمل اتصال الأدوات. كما تكشف الوثائق الحالية عن مسارات التثبيت والتوزيع القائمة على السوق، بحيث يمكنك تثبيت إضافات مبنية مسبقاً بدلاً من ربط كل مكون يدوياً بنفسك.

ما هي إضافات Claude Code في الواقع

تعرف وثائق Anthopic الحالية الإضافات بأنها طبقة التوزيع وإعادة الاستخدام لتمديدات Claude Code. عملياً، هذا يعني أن الإضافة هي دلل مكتف بذاته مع مإنفست ومكونات تمديد اختيارية مثل:

• المهارات (skills)
• الوكلاء (agents)
• الخطافات (hooks)
• تكوين MCP
• تكوين LSP
• برامج مساعدة (helper binaries)
• الإعدادات الافتراضية

لهذا السبب تهم وثائق الإضافة الرسمية حتى لو كان ما تريده حقاً هو مهارة قابلة لإعادة الاستخدام أو سقف MCP بأمر واحد. الإضافة هي غالباً الشيء الذي تثبته، لكن السلوك الذي يهمك يعيش داخل المكونات المحزمة.

أهم نتيجة هي التسمية. مهارات الإضافة هي ذات مساحة اسمية، لذا يبدو الأمر من الإضافة هكذا الشكل:

/my-plugin:hello

هذه المساحة الاسمية ليست تزينية. هي تمنع التصادمات بين الإضافات التي تشرع أوامر مشابهة في الاسم.

الإضافات مقابل MCP مقابل المهارات مقابل الخطافات

هنا يفقد معظم المطورين الوقت في الوثائق.

استخدم هذا الاختصار:

الميزة	ما تفعله	أفضل حالة استخدام
الإضافة	تحزم وتوزع التمديدات	إعادة استخدام نفس الإعداد عبر المشاريع أو زملاء الفريق
MCP	يربط Claude Code بالأدوات والخدمات الخارجية	GitHub، Notion، قواعد البيانات، التحكم في المتصفح، واجهات برمجة التطبيك الداخلية
المهارة	تزود Claude بمرفة قابلة لإعادة الاستخدام أو سير عمل	قوائم المراجعة، تدفقات النشر، أسلوب العمل، التوجيهات المتكررة
الخطاف	يعمل تلقائياً على أحداث دورة الحياة	التدفيق بعد التعديل، منع الأوامر الخطرة، تشغيل الإشعارات

العديد من أسئلة “إضافة Claude Code” هي في الحقيقة أسئلة عن MCP. إذا كان هد فك هو “ربط Claude Code بـ Jira” أو “دع Claude يستعلم قاعدة بياتنا”، فأنت لست باحثاً بشكل أساي عن ميزة إضافة. أنت باحث عن خادم MCP، الذي قد يكون مثبتاً مباشرة أو محزوماً داخل إضافة. عملياً، هذا يعني أن العديد من عمليات البحث عن MCP plugin هي في الحقيقة عمليات بحث عن الخادم المناس مع مسار التعبئة أو التثبيت المناسب.

لهذا أيضاً سبة أهمية نظرة عامة على الميزات في وثائق Anthopic: فهي تفصل بوضوح الإضافات عن MCP وعن المهارات. الإضافات هي الغلاف. MCP هو الاتصال الخارجي. المهارات هي التعلإيمات القابلة لإعادة الاستخدام. الخطافات هي طبقة الأتمتة.

من منظور Novita stack، هذا أيضاً أنقى مكان لفصل الاسدلال عن التنفيذ. إذا كنت تبني سير عمل مخصصاً قريباً من Claude Code حول أدوات MCP، يمكن لـ Novita AI LLM API التعامل مع طبقة الاستدلال لاستخدام الأدوات بينما Novita Agent Sandbox تتعامل مع طبقة التنفيذ المعزولة للكود، أوامر الصدفة، والآثار الجانبية للأدوات. هذا التقسيم يعكس طبيعياً الحدود بين “النموذج يقرر” و “وقت التشغيل ينفذ” التي تصفها وثائق الإضافات و MCP حقاً.

متى يجب أن تستخدم إضافة

استخدم إضافة عندما يكون واحد على الأقل من هذه صحيحاً:

• تريد نفس تخصيص Claude Code عبر مستودعات متعددة؛
• تريد أن يقوم زملاء الفريق بتثبيت شيء واحد بدلاً من نسخ ملفات .claude/ يدوياً؛
• تريد تغليفاً قابلاً للمشاركة ومُرقماً للمهارات، الخطافات، أو تكوينات MCP؛
• تخطط لتوزيع الامتداد من خلال سوق.

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

بكلمات أخرى:

• التكوين المستقل أفضل للتجربة المحلية؛
• الإضافات أفضل لقابلية النقل والتوزيع.

أسرع طريقة لتثبيت إضافة موجودة

إذا كنت تعرف بالفعل اسم الإضافة والسوق، تشير الوثائق الحالية إلى تدفق أمر الشرطة المائلة من داخل Claude Code.

على سبيل المثال، تستخدم وثائق MCP الخاصة بـ Anthropic مسار التثبيت هذا للإضافة الرسمية mcp-server-dev:

/plugin install mcp-server-dev@claude-plugins-official

إذا أبلغ Claude Code أن السوق مفقود، أضفه أولاً:

/plugin marketplace add anthropics/claude-plugins-official

ثم أعد تشغيل أمر التثبيت.

بعد التثبيت، تحقق مما إذا كان Claude يخبرك بإعادة تحميل الإضافات. إذا فعل، قم بتشغيل:

/reload-plugins

خطوة إعادة التحميل هذه أهم مما تبدو. إنه سبب شائع لاعتقاد المطورين أن إضافة “لم تعمل” بينما الملفات موجودة لكن الأوامر غير نشطة في الجلسة الحالية.

كيفية إنشاء إضافة Claude Code الخاصة بك

إذا كنت تريد بناء إضافتك الخاصة، تحدد وثائق الإضافات الحالية بداية سريعة مباشرة:

1. أنشئ دليل إضافة.
2. أضف .claude-plugin/plugin.json.
3. أضف دليل skills/، agents/، hooks/، أو دليل امتداد مدعوم آخر.
4. شغل Claude Code مع --plugin-dir أثناء التطوير.

أصغر مثال مفيد هو إضافة تحتوي على مهارة واحدة. تُظهر وثائق Anthropic بياناً مع مجلد skills/<name>/SKILL.md. يحدد البيان هوية الإضافة، وتصبح المهارة أمراً ذا مساحة اسمية.

أثناء التطوير، تدفق الاختبار الأساسي هو:

claude --plugin-dir ./my-first-plugin

ثم استدع المهارة من داخل Claude Code:

/my-first-plugin:hello

تفصيل واحد يسهل تفويته: فقط plugin.json ينتمي داخل .claude-plugin/. أدلة skills/، agents/، و hooks/ الخاصة بك تبقى في جذر الإضافة، وليس متداخلة تحت .claude-plugin/.

لماذا تذكر الوثائق MCP داخل أدلة الإضافات

لأن الإضافة يمكن أن تحتوي على تكوين MCP.

هذا مفيد عندما يكون لديك خدمة داخلية يحتاج كل مهندس في فريقك إلى أن يصل إليها Claude Code. بدلاً من إخبار الجميع بتكوين نفس خادم MCP يدوياً، يمكنك حزم هذا التكوين مع بقية سير عمل Claude Code الخاص بك.

هذا لا يجعل MCP قديماً. إنه يغير فقط كيفية تسليم الخادم.

فكر في الأمر بهذه الطريقة:

• MCP يجيب على: “كيف يتحدث Claude مع هذا النظام الخارجي؟”
• الإضافة تجيب على: “كيف نوزع هذا الإعداد بشكل نظيف؟”

إذا كنت تصمم منصة مطورين داخلية، فهذا التمييز يوفر الكثير من عمل الإعداد المكرر.

متى يكون MCP نقطة البداية الأفضل

ابدأ بـ MCP، وليس إضافة، عندما يكون المطلب الرئيسي هو الوصول الخارجي:

• متتبعات المشكلات (issue trackers)
• أدوات المراقبة
• Slack
• Notion
• قواعد البيانات
• أتمتة المتصفح
• خدمات HTTP الداخلية

تُظهر وثائق MCP الحالية لـ Anthropic أربعة أوضاع اتصال شائعة:

• خوادم HTTP عن بعد
• خوادم SSE عن بعد
• خوادم stdio محلية
• خوادم WebSocket عن بعد

معظم الخدمات السحابية، HTTP هو النقل الموصى به. لا يزال SSE موثقاً، لكن Anthropic تشير إليه كقديم حيثما يكون HTTP متاحاً.

إذا كنت تحتاج فقط إلى توصيل خدمة واحدة لنفسك، فإن claude mcp add هو عادةً أنقى مكان للبدء. قم بلفه في إضافة لاحقاً إذا أثبت الإعداد قابليته لإعادة الاستخدام.

يمنح MCP Claude Code طريقة للوصول إلى الأدوات، لكنه لا يستبدل بيئة تنفيذ آمنة عندما تحتاج إحدى تلك الأدوات إلى تشغيل كود، لمس ملفات، أو تنفيذ أوامر. في هذا الإعداد، فإن Novita AI LLM API هي الواجهة الخلفية للاستدلال التي تقرر متى وكيف تستدعي الأدوات، بينما Novita Agent Sandbox هي بيئة التنفيذ الأكثر أماناً لجانب تشغيل الكود من سير العمل. إذا كانت إضافتك أو خادم MCP يعرض تنفيذ كود عن بعد، أتمتة متصفح، أو مساعدات مدعومة بالصدفة، فإن هذا الفصل هو أكثر من مجرد نظافة معمارية. إنه الفرق بين “يمكن لـ Claude استدعاء هذه الأداة” و “هذه الأداة تعمل في بيئة تشغيل معزولة بدلاً من كمبيوتر مهندس أو مضيف مشترك.”

قاعدة قرار عملية

إذا كنت لا تزال غير متأكد من صفحة الوثائق التي تحتاجها فعلاً، استخدم هذه القاعدة:

• “أريد Claude Code ليفعل شيئاً بنفس الطريقة كل جلسة.” ابداً بـ CLAUDE.md أو مهارة.
• “أريد Claude Code ليتحدث مع نظام آخر.” ابدأ بـ MCP.
• “أريد هذا الإعداد ليكون سهلاً لإعادة الاستخدام أو المشاركة.” قم بتغليفه كإضافة.
• “أريد شيئاً ليعمل تلقائياً على حدث.” استخدم خطاف.

هذا أكثر فائدة من حفظ أسماء الميزات لأنه يطابق مباشرة المشكلة التي تحلها.

أين يتناسب هذا في سير عمل حقيقي

إذا كان إعداد الإضافة أو MCP هو مجرد قطعة واحدة من كومة وكيل أكبر، قم بإقرانها مع ما هي وكلاء البرمجة؟، بيئة تشغيل الوكيل مقابل مفسر الكود، و صندوق حماية خادم MCP: خوادم MCP معزولة مع نظام ملفات، أسرار، وضوابط شبكة. سيعطيك ذلك السلسلة الكاملة من التخطيط إلى الوصول للأدوات إلى التنفيذ المعزول.

سير عمل إضافة جيد للفرق الحقيقية

معظم الفرق، أنظف تقدم يبدو هكذا:

1. قم بتجريب سير العمل في .claude/ أو بأوامر claude mcp add مباشرة.
2. احتفظ فقط بالأجزاء التي أثبتت فائدتها في العمل الحقيقي.
3. احزم تلك الأجزاء في إضافة مع بيان واضح ومهارات ذات مساحة اسمية.
4. شاركها من خلال سوق أو مسار توزيع داخلي.

هذا يتجنب نمط الفشل الأكثر شيوعاً: تحويل كل فكرة إلى إضافة قبل أن يعرف أي شخص ما إذا كان سير العمل يستحق الصيانة.

إذا كان فريقك يقرن Claude Code مع واجهة خلفية لنموذج بديل، فهذه أيضاً مرحلة يمكن أن تكون Novita AI مفيدة فيها تشغيلياً. تبقى طبقة الإضافة و MCP كما هي، بينما يمكن أن ينتقل توجيه النموذج إلى Novita AI LLM API لجلسات مكثفة في البرمجة لا تحتاج إلى نموذج مغلق متميز في كل خطوة. هذا التقسيم غالباً أبسط من إعادة تصميم كومة الامتداد نفسها.

الأخطاء الشائعة في إعداد إضافة Claude Code

هذه هي الأخطاء التي تضيع أكبر وقت:

معاملة كل امتداد كإضافة

أحياناً الإجابة الصحيحة هي مهارة بسيطة أو تكوين خادم MCP مباشر. التغليف المبكر يضيف صيانة.

وضع الملفات في الدليل الخطأ

plugin.json يذهب إلى .claude-plugin/. المهارات والخطافات لا تفعل.

نسيان المساحة الاسمية

يتم استدعاء مهارة الإضافة ببادئة الإضافة، وليس كأمر عام.

تخطي إعادة التحميل بعد التثبيت

إذا أخبرك Claude بتشغيل /reload-plugins، افعل ذلك قبل افتراض فشل التثبيت.

استخدام إضافة عندما تكون الحاجة الحقيقية هي MCP

إذا كانت المشكلة الأساسية هي اتصال الأداة، ركز على MCP أولاً وحزم لاحقاً.

الخلاصة

وثائق إضافات Claude Code تصبح أكثر منطقية بمجرد أن تتوقف عن معاملة “إضافة” كمفهوم الامتداد الوحيد. الإضافات هي طبقة التوزيع. المهارات تحمل التعليمات القابلة لإعادة الاستخدام. الخطافات تؤتمت أحداث دورة الحياة. MCP يربط Claude Code بالأنظمة الخارجية.

هذا الإطار يجعل بقية الوثائق أسهل بكثير في التنقل. إذا كان هدفك هو الإعداد السريع، ابدأ بأصغر وحدة عمل تحل المشكلة. أضف التغليف فقط عندما يصبح الإعداد يستحق إعادة الاستخدام.

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

هل إضافات Claude Code هي نفس خوادم MCP؟

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

كيف أقوم بتثبيت إضافة Claude Code؟

من داخل Claude Code، استخدم الأمر /plugin install مع اسم الإضافة والسوق. إذا لم يكن السوق موجوداً، أضفه بـ /plugin marketplace add ...، ثم أعد تحميل الإضافات إذا طلب منك Claude ذلك.

هل يجب أن أستخدم إضافة أم ملفات .claude/؟

استخدم ملفات .claude/ للتكرار السريع الخاص بمشروع معين. استخدم إضافة عندما يحتاج الإعداد إلى إعادة استخدامه عبر مشاريع، مشاركته مع زملاء الفريق، أو توزيعه من خلال سوق.

متى يجب أن أستخدم MCP بدلاً من إضافة؟

استخدم MCP أولاً عندما يكون هدفك الرئيسي هو الوصول الخارجي لأنظمة مثل GitHub، Jira، Notion، Slack، أو واجهات API داخلياً. إذا كنت تقارن دليل MCP plugin بصفحة وثائق إضافة، تعامل مع دليل MCP كمرجع لاتصال الأدوات وصفحة وثائق الإضافة كمرجع للتغليف. احزم هذا الإعداد كإضافة لاحقاً فقط إذا كنت بحاجة إلى إعادة استخدام وتوزيع أنظف.

هل يمكن لإضافات Claude Code العمل مع واجهات خلفية نموذجية غير Anthropic؟

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

مقالات موصى بها

• إضافات Claude Code: كيف تمد أدوات MCP Claude Code بقدرات خارجية
• قواعد Claude Code: كيف تكتب CLAUDE.md وتدير سياق البرمجة الوكيلية
• بناء خادم MCP لتنفيذ الكود عن بعد مع Novita Sandbox ومكتبة mcp-use

المصادر تم التحقق منها في 31 أغسطس 2026: نظرة عامة على ميزات Claude Code، وثائق إضافات Claude Code، وثائق MCP لـ Claude Code، و مكتبة نماذج Novita AI.