يملك Claude Code طريقتين لـ “تذكّر” الأشياء عبر الـ sessions. تبدوان متشابهتين لكنهما تخدمان أغراضًا مختلفة جدًا، ومعرفة أيهما تستخدم تمنع أكثر أخطاء الإعداد شيوعًا.
الخلاصة في سطر
- CLAUDE.md ملف أنت تكتبه وتعمل له commit — حقائق المشروع، مشتركة مع الفريق.
- الـ memory ملاحظات يحتفظ بها Claude بشكل خاص — أنماط تعلّمها عن طريقة عملك.
CLAUDE.md — العقل المشترك للفريق
ملف CLAUDE.md يوجد في جذر مشروعك (أو في .claude/). يقرأه Claude في بداية كل محادثة. هنا تضع:
- الـ stack وأوامر الـ build (
npm test,cargo build) - الاصطلاحات (“فضّل plain CSS على Tailwind”، “لا تعدّل أبدًا /vendor”)
- ملاحظات عن البنية (“طبقة الـ API في src/server، والـ UI في src/components”)
# CLAUDE.md
This is a Next.js app. Run `npm test` before every commit.
Prefer plain CSS over Tailwind. Never edit files in /vendor.أنت تكتبه. أنت تعمل له commit. الفريق كله يستفيد. حين يعمل شخص جديد clone للـ repo، يعرف Claude الخاص به المشروع مسبقًا.
الـ Memory — دفتر ملاحظات Claude الخاص
الـ memory هي ما يكتبه Claude لنفسه — أشياء يلتقطها عن تفضيلاتك بمرور الوقت:
- “هذا المستخدم يفضّل الإجابات المختصرة”
- “استخدم دائمًا bun وليس npm في هذا المشروع”
- “حين يقول ‘deploy’، يقصد بيئة الـ staging”
تستطيع أن تطلب من Claude تذكّر شيء (“استخدم دائمًا single quotes”)، ويحفظه في الـ memory. لكنك تستطيع أيضًا العمل بشكل طبيعي، وسيتعلّم.
Claude يكتبها. خاصة بجهازك. لا تُعمل لها commit في أي مكان.
مقارنة جنبًا إلى جنب
| CLAUDE.md | Memory | |
|---|---|---|
| من يكتبه | أنت | Claude |
| من يقرأه | Claude (كل session) | Claude (كل session) |
| مشترك مع الفريق | نعم (commit في الـ repo) | لا (محلي على جهازك) |
| ما يحتويه | حقائق المشروع، الاصطلاحات، القواعد | التفضيلات الشخصية، الأنماط المتعلَّمة |
| أين يوجد | جذر المشروع أو .claude/ | ~/.claude/projects/<project>/memory/ |
| كيف يُحدَّث | عدّل الملف | اطلب من Claude، أو يتعلّم بمرور الوقت |
ما يذهب أين
ضعه في CLAUDE.md حين:
- يكون حقيقة عن المشروع يجب أن يعرفها أي شخص يعمل هنا
- يكون اصطلاحًا أو قاعدة يتّبعها الفريق كله
- كنت ستضعه في README لو لم يكن هناك ذكاء اصطناعي
ضعه في الـ memory حين:
- يكون شخصيًا — أسلوبك، اختصاراتك، تفضيلاتك
- يكون شيئًا لاحظه Claude وتفضّل ألا تكتبه رسميًا
- يكون خاصًا بطريقة عملك أنت، لا طريقة عمل المشروع
الخطأ الأكثر شيوعًا
يضع الناس التفضيلات الشخصية في CLAUDE.md (“أحب الإجابات القصيرة”) وحقائق المشروع في الـ memory (“استخدم npm run build”). اقلبهما. CLAUDE.md هو وثيقة الفريق؛ والـ memory هي دفتر ملاحظاتك الشخصي. حافظ عليهما نظيفين وسيعمل كلا النظامين بشكل أفضل.