SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-11-11

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

تعرّف إلى مكوّن Claude Code الإضافي، ومكانه وطريقة تثبيته. لا تدفع شيئاً مقابل الآلية نفسها، لكنك تستهلك رموزاً مقابل ما يضيفه إلى السياق.

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

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

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

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

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

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

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

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

موضع الإضافات وما يوجد داخل إحداها

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

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

بالنسبة إلى الإضافة المنسوخة، لا يُنسخ إلى ذاكرة التخزين المؤقت سوى دليل الإضافة نفسه، باستثناء أهداف الروابط الرمزية الموجودة في مواضع أخرى ضمن marketplace نفسه، إذ تُنسخ هذه الأهداف إلى مواضعها. يعمل script يقرأ مساراً خارج جذر الإضافة، مثل ../shared-utils، أثناء التطوير باستخدام مسار محلي، لكنه يفشل عند نسخ الإضافة إلى ذاكرة التخزين المؤقت، لأن تلك الملفات لم تُنسخ. ويفشل مسار مكوّن مُعرَّف بهذه الطريقة في plugin.json قبل ذلك: إذ يرفض Claude Code أي مسار مكوّن يتجاوز جذر الإضافة، حتى أثناء التطوير، ويعرض خطأ path escapes plugin directory.

يبدو الهيكل كما يلي.

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 عن هذين الدليلين في الجذر، ولا يعثر عليهما، ثم يحمّل إضافة بلا مكوّنات.

ملف البيان نفسه صغير.

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

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

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

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

يأتي اسم السوق من ملف الكتالوج داخل المستودع، وليس من مسار المستودع، لذلك اقرأ اسم السوق من علامة التبويب Marketplaces في /plugin قبل كتابة أمر التثبيت. سوق claude-code-plugins القديم في anthropics/claude-code مهجور؛ استخدم claude-plugins-official لعمليات التثبيت الجديدة. تُحدّث الإضافات الموجودة من ذلك السوق القديم من المستودع الرسمي، لذلك لا تحتاج إلى إعادة تثبيت commit-commands لمجرد تغيير الأسواق.

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

يطلب التثبيت تحديد نطاق، ويحدد النطاق من يحصل على الإضافة. نطاق المستخدم يخصك أنت في كل مشروع. يكتب نطاق المشروع الإضافة في .claude/settings.json للمستودع ضمن enabledPlugins، ما يفعّلها لكل من يستنسخ المستودع. لكنه لا ينزّلها لهم: يظل على كل متعاون تثبيتها مرة واحدة على جهازه، مثلاً باستخدام claude plugin install name@marketplace --scope project، ما لم يكن إدخالها في السوق مساراً نسبياً أو يكن دليل تمهيد يحتوي عليها مسبقاً. أما النطاق المحلي فيخصك أنت في هذا المستودع فقط.

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

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin list

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

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

لإتاحة سوق لفريق كامل، ضعه في .claude/settings.json للمشروع، أو شغّل claude plugin marketplace add your-org/claude-plugins --scope project مرة واحدة ثم نفّذ commit للملف الذي ينشئه. يسجّل Claude Code السوق لكل عضو بمجرد أن يثق بمجلد المستودع.

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

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

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

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

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

تكلفة السياق المستمرة. يضيف كل plugin مفعّل أسماء أوصاف skills وagents وcommands التي يستطيع Claude استدعاءها تلقائياً إلى سياقك، ويُعاد قراءة هذا الجزء في كل دور من الجلسة، سواء نُفّذ أي شيء أم لا. لا تستهلك كل المكوّنات tokens: إذ ينفّذ harness الـhook ولا يضيف شيئاً إلى سياق النموذج. قبل التثبيت، يعرض عرض التفاصيل /plugin قسماً باسم Will install يسرد commands وskills وagents وhooks وخوادم MCP وLSP التي توشك على إضافتها. بالنسبة إلى plugin موجود في official marketplace لدى Anthropic، يعرض أيضاً قسماً باسم Context cost يتضمن تقديرات Every turn وWhen invoked، شرط أن تفتح plugin باستخدام اسمها في marketplace أو من علامة التبويب Marketplaces، لا من قائمة Discover. اقرأ القسمين. لا يحتوي plugin من marketplace تملكه أنت أو يملكه طرف ثالث على قسم Context cost، لكنك لا تحتاج إلى التقدير يدوياً: يطبع claude plugin details name في shell لديك رقماً لـtokens في Always-on وتفصيلاً لكل مكوّن لأي plugin محمّل، بما في ذلك plugin تمرّره باستخدام --plugin-dir، ولذلك يمكنك استنساخ مستودع وتشغيل claude --plugin-dir ./that-plugin plugin details that-plugin قبل تثبيت أي شيء. لا يتضمن هذا الرقم خوادم MCP. يكون plugin الذي يضم خادم MCP عادةً الأثقل، لأن تعريفات الأدوات كبيرة، مع أنّ هذه التعريفات تؤجَّل في النماذج التي تدعم MCP tool search إلى أن تحتاج إلى أداة. شغّل /context في جلسة يكون فيها plugin مفعّلاً، واقرأ السطر MCP tools لمعرفة ما تضيفه هذه المكوّنات.

تكلفة الاستدعاء. يؤدي تشغيل 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 وmonitors وthemes: إذ تُلحق ما تضيفه بعد السجل الموجود، ولذلك يدفع الطلب التالي تكلفة المحتوى الجديد، ويواصل قراءة كل ما سبقه من cache. الاستثناءان هما plugin الذي يوفّر خادم MCP وplugin للذكاء البرمجي، إذ يوفّر language server الخاص به أداة LSP لـClaude. بالنسبة إلى MCP، يعتمد الأمر على tool search: إذا أُجّلت الأدوات، يبقى cache صالحاً، وإذا حُمّلت في بادئة prompt، يعيد الطلب التالي قراءة المحادثة بأكملها باعتبارها input غير مخزّن مؤقتاً. ولهذا تحديداً يحذّر /reload-plugins ويرفض عند تغيير أدوات MCP أو أداة LSP إذا كان التغيير سيكسر cache، إلى أن تمرّر --force.

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

يوفّر إجراء واحد للصيانة تكلفته. تجمع علامة التبويب Installed plugins المثبتة من marketplace التي لم تستخدمها منذ 14 يوماً و10 جلسات على الأقل تحت عنوان Not used recently، مع سطر Last used في عرض التفاصيل. يستثني العنوان plugins المُدارة وplugins الموجودة في seed-directory، وكذلك plugins التي تحتوي على theme أو output style أو monitor أو workflow؛ ويُعدّ خادم LSP مستخدماً عندما يقدّم diagnostics أو يجيب عن طلب للتنقل في التعليمات البرمجية. عند ضبط strictKnownMarketplaces، لا يظهر العنوان ولا السطر Last used:. تظل هذه plugins تستهلك وقت بدء التشغيل وسياقاً في كل جلسة. عطّلها أو أزل تثبيتها. والعادة الأقل تكلفة هي الانتقائية قبل التثبيت: تستعرض أي skills من Matt Pocock تستحق التثبيت مجموعة من 27 skill، وتفصل القليل الذي يحتاج إليه المطوّر الفردي عن تلك التي لا تحقق فائدتها إلا ضمن فريق.

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

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

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

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

لا يغني أي من ذلك عن قراءة ما تثبّته. تحقّق من قائمة Will install، وفضّل المكوّنات الإضافية التي يمكنك فتح مصدرها وقراءته، وأبقِ مكوّنات فريقك الإضافية في مستودع سوق تتحكم فيه، وشغّل claude plugin validate على أي شيء تكتبه بنفسك. وقد يتغير ما راجعته لاحقاً أيضاً: يكون التحديث التلقائي مفعّلاً افتراضياً في أسواق Anthropic الرسمية باستثناء knowledge-work-plugins وfirst-party-plugins، ويكون معطّلاً في الأسواق التابعة لجهات خارجية والمضافة من المصدر؛ وعندما يكون مفعّلاً، يحدّث Claude Code ملفات المكوّن الإضافي في الخلفية.

FAQ

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

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

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

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

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

تحقق أولاً من ملخص التثبيت. إذا كان يعرض Run /reload-plugins to apply.، فسيُجري Claude Code إعادة التحميل هذه عند إغلاق اللوحة، وإذا حذّرت إعادة التحميل من أنها ستعيد قراءة المحادثة، فأعد تشغيلها باستخدام /reload-plugins --force. إذا تم تحميلها ولكن لا يظهر شيء، فافتح /plugin واقرأ علامة التبويب Errors. أكثر الأخطاء البنيوية شيوعاً هو وضع skills/ أو agents/ أو hooks/ داخل .claude-plugin/، حيث لا يبحث عنها Claude Code. تذكّر أن مهارات الإضافات تستخدم مساحات أسماء، لذلك تبحث عن /plugin-name:skill-name عند كتابة /. إذا كانت الإضافة لشخص آخر وتم تحميلها دون خطأ، فافتح جزء تفاصيلها في علامة التبويب Installed: الإضافة التي لا تسرد أي مهارات هناك لا تقدم مهارات. إذا كانت علامة التبويب Errors تشير إلى أن الإضافة غير مخزنة مؤقتاً، فهذا يعني أن دليل تثبيتها مفقود؛ فأعد تثبيتها من shell باستخدام claude plugin install name@marketplace ثم شغّل /reload-plugins.

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

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

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

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

هل كان هذا المقال مفيدًا؟