Claude Code: نظام الإضافات
آخر تحديث: 2026-08-31
الإضافات تجعل قدرات Claude Code قابلة للتوصيل — ثبّت إضافة، واحصل على قدرة جديدة، دون تعديل الكود الأساسي.
💡 نصيحة: إضافات Claude Code و MCP هما طريقتان مختلفتان للتوسيع. الإضافات تعدّل سلوك Claude Code نفسه؛ وMCP يوسّع قدرته على الاتصال بالعالم الخارجي.
📋 المتطلبات السابقة: الفصل 13 - الوكلاء الفرعيون
1. ما ستتعلمه
- بنية نظام الإضافات
- الإضافات الرسمية والمجتمعية
- تثبيت الإضافات وإدارتها
- أساسيات تطوير الإضافات
- الفرق بين الإضافات و MCP
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 (فحص تلقائي، أوامر مخصصة). يمكن لكليهما التعايش.
س هل الكثير من الإضافات يبطئ الأداء؟
ج نعم. كل إضافة تستخدم وقت تحميل وذاكرة. ثبّت فقط ما تحتاجه.
س هل الإضافات المجتمعية آمنة؟
ج غير مضمونة. تحقّق من الكود المصدري وسمعة المؤلف قبل التثبيت.
س هل يمكن تثبيت إضافات متعددة من نفس النوع؟
ج ممكن لكن قد يحدث تعارض. إضافتا فحص قد تطبّقان قواعد مختلفة. أبقِ إضافة واحدة لكل نوع.
📖 ملخص
- الإضافات توسّع سلوك Claude Code؛ وMCP يوسّع الاتصالية
- الإضافات الرسمية: lint، test، git، doc
- الإدارة عبر
claude plugin add/remove - تطوير الإضافات: عرّف الأدوات والخطافات وفق مواصفات الواجهة
- مبدأ الحد الأدنى: ثبّت فقط الإضافات الضرورية
📝 تمارين
- أساسي (⭐): ثبّت إضافة الفحص الرسمية، وتحقق من الفحص التلقائي عند تعديل الملفات.
- متوسط (⭐⭐): ثبّت وتهيّئ إضافتين مع التأكد من عدم وجود تعارضات.
- متقدم (⭐⭐⭐): طوّر إضافة مخصصة تشغّل التنسيق والفحص تلقائياً بعد كل تعديل ملف.