Claude Code: نظام الإضافات

آخر تحديث: 2026-08-31

الإضافات تجعل قدرات Claude Code قابلة للتوصيل — ثبّت إضافة، واحصل على قدرة جديدة، دون تعديل الكود الأساسي.

💡 نصيحة: إضافات Claude Code و MCP هما طريقتان مختلفتان للتوسيع. الإضافات تعدّل سلوك Claude Code نفسه؛ وMCP يوسّع قدرته على الاتصال بالعالم الخارجي.

📋 المتطلبات السابقة: الفصل 13 - الوكلاء الفرعيون

1. ما ستتعلمه


2. بنية نظام الإضافات

(1) أنواع الإضافات

النوع الغرض مثال
إضافات الأدوات إضافة أدوات/أوامر جديدة أداة تحليل الكود
إضافات الخطافات سلوك مخصص عند أحداث محددة فحص تلقائي قبل الالتزام
إضافات السمات تغيير نمط الإخراج عرض الفروقات بالألوان
إضافات التكامل ربط خدمات خارجية تكامل مع Jira

(2) مقارنة الإضافات مع MCP

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

3. الإضافات الرسمية والمجتمعية

(1) الإضافات الرسمية

الإضافة الوظيفة التثبيت
claude-plugin-lint فحص تلقائي للملفات المعدّلة claude plugin add lint
claude-plugin-test تشغيل الاختبارات تلقائياً بعد التعديلات claude plugin add test
claude-plugin-git تكامل محسّن مع git claude plugin add git
claude-plugin-doc توليد التوثيق تلقائياً claude plugin add doc

(2) إدارة الإضافات

BASH
# عرض الإضافات المثبتة
claude plugin list

# تثبيت إضافة رسمية
claude plugin add lint

# تثبيت إضافة مجتمعية
claude plugin add @community/claude-plugin-jira

# تعطيل إضافة
claude plugin disable lint

# إزالة إضافة
claude plugin remove lint

# تحديث الإضافات
claude plugin update

▶ مثال 1: سير عمل إضافة الفحص

TEXT 📖 للعرض فقط
# بعد تثبيت إضافة الفحص

> أعد هيكلة دالة slugify في src/utils/string.ts

Claude Code:
  → قراءة src/utils/string.ts
  → تعديل دالة slugify...
  → [إضافة الفحص] تشغيل: npm run lint -- --fix
  → [إضافة الفحص] وُجدت مشكلة واحدة: نوع الإرجاع مفقود
  → إصلاح تلقائي: إضافة نوع إرجاع string
  → [إضافة الفحص] كل شيء نظيف ✓
  → تشغيل: npm test -- string.test.ts
  ✅ جميع الاختبارات نجحت

4. تهيئة الإضافات

(1) التهيئة العامة

JSON
// ~/.claude/plugins.json
{
  "plugins": [
    {
      "name": "lint",
      "enabled": true,
      "config": {
        "runOnSave": true,
        "fix": true
      }
    }
  ]
}

(2) تهيئة على مستوى المشروع

JSON
// .claude/plugins.json
{
  "plugins": [
    {
      "name": "lint",
      "config": {
        "command": "npm run lint:fix",
        "files": ["src/**/*.ts"]
      }
    }
  ]
}

5. أساسيات تطوير الإضافات

▶ مثال 2: إضافة بسيطة

TYPESCRIPT
export default {
  name: "my-custom-linter",
  version: "1.0.0",

  hooks: {
    "after:file:write": async (context) => {
      const { filePath } = context;
      if (filePath.endsWith(".ts")) {
        const { execSync } = require("child_process");
        try {
          execSync(`npx eslint --fix ${filePath}`, { stdio: "pipe" });
        } catch (e) {
          console.log(`[my-linter] Issues in ${filePath}`);
        }
      }
    },
  },
};

6. أفضل ممارسات الإضافات

المبدأ الوصف
الحد الأدنى ثبّت فقط الإضافات الضرورية
التحقق من المصدر فضّل الإضافات الرسمية؛ راجع الإضافات المجتمعية
الاختبار أولاً تحقّق من الإضافات الجديدة في مشاريع اختبار
التنظيم الدوري أزل الإضافات غير المستخدمة
تجنب التكرار الإضافات من نفس النوع قد تتعارض

❓ أسئلة شائعة

س إضافة أم MCP؟
ج استخدم MCP للاتصال بخدمات خارجية (قواعد بيانات، GitHub)؛ واستخدم الإضافات لتعديل سلوك Claude Code (فحص تلقائي، أوامر مخصصة). يمكن لكليهما التعايش.
س هل الكثير من الإضافات يبطئ الأداء؟
ج نعم. كل إضافة تستخدم وقت تحميل وذاكرة. ثبّت فقط ما تحتاجه.
س هل الإضافات المجتمعية آمنة؟
ج غير مضمونة. تحقّق من الكود المصدري وسمعة المؤلف قبل التثبيت.
س هل يمكن تثبيت إضافات متعددة من نفس النوع؟
ج ممكن لكن قد يحدث تعارض. إضافتا فحص قد تطبّقان قواعد مختلفة. أبقِ إضافة واحدة لكل نوع.

📖 ملخص


📝 تمارين

  1. أساسي (⭐): ثبّت إضافة الفحص الرسمية، وتحقق من الفحص التلقائي عند تعديل الملفات.
  2. متوسط (⭐⭐): ثبّت وتهيّئ إضافتين مع التأكد من عدم وجود تعارضات.
  3. متقدم (⭐⭐⭐): طوّر إضافة مخصصة تشغّل التنسيق والفحص تلقائياً بعد كل تعديل ملف.
Web-Tutorial.com

فريق Web-Tutorial التقني

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

100%