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

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

مبتدئ

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

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

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

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

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

يقرأ Claude Code الذاكرة من عدة أماكن ويدمجها، بترتيب يتدرج تقريبًا من الأكثر عمومية إلى الأكثر تحديدًا:

  • ذاكرة المستخدم — تفضيلاتك الشخصية عبر كل مشروع.
  • ذاكرة المشروع (./CLAUDE.md، مُودَع في المستودع) — كيف يعمل هذا المستودع. مشتركة مع فريقك.
  • المتداخلة — ضع ملف CLAUDE.md في مجلد فرعي لقواعد تنطبق هناك فقط.
اعرف طبقات ذاكرتك
اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 4

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

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 ليكون هناك مصدر موثوق واحد. راجع وثائق الذاكرة الرسمية للصياغة المحددة.

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

اختبر نفسك​

اختبر نفسك

0/3
  1. أي ملف يقرؤه Claude Code في بداية كل جلسة بوصفه الإحاطة الدائمة لمشروعك؟
  2. ماذا يفعل تشغيل /init في مشروع؟
  3. ما الطريقة الموصى بها لتضمين مستند كبير موجود مثل دليل التنسيق؟
Key takeaways
  • CLAUDE.md هو الإعداد الأعلى أثرًا: يحسّن كل جلسة مستقبلية دفعةً واحدة.
  • تُدمج الذاكرة من العام إلى الخاص: سياسة المؤسسة، ثم ملفات CLAUDE.md للمستخدم والمشروع والمتداخلة.
  • ابدأ بـ /init، ثم اختصر المسودة إلى ما هو صحيح فعلًا.
  • ضمّن ملخص المشروع، وأوامر التشغيل/الاختبار/الفحص، والأعراف، والحواجز الواقية.
  • أبقِه قصيرًا وصادقًا — استخدم @imports للمستندات الكبيرة، ولا تودِع الأسرار أبدًا.

التالي​