ملف CLAUDE.md: دليل قواعد الفريق وذاكرة Claude Code

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

ما هو ملف CLAUDE.md؟

CLAUDE.md ملف بصيغة Markdown يضم تعليمات يقرؤها Claude Code تخص مشروعك أو أسلوب عملك الشخصي أو مؤسستك. اعتبره المرجع الدائم للفريق، والذاكرة التلقائية دفتر ملاحظات العمل الذي يحتفظ به Claude إلى جانبه. أنت مسؤول عن المرجع، وClaude يدوّن الملاحظات. وكلاهما يدخل في السياق الذي يستند إليه عند اتخاذ القرارات. دليل الذاكرة من Anthropic

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

يتبع هذا التقسيم الدليل الرسمي لبنية المجلدات. لست بحاجة إلى مجلد .claude كبير كي تبدأ. ابدأ بالمرجع، ولا تضف ملفًا آخر إلا عندما تكون له وظيفة واضحة.

أين تضع CLAUDE.md: على مستوى المشروع أم المستخدم أم المؤسسة؟

إذا كان فريقك صغيرًا، فأضف ملفًا واحدًا للمشروع في جذر المستودع إلى نظام التحكم في الإصدارات. وضع تفضيلاتك الشخصية في ملف المستخدم الخاص بك حتى لا تنتقل إلى زملائك دون قصد.

هذه هي النطاقات والمواقع الواردة في التوثيق. لا يمكن استبعاد ملفات المؤسسة المُدارة من خلال الإعدادات الفردية، لكن النص المكتوب فيها يظل إرشاديًا.

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

نموذج CLAUDE.md للبدء مع فريق منتج صغير

دوّن القرارات التي تمنع تكرار الأخطاء. يفترض المثال التالي أن المنتج مبني باستخدام TypeScript ويدار عبر pnpm، وأن سكربتات lint وtypecheck وtest معرّفة مسبقًا. قبل حفظ الملف في نظام التحكم في الإصدارات، استبدل الأوامر والمسارات بأخرى تحققت من صحتها في مستودعك.

يتضمن كل قسم سطرًا يوضح سبب وجوده. وهذه أعراف مقترحة للفريق، وليست إعدادات Anthropic الافتراضية.

# Product Team Instructions

## Product Intent
Why: Keep implementation tied to the customer problem.
- Read the task's acceptance criteria before changing code.
- Ask when missing product behavior would change the solution.

## Working Commands
Why: Make verification repeatable across teammates and sessions.
- Use pnpm for this repository; keep pnpm-lock.yaml consistent.
- Run pnpm lint and pnpm typecheck for application changes.
- Run pnpm test for behavior changes; report any checks not run.

## Change Boundaries
Why: Keep reviews small and dependencies deliberate.
- Follow nearby patterns before adding a new abstraction.
- Ask before adding a runtime dependency or changing public APIs.
- Keep unrelated cleanup out of the change.

## Data and Migrations
Why: Make data changes reviewable and reversible where possible.
- Add schema changes through the existing migration workflow.
- Describe compatibility and rollback concerns in the handoff.
- Use synthetic data in examples and tests.

## Quality
Why: Catch user-visible regressions before review.
- Add a focused regression test when fixing a behavior bug.
- Check loading, empty and error states when changing UI flows.
- State remaining uncertainty instead of calling unchecked work done.

## Project References
Why: Point to maintained decisions without copying the whole wiki.
- Read docs/product-decisions.md when product behavior is unclear.
- Read docs/release-checklist.md before preparing a release.

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

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

افصل قواعد أنواع الملفات عن المرجع الرئيسي

انقل القاعدة إلى .claude/rules/ عندما لا تحتاج إليها معظم المهام. فتعديل الواجهة الأمامية، مثلًا، لا يستدعي تحميل كل الأعراف الخاصة بمعالجات API.

أنشئ .claude/rules/api.md وأضف ترويسة paths. تعبير glob هو نمط لمطابقة أسماء الملفات؛ فالنمط src/api/**/*.ts يحدد ملفات TypeScript داخل ذلك المجلد ومجلداته الفرعية.

---
paths:
  - "src/api/**/*.ts"
---

# API Rules
- Validate external input before passing it to application logic.
- Use the existing error response format.
- Add a focused test when changing an endpoint's behavior.

يحدد النمط متى تدخل هذه التعليمات في السياق. وفي غياب paths، تُحمّل القاعدة دون شرط عند بدء التشغيل. مجرد تقسيم مرجع طويل إلى عدة ملفات قواعد لن يقلل حجم السياق، ما لم تحدد نطاق تحميلها. قواعد مرتبطة بمسارات محددة

استخدم الاستيراد لمشاركة النص مع إدراك أثره في حجم السياق

إضافة استيراد مثل @docs/team-conventions.md داخل CLAUDE.md تُدخل محتوى ذلك الملف في السياق عند بدء التشغيل. وتُفسّر المسارات النسبية انطلاقًا من الملف الذي يحتوي على الاستيراد. ضع تعليمة الاستيراد الفعلية خارج علامات التنصيص الخلفية ومقاطع الشيفرة في Markdown؛ فداخلها تُعامل كنص حرفي. ويُطلب الإذن عند استيراد ملفات للمشروع من خارج مجلد العمل. صيغة الاستيراد

يمكنك استيراد نص قصير لأعراف يصونها فريق آخر بالفعل، إذا كانت مطلوبة في كل جلسة. أما قائمة التحقق الطويلة للإصدارات، فالأفضل الإشارة إليها بإحالة عادية كما يفعل النموذج السابق. الاستيراد يعيد تنظيم المرجع، لكنه لا يقلل مقدار ما يقرؤه Claude عند بدء التشغيل.

هل تستخدم AGENTS.md بالفعل؟ اجعل للتعليمات مصدرًا واحدًا

يمكن لـClaude Code استخدام AGENTS.md مباشرة بدلًا من CLAUDE.md، بدءًا من الإصدار 2.1.277 عندما يكون هذا الدعم متاحًا. لكن السلوك الافتراضي مشروط بأمر مهم: ألا يوجد أي ملف CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في مجلد العمل أو المجلدات الأعلى منه. ولا تمنع ملفات تعليمات المستخدم والمؤسسة هذا التحميل البديل. تحميل AGENTS.md

لهذا قد يسبب CLAUDE.local.md التباسًا بسهولة. فإضافة ملاحظاتك الشخصية للمشروع قد تغيّر ملف التعليمات المشترك الذي يُحمّل لك.

إذا كنت تحتاج إلى الملفين معًا، فافتح /config واضبط Project instructions على claude-md-and-agents-md. أو ضع @AGENTS.md داخل ملف CLAUDE.md مجاور؛ فهذا الاستيراد يعمل أيضًا عندما لا يتوفر الدعم المباشر لملف AGENTS.md. تجنب صيانة نسختين من قواعد الفريق. يشرح دليل إعداد AGENTS.md هذا الاختيار بمزيد من التفصيل.

ذاكرة Claude Code: اترك الملاحظات المكتسبة للذاكرة التلقائية

تتيح الذاكرة التلقائية لـClaude حفظ التفضيلات والتصحيحات وسياق المشروع المفيد بين المحادثات. وهو يقرر ما يستحق الاحتفاظ به، وقد لا يحفظ شيئًا خلال جلسة معينة. وتكون هذه الميزة مفعّلة افتراضيًا في الجلسات المحلية. الذاكرة التلقائية

تُحفظ الملفات افتراضيًا في ~/.claude/projects/<project>/memory/. وداخل المستودع نفسه، تتشارك أشجار العمل والمجلدات الفرعية مجلد الذاكرة هذا على جهازك. وشجرة العمل نسخة عمل أخرى من المستودع؛ لذا فإن بدء العمل على فرع فيها لا يمنحك دفتر ملاحظات مستقلًا. ولا تُشارك هذه الملفات تلقائيًا مع الزملاء أو الأجهزة الأخرى أو البيئات السحابية. موقع التخزين

يؤدي MEMORY.md دور الفهرس. وعند بدء الجلسة، يحمّل Claude أول 200 سطر أو 25KB منه، أي الحدين يأتي أولًا. أما الملفات المفصلة لكل موضوع فتُقرأ عند الحاجة. يصف هذا الحد مقدار ما يُحمّل من الفهرس عند بدء التشغيل، ولا يحدد إجمالي الذاكرة التي يمكنك تخزينها. كيف تُحمّل الذاكرة التلقائية

اجعل /memory نقطة البداية: فهو يعرض مواقع الذاكرة، ويفتح الملفات في محررك، ويتيح الوصول إلى مجلد الذاكرة التلقائية وتفعيلها أو تعطيلها. واستخدم /context عندما تريد التحقق من ملفات CLAUDE.md والقواعد التي حُمّلت عند بدء التشغيل. أدوات التحكم في الذاكرة

حدد الوجهة بوضوح. فقولك «تذكّر أنني أفضل تقارير تسليم أقصر» هو طلب لحفظ ملاحظة مكتسبة. أما «أضف أمر الاختبار الإلزامي للفريق إلى CLAUDE.md» فهو طلب لإضافة تعليمة تخضع للصيانة. لا ينبغي أن تعتمد قاعدة يحتاج إليها الفريق كله على ملاحظة محفوظة في المجلد الشخصي لمطور واحد.

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

كيف تعطّل الذاكرة التلقائية؟

اختر وسيلة التحكم التي تناسب ما تريد فعله:

• على مستوى إعدادات المستخدم: افتح /memory وعطّل الذاكرة التلقائية. يحفظ هذا الخيار قيمة autoMemoryEnabled في ~/.claude/settings.json.
• لمشروع واحد: عيّن "autoMemoryEnabled": false في إعداداته. استخدم .claude/settings.json لإعداد مشترك للمشروع، أو .claude/settings.local.json لتجاوز الإعداد محليًا على جهازك.
• عند التحكم في التشغيل بمتغيرات البيئة: عيّن CLAUDE_CODE_DISABLE_AUTO_MEMORY=1.

هذه هي وسائل التعطيل ومواقع الإعدادات الواردة في التوثيق. يظل نظام تعليمات CLAUDE.md المستقل متاحًا بعد تعطيل الذاكرة التلقائية. وإذا أردت إزالة الملاحظات القديمة أيضًا، فافحص ملفات Markdown المعنية واحذفها بنفسك.

مراجعة شهرية لتنظيف الذاكرة التلقائية

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

1. افتح /memory وتصفح مجلد الذاكرة التلقائية. اقرأ MEMORY.md، ثم اتبع إحالاته إلى الملاحظات نفسها.
2. احذف السياق الذي انتهت صلاحيته. أزل المواعيد التي انقضت والخطط المتروكة والاستثناءات التي لم تعد سارية. وتحقق من الملاحظات غير المؤكدة بالرجوع إلى وضع المشروع الحالي.
3. ادمج التصحيحات المتكررة. احتفظ بصياغة واحدة دقيقة بدلًا من عدة صيغ تختلف قليلًا فيما بينها.
4. انقل قرارات الفريق الدائمة إلى مرجعها المناسب. ضع العرف الذي يحتاج إليه الجميع في CLAUDE.md المحفوظ في نظام التحكم في الإصدارات، أو في قاعدة محددة النطاق، ثم احذف الملاحظة الشخصية المكررة.
5. اختصر الفهرس. احتفظ بإشارات موجزة في MEMORY.md وضع التفاصيل في ملفات الموضوعات. قارن عدد أسطره وحجمه بالبايت بحد التحميل عند بدء التشغيل.
6. جرّب جلسة جديدة. تحقق من قائمة التعليمات باستخدام /context، وراقب المهمة الفعلية التالية لرصد أي توجيهات قديمة.

ملفات الذاكرة التلقائية ملفات Markdown قابلة للتحرير، وسياسة الاحتفاظ بسجل المحادثات لا تنظفها تلقائيًا. لا بد من أن يتولى أحد حذف الملاحظات التي لم تعد صالحة. التحرير والاحتفاظ بالبيانات

خمس حالات تستفيد فيها من هذا الإعداد

ابدأ بالمواضع التي تؤخر فيها التصحيحات المتكررة المراجعات بالفعل. هذه مسارات عمل مقترحة، مرتبة بحسب فائدتها المرجحة لفريق منتج صغير.

فكرتان لمشروعات صغيرة تستندان إلى هذا الإعداد

الفرصة الأقوى هي خدمة تدقيق تعليمات المستودع. قد يدفع فريق صغير مقابل مراجعة تتحقق من الأوامر، وتكتشف التوجيهات المتعارضة، وتقترح مرجعًا موجزًا مع قواعد محددة النطاق. وأصغر مخرج مفيد لهذه الخدمة هو طلب دمج خضع للمراجعة وقائمة تحقق قابلة لإعادة الاستخدام في التدقيق. يقدّر DataForSEO عدد عمليات البحث الشهرية في الولايات المتحدة عن عبارة «claude project instructions» بنحو 260 عملية. وهذا الاستعلام العام يشمل اهتمامًا يتجاوز Claude Code؛ فهو مؤشر يساعد على اكتشاف الفرص، وليس عددًا للمشترين. يسهل نسخ القوالب العامة، لذلك لا بد أن تأتي قيمة الخدمة المدفوعة من تقييم يراعي خصوصية المستودع.

قد يفيد تقرير محلي لتنظيم الذاكرة الفرق التي تعمل على مستودعات نشطة كثيرة. يمكن أن ترصد نسخته الأولى الفهارس المتضخمة، والإحالات إلى موضوعات غير موجودة، والملاحظات المحتمل تقادمها، ثم تترك للمطور مراجعة التعديلات. يقدّر DataForSEO عدد عمليات البحث الشهرية في الولايات المتحدة عن عبارة «claude code memory» بنحو 1,300 عملية. هذا يدل على الاهتمام بالمشكلة، ولا يثبت وجود طلب على هذه الأداة بعينها. والتحدي كبير: عمر الملف وحده لا يكشف ما إذا كان القرار قد فقد صلاحيته. اترك الحكم على مضمون الملاحظات لمن يعرف المشروع.

كلا التقديرين مأخوذ من نتائج نظرة عامة على الكلمات المفتاحية باللغة الإنجليزية في الولايات المتحدة، جرى استرجاعها في 11 أكتوبر 2026 عبر تكامل الموقع البحثي مع DataForSEO. وهذه منتجات مقترحة، وليست ميزات مدمجة في Claude Code. إذا كان لديك مستودع صغير واحد، فابدأ بالملف والمراجعة الشهرية قبل شراء أي من الفكرتين أو بنائها.

الذاكرة سياق يساعد على القرار، وليست آلية لفرضه

كتابة «لا تفعل هذا أبدًا» في CLAUDE.md لا تجعل تنفيذ الإجراء مستحيلًا. وينطبق الأمر نفسه على الذاكرة التلقائية والنصوص الموجهة للمؤسسة كلها. فقد يسيء Claude فهم تعليمة مبهمة، أو يجد توجيهات متعارضة. تنبيه Anthropic

استخدم خطاف PreToolUse، وهو ضابط يُنفّذ قبل إجراء الأداة، عندما تحتاج إلى منع ذلك الإجراء بصرف النظر عن قرار Claude. يمكن للتذكير بالملفات المحمية أن يوضح مقصد الفريق، لكن المنع الفعلي يحتاج إلى ضابط مُنفّذ. يشرح دليل إعداد خطافات Claude Code كيفية إعداد الخطاف.

ولضبط حجم السياق، استهدف مرجعًا يستطيع أحد صيانته فعلًا. توصي Anthropic بأن يقل طول كل ملف CLAUDE.md عن 200 سطر، لكن هذه التوصية مستقلة عن حد تحميل MEMORY.md عند بدء التشغيل. لا تضف حشوًا إلى نموذجك الأولي لتبلغ عددًا مفترضًا، ولا تنقل كل شيء إلى ملفات مستوردة وتفترض أن تكلفة التحميل قد انخفضت. كتابة تعليمات فعالة

أسئلة يطرحها فريق صغير في العمل اليومي

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

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