التعديلات (Mods) في Claude Code: دليل عملي لتخصيص Claude Code من الداخل

في 1 أكتوبر 2026 أعلنت Anthropic عن التعديلات (Mods) في Claude Code، وهي دوال صغيرة بلغة JavaScript أو TypeScript تغيّر طريقة عمل Claude Code وما يعرضه على الشاشة. يستطيع التعديل أن يعيد صياغة الطلب قبل وصوله إلى النموذج، أو يوقف أمرًا خطرًا، أو يرسم لوحة بجانب المحادثة، أو يستبدل ميزة مدمجة. وتُوزَّع التعديلات داخل الإضافات (Plugins)، وتعمل في واجهة سطر الأوامر وفي تبويب Code داخل تطبيق Claude لسطح المكتب.

إذن هي ميزة رسمية وليست حيلة من المجتمع. لكن كثيرًا من التعديلات التي تظهر في الفيديوهات، مثل Cache Keeper وCollision Guard، ليست جزءًا من Claude Code نفسه. بعضها أمثلة تشاركها Anthropic، ومعظمها بناه مطورون وصنّاع محتوى في الأيام الأولى بعد الإطلاق. يفصل هذا الدليل بين الاثنين، ويصحح بعض الأرقام الشائعة عن التخزين المؤقت والتكلفة، ويشرح كيف تتعامل مع التعديلات بأمان.

ما هو التعديل؟ الصورة في رسم واحد

في كل مرة يفعل فيها Claude Code شيئًا، يُطلق حدثًا: Claude على وشك استدعاء أداة، أو أرسلتَ طلبًا، أو انتهت جولة، أو يُرسم جزء من الشاشة. والتعديل مجموعة دوال يستدعيها Claude Code عند هذه الأحداث. وبحسب الصفحة الرسمية للتعديلات، تستطيع كل دالة أن تفعل واحدًا من ثلاثة أشياء:

• المراقبة: ترى الحدث وتتركه يكمل كما هو، مثل عدّ استدعاءات الأدوات.
• إعادة الصياغة: تغيّر الحدث قبل أن يكمل، مثل إضافة نص إلى مؤشر الانتظار أو تعديل أمر.
• الرد بنفسها: تتولى الحدث فلا يعمل السلوك المعتاد لـ Claude Code، مثل رفض أمر ما.

وعندما تتعامل عدة تعديلات مع الحدث نفسه، فإنها تعمل بترتيب تحميلها، مثل طبقات متتالية. كل تعديل يمرر الحدث إلى التالي عبر next(e)، ويأتي السلوك الأصلي لـ Claude Code في نهاية السلسلة.

وأصبحت بعض ميزات Claude Code نفسها تعديلات أيضًا. فلوحة الأمر /diff مثلًا تعديل مدمج يمكنك إيقافه من /plugin أو استبداله بنسختك. وتنشر Anthropic الشيفرة المصدرية لعدد من التعديلات المدمجة في مستودع claude-code.

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

أمر أم مهارة أم خطاف أم تعديل: ماذا تحتاج؟

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

والقاعدة المفيدة هنا: استخدم أخف أداة تؤدي المهمة. إن كنت تكرر لصق التعليمات نفسها فاكتب مهارة. وإن كانت لديك قاعدة يجب أن تُطبَّق دائمًا، مثل منع رفع مفاتيح API إلى المستودع، فخطاف الإعدادات يكفي. ولا تلجأ إلى التعديل إلا عندما تحتاج شيئًا لا تقدر عليه الأدوات الأخرى: لوحة حية، أو سؤال بأزرار من تصميمك، أو ذاكرة بين الأحداث، أو تغيير ما يرسمه Claude Code.

من يحصل على التعديل؟ نطاقات التثبيت

يُثبَّت التعديل مثل أي إضافة، فيستخدم نطاقات التثبيت نفسها. هناك ثلاثة نطاقات تختارها بنفسك، ونطاق رابع تتحكم فيه مؤسستك:

• نطاق المستخدم (user): تعمل الإضافة لك في كل المشاريع على هذا الجهاز، وتُسجَّل في ~/.claude/settings.json.
• نطاق المشروع (project): تعمل الإضافة لكل من يعمل على المستودع، وتُسجَّل في .claude/settings.json الذي يُرفع مع المشروع. لكن كل زميل يحتاج إلى تثبيتها على جهازه.
• النطاق المحلي (local): تعمل الإضافة لك أنت في هذا المستودع فقط، عبر .claude/settings.local.json.
• النطاق المُدار (managed): في خطط Team وEnterprise، أو على الأجهزة ذات الإعدادات المُدارة، يستطيع المسؤولون تثبيت إضافات مسبقًا، والسماح بمتاجر إضافات أو حظرها، ومنع التعديلات التي يثبّتها المستخدمون.

لا يوجد نطاق مستقل باسم "الفريق". المشاركة مع الفريق تكون عبر نطاق المشروع، أما قواعد الشركة كلها فتأتي عبر الإعدادات المُدارة. وعلى هذه الأجهزة، وفي خطط Team وEnterprise، يُحمَّل أولًا تعديل مدمج اسمه sec-default يمنع التعديلات التي يثبّتها المستخدمون من القيام بأشياء خطرة، مثل تجاوز قواعد المنع في صلاحياتك.

أمثلة على التعديلات مقسمة حسب المهمة

التعديلات التالية هي الأكثر انتشارًا في الأسبوع الأول، وهي أمثلة على ما بناه الناس، وليست قائمة بميزات Claude Code. وتأتي من ثلاثة مصادر: ثلاثة أمثلة تشاركها Anthropic في مستودع claude-code-playground وهي Token Weather وBlast Radius وReplay Theater، وأربعة تعديلات عرضها صانع المحتوى Nate Herk في فيديو ونشرها على GitHub برخصة MIT، ومجموعة من عشرة تعديلات بناها Mark Kashef في فيديو آخر. وتختلف الأسماء والأوامر والسلوك من مطور لآخر، فاقرأ ملف README لكل مشروع قبل أن تعتمد على التفاصيل.

السياق والتكلفة

يرسم Token Weather، وهو أحد أمثلة Anthropic، سطرًا واحدًا فوق خانة الكتابة يشبه نشرة الطقس: نسبة امتلاء نافذة السياق، مع رسم صغير للجولات الأخيرة. ويعرض Cache Keeper المدة الباقية قبل أن يبرد التخزين المؤقت، وتكلفة الرسالة التالية إذا انتهت صلاحيته، ويقترح نقل العمل إلى محادثة جديدة. أما Auto Handoff فيراقب استهلاك السياق، وعند حد تختاره (85% في عرض Kashef) يكتب ملخصًا ويكمل في جلسة جديدة.

المحادثات المتوازية والنماذج

يسألك Collision Guard قبل أن يحرر Claude ملفًا غيّرته محادثة أخرى مفتوحة خلال آخر 30 دقيقة. ويرسل موجّه النماذج (Model Router) أعمال الاستكشاف إلى وكلاء فرعيين على نموذج أرخص، بينما يخطط النموذج الرئيسي ويلخص. ويسجل مسجّل الرحلة (Flight Recorder) كل جولة: أي نموذج أجاب، وأي أدوات عملت، وأي ملفات قُرئت أو كُتبت، وكم استغرقت كل خطوة.

متابعة العمل

يحوّل مقياس الأهداف أمر /goal المدمج في Claude Code إلى عرض للتقدم فيه مراحل وقائمة مهام ونسبة إنجاز. وهناك تعديلات أخرى تحتفظ بصينية للملفات التي أُنشئت في الجلسة، أو إيصال قصير بالملفات المتغيرة، أو علامات مرجعية مع ملخص من سطر واحد عند اللحظات المهمة. ويضيف Replay Theater، وهو مثال آخر من Anthropic، أمر /replay الذي يعرض التغييرات التي أجراها Claude في الجولة الأخيرة خطوة بخطوة. كما عرض Thariq Shihipar من فريق Claude Code تعديلًا يقترح الخطوات التالية في صورة أزرار في نهاية كل جولة.

الأمان والخصوصية

يوقف Blast Radius، وهو مثال Anthropic الثالث، أي أمر خطر مثل rm -rf أو الدفع القسري (force push)، ويعرض ما سيغيّره، وينتظر أن تختار المتابعة أو الإلغاء. ويخفي Recording Mode مفاتيح API وعناوين البريد والمبالغ المالية على الشاشة أثناء تسجيل فيديو. ويبقى Claude يعمل بالقيم الحقيقية، والذي يتغير هو العرض فقط.

الشكل والتسلية

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

التخزين المؤقت للطلبات: ماذا يعني العدّاد فعلًا؟

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

• للتخزين المؤقت مدة صلاحية (TTL)، وكل طلب يستفيد منه يعيد ضبط المؤقت من جديد.
• يستخدم Claude Code مدة ساعة للمحادثة الرئيسية فقط مع اشتراك Claude وضمن الاستخدام المشمول في خطتك. أما مع مفتاح API أو مزود سحابي أو رصيد استخدام مدفوع، فالمدة الافتراضية خمس دقائق. ويمكنك اختيار أي منهما عبر الإعداد promptCacheTtl.
• للوكلاء الفرعيين تخزين مؤقت خاص بهم، ومدته الافتراضية خمس دقائق حتى مع الاشتراك.
• القراءة من التخزين المؤقت تكلف 0.1 من سعر الإدخال العادي في معظم النماذج، وهذا هو "خصم 90%" الذي تسمع عنه. وهي أقل في بعض النماذج الحالية: 0.05 في Claude Opus 5.5.
• الكتابة في التخزين المؤقت تكلف أكثر من الإدخال العادي: 1.25 ضعف لمدة الخمس دقائق، وضعفين لمدة الساعة.

مثال محسوب بأسعار الواجهة البرمجية: محادثة حجمها 400 ألف رمز على Claude Opus 5.5 (4 دولارات لكل مليون رمز إدخال) تكلف نحو 0.08 دولار لقراءتها من تخزين مؤقت ساخن. وإذا انتهت الصلاحية، تكتب الرسالة التالية المحادثة كلها من جديد، بنحو 3.20 دولار مع مدة الساعة. ومع الاشتراك لا تدفع ثمن كل رمز، لكن العمل نفسه يُحسب من حدود استخدامك.

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

أما حجم السياق فمسألة منفصلة. تعمل النماذج الحالية Claude Opus 5.5 وSonnet 5.5 وFable 5.1 بنافذة سياق قدرها مليون رمز في Claude Code عبر واجهة Anthropic البرمجية، بينما نافذة Claude Haiku 4.5 هي 200 ألف رمز. والسياق الطويل جدًا قد يجعل الإجابات أقل تركيزًا، لكن لا يوجد رقم رسمي يبدأ عنده ذلك، فتعامل مع عبارات مثل "الجودة تنخفض بعد 400 ألف رمز" على أنها تقديرات. ويبقى الأمران /compact و/clear في Claude Code الأداتين الأساسيتين هنا.

مساران يستحقان الفهم

يُعد Collision Guard مثالًا جيدًا على تعديل يفعل شيئًا لا يتقنه خطاف الإعدادات. فبحسب ملف README الخاص به، تحتفظ كل محادثة مفتوحة بسجل صغير للملفات التي غيّرتها. وقبل أي استدعاء لأدوات Edit أو Write أو NotebookEdit، يفحص التعديل سجلات المحادثات الأخرى. فإذا غيّرت محادثة أخرى الملف نفسه خلال آخر 30 دقيقة، يسألك: المتابعة، أو نقل العمل إلى git worktree، أو الإلغاء. وإذا كتبت ردك الخاص بدلًا من ذلك، يتلقاه Claude على أنه التعليمة.

لكن انتبه إلى حدوده: فهو لا يرى إلا التحرير الذي يتم عبر هذه الأدوات الثلاث، فالملف الذي يغيّره أمر Bash أو محررك الخاص لا يُسجَّل. كما أنه لا يرى إلا المحادثات على الجهاز نفسه.

والنمط الثاني هو توجيه النماذج. يمكنك تنفيذ جزء منه أصلًا بلا تعديل: فـالوكيل الفرعي يمكن أن يحدد model: haiku، ويمكنك تعريف وكيل Explore خاص بك يستخدمه. أما التعديل فيذهب أبعد، فيقرر أثناء العمل أي نموذج يتولى أي طلب، أو يعرض المبلغ الذي وفّرته.

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

بناء التعديل وتثبيته وإزالته

أسهل طريقة لبناء تعديل أن تطلبه من Claude. صف ما تريده في جلسة Claude Code، مثلًا: "اصنع تعديلًا يسألني قبل تحرير أي ملف تغيّر خلال آخر 30 دقيقة". وكما يشرح دليل إنشاء التعديلات، يستخدم Claude مهارة مدمجة اسمها plugin-authoring، ويكتب التعديل في مجلد داخل ~/.claude/dev-mods/، ثم يسألك هل تريد تفعيل إعادة التحميل الفوري لهذه الجلسة. وبعد موافقتك يعمل التعديل من الجولة التالية.

وقبل أن تثبّت تعديلًا من شخص آخر، اعرض ما يفعله دون تشغيله:

claude plugin validate ./some-mod

يُظهر السطران hooks: وcalls: الأحداث التي يتعامل معها التعديل وما يطلبه من Claude Code، مثل قراءة الملفات أو إرسال طلبات عبر الشبكة. ولتثبيت تعديل، اكتب اسم الإضافة ثم اسم متجرها:

# داخل جلسة Claude Code
/plugin install token-weather@claude-code-playground-mods

# أو من الطرفية مع اختيار النطاق
claude plugin install token-weather@claude-code-playground-mods --scope project

اسم المتجر في هذين المثالين خاص بمجلد أمثلة Anthropic بعد إضافة نسخة محلية منه كمتجر، وكل تعديل آخر له اسم متجره. وإذا ثبّتّ من الطرفية بينما الجلسة مفتوحة، فشغّل /reload-plugins داخلها. ولتجربة تعديل لجلسة واحدة دون تثبيته، شغّل Claude Code بالأمر claude --plugin-dir ./path-to-mod.

ولإزالة التعديلات لا تحتاج إلى حذف المجلدات يدويًا. أزل الإضافة من /plugin أو بالأمر claude plugin uninstall <name>@<marketplace>. ولتشغيل جلسة واحدة بلا أي من تعديلاتك، شغّل Claude Code مع --safe-mode. ولإيقاف كل التعديلات التي ثبّتّها، اضبط "disableAllHooks": true في ~/.claude/settings.json، مع الانتباه إلى أن هذا يوقف أيضًا خطافات الإعدادات وسطر الحالة المخصص.

قواعد عملية للتعايش مع التعديلات

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

الخلاصة

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