إنتقل إلى المحتوى الرئيسي

CLAUDE.md وملفات الذاكرة

مبتدئ

إذا كنت ستفعل شيئًا واحدًا لتحسين Claude Code، فافعل هذا. CLAUDE.md هو ملف نصي عادي يقرؤه Claude في بداية كل جلسة — الإحاطة الدائمة لمشروعك.

What you'll learn
  • لماذا يُعد CLAUDE.md الإعداد الأعلى أثرًا في Claude Code
  • كيف يُحمَّل التسلسل الهرمي للذاكرة، من السياسة المُدارة نزولًا إلى CLAUDE.local.md
  • كيف تختلف الذاكرة التلقائية عن ملف CLAUDE.md الذي تكتبه أنت
  • كيف تولّد ملف انطلاق باستخدام /init ثم تختصره
  • ما الذي ينتمي إلى CLAUDE.md — وما الذي يجب إبقاؤه خارجه
  • كيف تتيح لك الاستيرادات @imports الإشارة إلى المستندات دون تكرارها

لماذا هو الإعداد الأعلى أثرًا​

بدونه، تشرح مشروعك من جديد في كل جلسة ("نحن نستخدم pnpm، الاختبارات في __tests__، لا تلمس /generated…"). به، يعرف Claude ذلك مسبقًا. التعليمات الجيدة هنا تحسّن كل تفاعل مستقبلي دفعةً واحدة.

التسلسل الهرمي للذاكرة​

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

  • السياسة المُدارة — تعليمات على مستوى المؤسسة يوزّعها فريق تقنية المعلومات/DevOps لديك. والمسار يختلف بحسب نظام التشغيل: /Library/Application Support/ClaudeCode/CLAUDE.md على macOS، و/etc/claude-code/CLAUDE.md على Linux وWSL، وC:\Program Files\ClaudeCode\CLAUDE.md على Windows.
  • تعليمات المستخدم (~/.claude/CLAUDE.md) — تفضيلاتك الشخصية عبر كل مشروع.
  • تعليمات المشروع (./CLAUDE.md أو ./.claude/CLAUDE.md، مُودَعة في المستودع) — كيف يعمل هذا المستودع. مشتركة مع فريقك. وإذا كان مستودعك يستخدم AGENTS.md، فقد يُحمَّل بدلًا من هذه الملفات أو إلى جانبها.
  • التعليمات المحلية (./CLAUDE.local.md) — ملاحظات خاصة بالمشروع لك وحدك، مثل عنوان URL لبيئة اختبار. أضفه إلى .gitignore.

تُحمَّل الملفات الموجودة في التسلسل الهرمي فوق دليل عملك عند الإطلاق؛ أما الملفات في المجلدات الفرعية فتُحمَّل عند الطلب، عندما يلمس Claude شيئًا في تلك المنطقة.

Pro tip
  • هل تجاوزت حدود ملف واحد؟ قسّم التعليمات إلى .claude/rules/*.md — موضوع واحد لكل ملف، ويتم اكتشافها بشكل متكرر. القواعد التي لا تحتوي على حقل paths في الواجهة الأمامية تُحمَّل عند الإطلاق بالأولوية نفسها لملف .claude/CLAUDE.md؛ أضف حقل paths إلى الواجهة الأمامية لتحميل قاعدة فقط عندما يعمل Claude على ملفات مطابقة، وهذا يوفّر السياق.
اعرف طبقات ذاكرتك
اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 6

النصف الآخر: الذاكرة التلقائية​

ملف CLAUDE.md هو نصف الذاكرة الذي تكتبه أنت. ويحتفظ Claude Code أيضًا بما يُسمى الذاكرة التلقائية — ملاحظات يكتبها Claude بنفسه انطلاقًا من تصحيحاتك وتفضيلاتك، تُخزَّن لكل مستودع وتُحمَّل في كل جلسة إلى جانب ملفات CLAUDE.md الخاصة بك.

ملفات CLAUDE.mdالذاكرة التلقائية
من يكتبهاأنتClaude
ما تحتويهتعليمات وقواعددروس مستفادة وأنماط
النطاقالمشروع أو المستخدم أو المؤسسةلكل مستودع، ومشتركة عبر أشجار العمل

وكلتاهما سياق، لا إلزام: يتعامل Claude معهما كتوجيه يمكنه الموازنة بينه وبين غيره، لا كإعداد يجب أن يطيعه. ولمنع إجراء منعًا قاطعًا بغضّ النظر عما يقرره Claude، استخدم خطّاف PreToolUse بدلًا من ذلك.

Watch out
  • لا تُحمِّل الذاكرة التلقائية سوى أول 200 سطر أو 25 كيلوبايت — فملف MEMORY.md المتضخم يُقتطع بصمت. راجع تدقيق ميزانية السياق للحصول على التفصيل الكامل لتكلفة بدء التشغيل.

ولّد نقطة انطلاق​

Guided walkthrough1 of 3
  1. يفحص Claude الشيفرة ويصوغ لك ملف CLAUDE.md تلقائيًا.

ولّد مسودة CLAUDE.md

/init

احصل على نقطة انطلاق جاهزة من قوالب CLAUDE.md.

ماذا تضع فيه​

  • ما هو المشروع، في جملتين.
  • المكدّس التقني وكيفية التشغيل / الاختبار / الفحص (lint).
  • الأعراف التي لا يستطيع Claude استنتاجها (التسمية، البنية، أسلوب الـ commit).
  • الحواجز الواقية: "شغّل الاختبارات قبل إعلان الانتهاء"، "لا تحرّر /vendor أبدًا"، "لا تودِع الأسرار أبدًا".

ماذا لا تضع فيه​

Watch out
  • يتبع Claude ملف CLAUDE.md حرفيًا — التعليمات القديمة أو الغامضة أو المتمنّاة تضرّ فعليًا.
  • صِف كيف يعمل المشروع فعليًا اليوم؛ القصير والصادق يتفوق على الطويل والطموح.
  • تجنّب المستندات الكبيرة الملصوقة (استخدم @imports بدلًا منها)، والأسرار، والقواعد التي لا تتبعها فعلًا.
  • راجعه دوريًا ليبقى دقيقًا مع تطور المشروع.

الاستيرادات​

اسحب المستندات الموجودة بدلًا من تكرارها — مثلًا أشِر إلى دليل التنسيق الخاص بك عبر استيراد @path/to/file ليكون هناك مصدر موثوق واحد. المسارات النسبية والمطلقة تعمل كلتاهما؛ وتُحَلّ المسارات النسبية بالنسبة إلى الملف الذي يحتوي على الاستيراد، لا بالنسبة إلى دليل عملك. ويمكن للملفات المستوردة أن تستورد غيرها، حتى عمق أقصاه أربع قفزات.

مأزقان في الصياغة يستحقان أن تعرفهما قبل أن يوقعا بك:

  • المسافات تحتاج إلى شرطات مائلة عكسية. @Design\ Docs/api-conventions.md يعمل؛ وبدون الشرطة المائلة العكسية يتوقف المسار عند أول مسافة. أما تغليفه بعلامات تنصيص فلا يستورد الملف على الإطلاق.
  • العلامات الخلفية تعني الانسحاب. يتخطى تحليل الاستيراد مقاطع الشيفرة والكتل المسوّرة، لذا يبقى `@README` نصًا حرفيًا، بينما يستورد @README وحده الملف. هكذا تذكر مسارًا دون تحميله.

راجع وثائق الذاكرة الرسمية للمرجع الكامل.

Pro tip
  • مصدر موثوق واحد: أشِر إلى ملف عبر @imports بدلًا من لصق محتوياته داخل CLAUDE.md.
  • إذا كان المستند موجودًا بالفعل، اربطه — لا تنسخه. النسخ تتقادم مع الوقت.

اختبر نفسك​

اختبر نفسك

0/6
  1. أي ملف يقرؤه Claude Code في بداية كل جلسة بوصفه الإحاطة الدائمة لمشروعك؟
  2. ماذا يفعل تشغيل /init في مشروع؟
  3. ما الطريقة الموصى بها لتضمين مستند كبير موجود مثل دليل التنسيق؟
  4. أين تذهب الملاحظات الشخصية الخاصة بمشروع معين — تلك التي لا تريد إيداعها في المستودع؟
  5. من يكتب الذاكرة التلقائية؟
  6. متى يُحمَّل ملف CLAUDE.md الموجود في مجلد فرعي؟
Key takeaways
  • CLAUDE.md هو الإعداد الأعلى أثرًا: يحسّن كل جلسة مستقبلية دفعةً واحدة.
  • تُحمَّل الذاكرة من الأوسع أولًا: السياسة المُدارة، ثم المستخدم (~/.claude/CLAUDE.md)، ثم المشروع (./CLAUDE.md أو ./.claude/CLAUDE.md)، ثم المحلية (./CLAUDE.local.md). وملفات المجلدات الفرعية تُحمَّل عند الطلب.
  • الذاكرة التلقائية هي النصف الآخر — ملاحظات Claude نفسه، لكل مستودع، وتُحمَّل في كل جلسة. وكلتاهما سياق لا إلزام: استخدم خطّافًا لمنع شيء منعًا قاطعًا.
  • هل تجاوزت حدود ملف واحد؟ قسّمه إلى .claude/rules/*.md وحدّد نطاق القواعد عبر حقل paths في الواجهة الأمامية.
  • ابدأ بـ /init، ثم اختصر المسودة إلى ما هو صحيح فعلًا.
  • أبقِه قصيرًا وصادقًا — استخدم @imports (بحد أقصى أربع قفزات) للمستندات الكبيرة، ولا تودِع الأسرار أبدًا.

التالي​