ما هي إضافات Claude Code وكم تكلف؟

ما هو مكوّن Claude Code الإضافي

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

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

يسمّي ملف البيان الاختياري في .claude-plugin/plugin.json المكوّن الإضافي، ويصبح هذا الاسم مساحة أسماء. تُستدعى مهارة في مكوّن إضافي اسمه commit-commands باستخدام /commit-commands:commit، لذلك يمكن لمكوّنين إضافيين أن يوفّرا كل منهما مهارة باسم commit دون أن تحجب إحداهما الأخرى. ويُحدَّد نطاق وكلاء المكوّن الإضافي بالطريقة نفسها في قائمة الإشارات باستخدام @، كما في plugin-name:agent-name.

إضافة، أو skill، أو خادم MCP، أو ملف قواعد

تُستخدم هذه المصطلحات الأربعة أحياناً كما لو كانت بدائل متنافسة. لكنها ليست كذلك، ومن المفيد توضيح الحد الفاصل بينها مرة واحدة.

• الـskill هي وحدة واحدة من التعليمات يحمّلها Claude عندما تتطلب المهمة ذلك. راجع ما المقصود فعلياً بـ Agent Skill.
• خادم MCP هو عملية منفصلة تتيح للوكيل استخدام الأدوات عبر بروتوكول، وغالباً ما يكون خدمة شبكية تشغّلها بنفسك.
• ملف القواعد، مثل CLAUDE.md، هو سياق خاص بالمشروع يُقرأ عند بدء الجلسة وينطبق على كل شيء.
• الإضافة هي حاوية يمكن أن تضم skills ووكلاء وhooks وتعريفات خوادم MCP معاً، إضافة إلى رقم إصدار وقناة توزيع.

لذلك، لا تجيب الإضافة عن سؤال «ما الذي يستطيع الوكيل فعله؟». بل تجيب عن سؤال «كيف أوزّع هذا على فريقي وأحدّثه في الشهر المقبل؟». إذا كنت تختار بين العناصر الثلاثة الأولى، فسيغطي مقارنة skills وخوادم MCP وملفات القواعد هذا القرار بالتفصيل. وإذا كان الجزء المتعلق بـMCP هو ما يهمك، فسيغطي تشغيل خوادم MCP الخاصة بك على VPS جانب الاستضافة.

مكان وجود الإضافات ومحتويات الإضافة

تُنسخ الإضافة المثبّتة من marketplace إلى cache محلي في ~/.claude/plugins/cache بدلاً من تشغيلها من المكان الذي نُسخت منه. يحصل كل إصدار مثبّت على directory خاص به. عند تحديث الإضافة أو إلغاء تثبيتها، يُعلَّم directory الإصدار القديم باعتباره orphaned ويُحذف بعد نحو أسبوعين، لذلك تستمر الجلسة التي حمّلت الإصدار القديم في العمل بدلاً من فشلها أثناء تنفيذ المهمة.

بما أن المسار يتغير مع كل تحديث، يجب ألا تضع الإضافة مسارها في hardcode مطلقاً. تستخدم hooks وMCP configs داخل الإضافة ${CLAUDE_PLUGIN_ROOT}، الذي يُحل إلى directory التثبيت الحالي. أما الحالة التي يجب أن تستمر بعد التحديث، فضعها في ${CLAUDE_PLUGIN_DATA}، الذي يُحل إلى directory ثابت ضمن ~/.claude/plugins/data/.

لا يُنسخ إلى cache سوى directory الخاص بالإضافة، ولهذا نتيجة يواجهها المستخدمون في مرحلة متأخرة. يعمل المسار الذي يشير إلى خارج جذر الإضافة، مثل ../shared-utils، أثناء التطوير باستخدام local path، لكنه يتعطل بعد التثبيت، لأن هذه الملفات لم تُنسخ قط.

يبدو التخطيط كما يلي.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

يدخل plugin.json فقط داخل .claude-plugin/. أما كل شيء آخر فيبقى في جذر الإضافة. ويُعد وضع skills/ أو hooks/ داخل .claude-plugin/ السبب الأكثر شيوعاً لتثبيت الإضافة بنجاح ثم عدم تنفيذها أي شيء: يبحث Claude Code عن هذين directory في الجذر، ولا يجد أياً منهما، ثم يحمّل إضافة بلا مكوّنات.

يكون manifest نفسه صغيراً.

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

كيفية تثبيت إضافة Claude Code

يتكوّن التثبيت من خطوتين، ولا تثبّت الخطوة الأولى أي شيء. تضيف marketplace، وهي كتالوج للإضافات، ثم تثبّت الإضافات الفردية منها. تتم إضافة marketplace الرسمية من Anthropic، claude-plugins-official، تلقائياً عند تشغيل Claude Code تفاعلياً للمرة الأولى. أما غيرها فتضيفه بنفسك.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

لاحظ أن المستودع هو anthropics/claude-code، بينما اسم marketplace هو claude-code-plugins. يأتي الاسم من ملف الكتالوج داخل المستودع، وليس من مسار المستودع. لذلك اقرأ اسم marketplace من علامة التبويب Marketplaces في /plugin قبل كتابة أمر التثبيت.

بعد التثبيت، اقرأ سطر الملخص. يعني Plugin is now active. أن المكونات محمّلة في هذه الجلسة. ويعني Run /reload-plugins to activate. أنها غير محمّلة، وعليك تشغيل ذلك الأمر. إذا حذّر /reload-plugins من أنه سيعيد قراءة المحادثة، فأعد تشغيله بصيغة /reload-plugins --force. ثم تأكد من وجود الإضافة فعلاً: يعرض /plugin الإضافة ضمن علامة التبويب Installed، ويسرد /help مهاراتها ضمن علامة التبويب Custom commands، بينما تظهر أي مكونات فشل تحميلها ضمن علامة التبويب Errors مع سبب الفشل.

يطلب التثبيت تحديد نطاق، ويحدد النطاق الأشخاص الذين يحصلون على الإضافة. نطاق المستخدم يعني أنك تحصل عليها في كل مشروع. يكتب نطاق المشروع الإضافة داخل .claude/settings.json في المستودع، تحت enabledPlugins، ولذلك تُعرض لكل من يستنسخ المستودع. أما النطاق المحلي فيعني أنك تحصل عليها في هذا المستودع فقط.

استخدم صيغة shell للسكربت أو Dockerfile أو أي جلسة لا تتوفر فيها لوحة تفاعلية. تُثبّت هذه الصيغة الإضافة ضمن نطاق المستخدم، ما لم تمرر --scope.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

يعمل claude plugin install خارج الجلسة، لذلك لن ترى الجلسة المفتوحة مسبقاً الإضافة الجديدة حتى تشغّل /reload-plugins أو تبدأ جلسة جديدة.

تتبع إدارة الإضافات المثبتة النمط نفسه في الموضعين. يطبع /plugin list الإضافات المثبتة، ويقبل --enabled أو --disabled. يعطّل /plugin disable name@marketplace الإضافة دون إزالتها، ويعيد /plugin enable تفعيلها، بينما يزيلها /plugin uninstall. تفتح صيغ أوامر الشرطة المائلة لوحة الإضافات لتطبيق التغيير. لذلك استخدم مكافئات shell في claude plugin ... داخل السكربتات.

لمشاركة marketplace مع فريق كامل، ضعه في .claude/settings.json الخاص بالمشروع. سيُطلب من الأعضاء تثبيته بعد الوثوق بمجلد المستودع.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

أثناء تطوير إضافتك الخاصة، تجاوز marketplace بالكامل. يحمّل claude --plugin-dir ./my-plugin دليلاً لهذه الجلسة، ويلتقط /reload-plugins تعديلاتك دون إعادة التشغيل، بينما يتحقق claude plugin validate ./my-plugin من البيان، وبيانات frontmatter الخاصة بالمهارة والوكيل، وhooks/hooks.json قبل أن يراها أي شخص آخر.

ما تكلفة إضافة Claude Code؟

الآلية مجانية. حتى August 2026، لا توجد رسوم لإضافة marketplace أو تثبيت plugin أو إبقائه مفعّلاً. إنّ marketplaces الرسمية والمجتمعية عبارة عن مستودعات git عامة، وplugin عبارة عن مجلد يضم ملفات نصية.

ما يستهلكه plugin هو tokens، وهي ما تقيسه فعلياً باقة الاشتراك أو فاتورة API. يعتمد أيٌّ منهما يتأثر بذلك على طريقة دفعك مقابل الأداة أساساً، وتوضّح تكلفة Claude Code ضمن كل خطة مستويات الاشتراك إلى جانب تسعير API لكل token. تصل هذه التكلفة بثلاث طرق مختلفة، ولكل طريقة سلوك مختلف.

تكلفة السياق الثابت. يضاف ما يقدمه plugin إلى سياقك، ويُعاد قراءته في كل دور من أدوار الجلسة. قبل التثبيت، يعرض عرض التفاصيل /plugin تقديراً Context cost بعدد tokens، بالإضافة إلى قسم Will install يسرد commands وskills وagents وhooks وخوادم MCP وLSP التي ستضيفها. اقرأ كليهما. قد لا توفر plugins من marketplaces محلية أو مخصصة هذه البيانات، وعندها عليك إجراء التقدير يدوياً. يكون plugin الذي يضم خادم MCP عادةً الأثقل، لأن تعريفات الأدوات كبيرة، لكن هذه التعريفات تؤجَّل في النماذج التي تدعم البحث عن أدوات MCP حتى الحاجة إلى أداة.

تكلفة الاستدعاء. يؤدي تشغيل skill في plugin إلى إلحاق تعليماته بالمحادثة، لذلك لا تدفع تكلفة نص skill إلا عند استخدامه. لكن النص نفسه هو الجزء الأقل تكلفة، أما ما يطلبه skill من agent فقد يكون مكلفاً: تنفق طريقة Depth Tree في skill unlazy معظم tokens على عمليات المعالجة الإضافية التي يفرضها قبل السماح لـagent باعتبار المهمة مكتملة، وليس على الملف الذي ثبّتَّه. يختلف agent عن ذلك. إذ يجري subagent محادثته الخاصة باستخدام system prompt وcache خاصين به، ويبدأ دون أي cache hits، لذلك فإن plugin الذي ينشئ agents ضمن سير عمله يكلّف أكثر بكثير مما يوحي به تقدير السياق.

تكلفة cache. قد يؤدي تفعيل plugin أو تعطيله أثناء الجلسة إلى إجبار الطلب التالي على إعادة معالجة المحادثة بأكملها. لا تفعل skills وcommands وagents وhooks وخوادم LSP وmonitors وthemes ذلك إطلاقاً: إذ تُلحق الإضافات التي تقدمها بعد السجل الموجود، ولذلك يدفع الطلب التالي تكلفة المحتوى الجديد، ويقرأ كل ما سبقه من cache. الاستثناء هو plugin الذي يوفر خادم MCP. إذا كانت أدواته مؤجَّلة بواسطة البحث عن الأدوات، يبقى cache صالحاً. أما إذا حُمّلت في بادئة prompt، فيعيد الطلب التالي قراءة المحادثة بأكملها كمدخلات غير مخزنة في cache. ولهذا تحديداً يحذّر /reload-plugins ويرفض المتابعة في هذه الحالة إلى أن تمرر --force.

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

توجد مهمة صيانة واحدة تعوّض تكلفتها. يجمع تبويب Installed الـplugins التي لم تستخدمها منذ أسبوعين على الأقل تحت عنوان Not used recently، ويعرض سطر Last used في عرض التفاصيل. تظل هذه الـplugins تستهلك وقت بدء التشغيل وسياقاً في كل جلسة. عطّلها أو أزل تثبيتها.

يعمل المكوّن الإضافي بصلاحياتك

توضح وثائق Anthropic الرسمية ذلك بصرامة: المكوّنات الإضافية والأسواق مكوّنات موثوقة بدرجة عالية، ويمكنها تنفيذ تعليمات برمجية عشوائية على جهازك باستخدام صلاحيات المستخدم لديك. هذا ليس افتراضاً نظرياً. تنفّذ خطافات المكوّن الإضافي أوامر shell عند وقوع أحداث الجلسة، بما في ذلك قبل استدعاءات الأدوات وبعدها. يُضاف مجلد bin/ إلى PATH الخاص بأداة Bash ما دام المكوّن الإضافي مفعّلاً. أما خوادم MCP الخاصة به فهي عمليات يبدأها المكوّن الإضافي. لا شيء في هذا معزول عن حساب المستخدم لديك.

على الحاسوب المحمول، يظل هذا الخطر محصوراً بما يمكن لمستخدم سطح المكتب الوصول إليه. أما على الخادم، فعادةً لا يكون الأمر كذلك. غالباً ما يملك الحساب الذي يشغّل الوكيل مفاتيح SSH، ورموز النشر، وجلسة cloud CLI، وإمكانية الوصول إلى مقبس Docker، ولذلك فإن عبارة «تنفيذ تعليمات برمجية عشوائية بصلاحياتك» تعني عملياً الجهاز كله. إذا كان Claude Code يعمل على VPS، فاقرأ كيفية تشغيل Claude Code بأمان على VPS قبل تثبيت أي شيء، واقرأ كيفية إبقاء بيانات الاعتماد بعيدة عن متناول الوكيل قبل تثبيت مكوّن إضافي يتصل بخدمة خارجية. تواجه الأطر الأخرى المشكلة نفسها على الخادم المستأجر نفسه، ولذلك تقتصر المكوّنات الإضافية التي تستحق التثبيت في DeepSeek Harness غالباً على حدود الإنفاق، وقواعد صلاحيات الأدوات، وفحص حقن التعليمات، بدلاً من إضافة قدرات جديدة.

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

لا يغني أي من ذلك عن قراءة ما تثبّته. تحقّق من قائمة Will install، وفضّل المكوّنات الإضافية التي يمكنك فتح مصدرها وقراءته، واحتفظ بمكوّنات فريقك الإضافية في مستودع سوق تتحكم فيه، وشغّل claude plugin validate على أي شيء تكتبه بنفسك.

FAQ

هل تكلّف إضافات Claude Code أموالاً إضافية؟

لا. لا توجد رسوم على نظام الإضافات، أو إضافة marketplace، أو تثبيت إضافة. التكلفة هي استخدام الرموز، وتُحتسب ضمن خطتك أو إنفاقك على API مثل أي سياق آخر. تضيف الإضافة سياقاً ثابتاً في كل دورة، وتضيف سياقاً آخر عند استدعاء إحدى مهاراتها أو وكلائها، وقد تفرض دورة واحدة مكلفة وغير مخزنة مؤقتاً إذا كانت توفّر خادم MCP تُحمّل أدواته في بادئة الطلب. يعرض منظور التفاصيل /plugin تقديراً Context cost قبل التثبيت.

ما الفرق بين الإضافة والمهارة؟

المهارة وحدة واحدة من التعليمات. أما الإضافة فهي حزمة يمكن أن تحتوي على مهارات ووكلاء وhooks وخوادم MCP وخوادم LSP ومراقبات، مع اسم وإصدار وmarketplace لتثبيتها منه. اكتب مهارة مستقلة في .claude/ عندما تكون مخصصة لك ولهذا المشروع. تُعد مهارة أحادية الغرض مثل Ponytail، التي تدفع الوكيل إلى إجراء أصغر تغيير ينجح أوضح مثال على ذلك: ملف واحد يتضمن قاعدة واحدة، إلى أن يحتاجها فريقك أيضاً. حوّلها إلى إضافة عندما يحتاج إليها أشخاص آخرون وعندما تحتاج إلى تحديثها بمرور الوقت. تُعرَّف مهارات الإضافات ضمن مساحة أسماء، لذلك تُستدعى المهارة الموجودة داخل إضافة باستخدام /plugin-name:skill-name بدلاً من /skill-name.

ثبّتُّ إضافتي، لكن مهاراتها لا تظهر. ما المشكلة؟

تحقق أولاً من ملخص التثبيت. إذا ظهر فيه Run /reload-plugins to activate.، فهذا يعني أن المكوّنات لم تُحمّل بعد. وإذا حذّرت إعادة التحميل من أنها ستعيد قراءة المحادثة، فأعد تشغيلها باستخدام /reload-plugins --force. إذا تم تحميلها لكنها لا تعرض شيئاً، فافتح /plugin واقرأ علامة التبويب Errors. الخطأ البنيوي الأكثر شيوعاً هو وضع skills/ أو agents/ أو hooks/ داخل .claude-plugin/، إذ لا يبحث Claude Code عنها هناك. تذكّر أن مهارات الإضافات تستخدم مساحات أسماء، لذلك ابحث عن /plugin-name:skill-name في علامة التبويب Custom commands ضمن /help. كحل أخير، نفّذ rm -rf ~/.claude/plugins/cache، ثم أعد التشغيل وأعد التثبيت.

هل يمكنني تثبيت الإضافات من دون اللوحة التفاعلية؟

نعم. استخدم أمر shell claude plugin install name@marketplace، الذي يثبّت الإضافة ضمن نطاق المستخدم ما لم تمرّر --scope project أو --scope local. يعمل هذا الأمر في البرامج النصية والصور والبيئات غير التفاعلية التي لا تتوفر فيها لوحة /plugin. وبما أنه يعمل خارج الجلسة، تحتاج الجلسة المفتوحة بالفعل إلى /reload-plugins قبل أن تصبح الإضافة فعّالة.

هل تثبيت إضافة من marketplace وجدته على GitHub آمن؟

تعامل معها كما تتعامل مع تشغيل البرنامج النصي لتثبيت ذلك المستودع بصفتك المستخدم الحالي، لأن هذا قريب مما تفعله فعلياً. يمكن للإضافة تشغيل أوامر shell عبر hooks، وإضافة ملفات تنفيذية إلى PATH الخاص بأداة Bash، وتشغيل خوادم MCP، وكل ذلك بامتيازات المستخدم لديك. لا تتحكم Anthropic في محتوى الإضافات التابعة لجهات خارجية ولا تتحقق منه. ثبّت الإضافات من مصادر يمكنك قراءة محتواها، وراجع قائمة Will install قبل التأكيد، وكن أكثر تشدداً على الخادم من جهاز الكمبيوتر المحمول، لأن الحساب هناك يحتوي عادةً على مفاتيح ورموز مميزة تستحق السرقة.