ملف CLAUDE.md هو ملف Markdown بسيط يقرأه Claude Code تلقائيًا في بداية كل جلسة، ليمنح النموذج تعليمات دائمة لا يستطيع استنتاجها من شيفرتك: أوامر البناء، والأعراف، والبنية المعمارية، وقواعد "افعل X دائمًا" التي سئمت من تكرارها. ضعه في جذر مشروعك، وأبقِه دون 200 سطر تقريبًا، واملأه بتعليمات محددة وقابلة للتحقق بدلًا من إغراقه بمحتوى شبيه بويكي. يغطي هذا الدليل مكان الملف، وما ينتمي إليه، وكيفية استيراد المستندات الموجودة وإعادة استخدامها، وكيفية توليده وتشذيبه باستخدام أوامر Claude Code نفسها.
من المفيد أن نكون دقيقين منذ البداية، لأن معظم المقالات تخلط بين أمرين يفصل بينهما Claude Code: ملف CLAUDE.md الذي تكتبه أنت، والذاكرة التلقائية التي يكتبها Claude لنفسه. سنغطي كليهما، ولماذا يظل الملف الذي تكتبه بيدك أعلى عناصر الإعداد قيمةً وتأثيرًا.
ما هو ملف CLAUDE.md؟
ملف CLAUDE.md هو طبقة التعليمات الخاصة بـ Claude Code. في بداية الجلسة، يحمّله Claude Code داخل نافذة السياق ويقدّمه كرسالة يقرأها Claude قبل أن يمسّ شيفرتك. تصفه مستندات Anthropic بأنه المكان الذي "تدوّن فيه ما كنت ستضطر لشرحه مرارًا" — حزمة التقنيات، وكيفية تشغيل الاختبارات، وأعراف التسمية، والقرارات المعمارية التي يحتاجها زميل جديد في الفريق. إنه بصيغة Markdown، لذا فإن العناوين والقوائم النقطية هي كل البنية التي تحتاجها.
ثمة تفصيلة تنص عليها المستندات صراحةً: CLAUDE.md هو سياق، وليس تهيئة مُلزَمة. يقرأه Claude ويحاول اتباعه، لكن لا يوجد ضمان قاطع، خصوصًا مع القواعد الغامضة أو المتناقضة. أي شيء يجب أن يحدث عند نقطة محددة — "شغّل أداة الفحص قبل كل commit" — ينتمي إلى خُطّاف (hook)، لا إلى سطر من النثر. هذا التمييز يشكّل كل ما يأتي أدناه.
أين تضع ملف CLAUDE.md
يمكن أن يوجد CLAUDE.md في عدة أماكن، ويحمّلها Claude Code بالترتيب من الأعمّ إلى الأخصّ، مُدمجًا جميعها بدلًا من تجاوز بعضها بعضًا. فتعليمات المشروع تدخل السياق بعد التعليمات على مستوى المستخدم، لذا يُقرأ الملف الأكثر تخصيصًا في النهاية.
| النطاق | الموقع | الغرض | تتشاركه مع |
|---|---|---|---|
| سياسة مُدارة | /etc/claude-code/CLAUDE.md (Linux/WSL)؛ /Library/Application Support/ClaudeCode/CLAUDE.md (macOS)؛ C:\Program Files\ClaudeCode\CLAUDE.md (Windows) | معايير على مستوى المؤسسة ينشرها قسم تقنية المعلومات | كل من على الجهاز |
| المستخدم | ~/.claude/CLAUDE.md | تفضيلاتك الشخصية عبر جميع المشاريع | أنت وحدك |
| المشروع | ./CLAUDE.md أو ./.claude/CLAUDE.md | قواعد المشروع المشتركة بين الفريق | فريقك، عبر git |
| محلي | ./CLAUDE.local.md | ملاحظات خاصة بكل مشروع (أضِفه إلى gitignore) | أنت وحدك، في هذا المشروع |
يقرأ Claude Code ملف CLAUDE.md من مجلد عملك ومن كل مجلد أعلاه، لذا في مستودع أحادي (monorepo) ينطبق ملف الجذر وملف على مستوى الحزمة معًا. أما الملفات في المجلدات الفرعية أسفل موقعك فتُحمَّل عند الطلب فقط، حين يقرأ Claude ملفات هناك. شغّل /context داخل جلسة وتحقّق من قائمة Memory files لتأكيد ما تم تحميله فعليًا — هذه أسرع طريقة لتصحيح مشكلة "Claude يتجاهل ملف CLAUDE.md الخاص بي"، والتي تكون في الغالب ملفًا ليس في موقع يُحمَّل منه.
ماذا تضع في ملف CLAUDE.md (وماذا تحذف منه)
أفضل ملف CLAUDE.md هو قائمة قصيرة من الحقائق الملموسة القابلة للفحص. ضمّنه أوامر البناء والاختبار، وتخطيط المشروع، والأعراف التي تختلف عن إعدادات الأدوات الافتراضية، والأخطاء التي اضطررت لتصحيحها أكثر من مرة. اكتب "شغّل npm test قبل الالتزام" و"معالِجات API موجودة في src/api/handlers/"، لا "اختبر تغييراتك" أو "حافظ على تنظيم الملفات" — فالتحديد هو ما يمكن لـ Claude أن يتصرف بناءً عليه فعلًا.
وما تحذفه لا يقلّ أهمية. لا تجعل النموذج يؤدي عمل أداة الفحص؛ إن كان لديك ESLint أو Prettier، فدعهما يفرضان النمط وأبقِه خارج الملف. تجاوز أي شيء يستطيع Claude قراءته مباشرة من الشيفرة — فأشجار المجلدات، وقوائم الاعتماديات، ونظرات عامة على البنية المعمارية هي بالضبط ما سيقترح فحص /doctor في Claude Code تشذيبه. الإجراءات متعددة الخطوات الخاصة بمهمة بعينها تنتمي إلى مهارة Claude Code تُحمَّل عند الطلب، وأي شيء خاص بمسار محدد ("جميع نقاط نهاية API تحتاج إلى التحقق من المدخلات") ينتمي إلى ملف .claude/rules/ مقيَّد بنمط paths:، بحيث لا يدخل السياق إلا عندما يمسّ Claude ملفات مطابقة. قاعدة عملية جيدة: إن لم يكن المدخل مفيدًا في كل جلسة، فلا مكان له في CLAUDE.md.
أبقِه قصيرًا: CLAUDE.md ميزانية رموز، لا ويكي
لأن CLAUDE.md يُحمَّل في كل دور، فإن كل سطر يكلّف سياقًا. الهدف الذي تنص عليه Anthropic هو دون 200 سطر لكل ملف؛ فالملفات الأطول تستهلك سياقًا أكبر وتقلّل بشكل ملموس من مدى التزام Claude بها (والملف الذي يتجاوز 4 ميبي بايت يُتجاوَز بالكامل). ويذهب فريق هندسة السياق في HumanLayer إلى أبعد من ذلك، إذ يُبقي ملفه دون 60 سطرًا، ويستشهد بالسقف العملي المتمثّل في أن النماذج الرائدة لا تتبع بموثوقية سوى نحو 150–200 تعليمة — وأن موجّه النظام الخاص بـ Claude Code نفسه ينفق قرابة 50 منها قبل أن تكتب كلمة واحدة.
النموذج الذهني الذي يساعد: عامِل CLAUDE.md كذاكرة وصول عشوائي (RAM)، والمهارات والقواعد والمستندات المرجعية كقرص تخزين (disk). فأنت لا تحمّل القرص الصلب بأكمله عند الإقلاع. ضع القواعد الصحيحة دائمًا في CLAUDE.md، وأشِر إلى كل ما هو ظرفي برابط أو باستيراد. وإن أخذ الملف يتجاوز 200 سطر، فتلك إشارة إلى التقسيم، لا إلى مواصلة التمرير.
استورد ملفات أخرى وأعِد استخدام ملف AGENTS.md الخاص بك
يستطيع CLAUDE.md سحب ملفات أخرى بصيغة @path/to/file. فالاستيرادات تتوسّع داخل السياق عند الإطلاق، ويمكن أن تكون المسارات نسبية أو مطلقة، ويمكن أن تتداخل حتى أربعة مستويات عمقًا. ضع المسار بين علامتَي backtick حين تريد ذكره دون استيراده.
أكثر الحالات فائدة هي التشغيل البيني. يقرأ Claude Code ملف CLAUDE.md، وليس AGENTS.md — لذا إن كان مستودعك يستخدم أصلًا معيار AGENTS.md المشترك بين الأدوات، فلا تكرّره. أنشئ ملف CLAUDE.md يستورده، وأضِف أي ملاحظات خاصة بـ Claude أسفله:
@AGENTS.md
## Claude Code
Use plan mode for changes under `src/billing/`.
ويؤدي رابط رمزي (ln -s AGENTS.md CLAUDE.md) الغرض أيضًا إن لم تكن بحاجة إلى إضافات خاصة بـ Claude. تحذير واحد: أي استيراد يشير إلى موقع خارج مجلد عملك يُطلق نافذة موافقة لمرة واحدة، وهي حماية متعمَّدة ضد الملفات التي يلتزم بها آخرون في مستودع مشترك.
ولّده وصُنه باستخدام /init و/memory و/doctor
لست مضطرًا للبدء من ملف فارغ. شغّل /init فيحلّل Claude قاعدة الشيفرة ويكتب ملف CLAUDE.md مبدئيًا يتضمن أوامر البناء وخطوات الاختبار والأعراف التي يكتشفها؛ وإن كان هناك ملف موجود مسبقًا، فإنه يقترح تحسينات بدلًا من الكتابة فوقه. بل إنه يقرأ ملفات قواعد Cursor وCopilot الموجودة ويدمج الأجزاء ذات الصلة. عامِل الناتج كمسودة — القيمة الحقيقية في الحفنة القليلة من التعليمات التي لم يستطع Claude استنتاجها، والتي تضيفها بعد ذلك.
ومن هناك، يسرد /memory كل ملفات الذاكرة عبر النطاقات ويفتحها، ويقترح /doctor تشذيبات لملف CLAUDE.md المُلتزَم به في المستودع، فيحذف المحتوى القابل للاستنتاج مع الإبقاء على المزالق والمبررات. وحين تطلب من Claude "أضِف هذا إلى CLAUDE.md"، فإنه يحرّر الملف مباشرةً. ولأن الملف مجرد Markdown في نظام التحكم بالإصدارات، فإن التغييرات تمرّ عبر مراجعة الشيفرة كأي جزء آخر من المستودع — وهذه هي الطريقة التي يظل بها ملف CLAUDE.md الذي يقود خط النشر الخاص بنا هنا في TechRiseUps أمينًا مع مرور الوقت.
CLAUDE.md مقابل الذاكرة التلقائية
أضافت إصدارات Claude Code الأخيرة نظام ذاكرة ثانيًا تلقائيًا، ومن السهل الخلط بينه وبين CLAUDE.md. الفصل واضح: أنت تكتب CLAUDE.md (التعليمات والقواعد)؛ وClaude يكتب الذاكرة التلقائية (الأشياء التي يلاحظها عن تفضيلاتك وتصحيحاتك). تعيش الذاكرة التلقائية في ~/.claude/projects/<project>/memory/، مع فهرس MEMORY.md تُحمَّل أول 200 سطر منه (أو 25 كيلوبايت) في كل جلسة، وملفات مواضيع تُحمَّل عند الطلب.
أبقِ كلًّا منهما في مساره. CLAUDE.md هو متطلباتك؛ والذاكرة التلقائية هي ما تعلّمه Claude عن طريقة عملك. يتعمّد Claude تجاوز حفظ أي شيء ينص عليه ملف CLAUDE.md أصلًا، لذا فإن ملف CLAUDE.md المحكم يجعل الذاكرة التلقائية أنظف أيضًا. ويمكنك تصفّح أيٍّ منها أو تحريره أو حذفه عبر /memory — فكلها Markdown بسيط.
الأسئلة الشائعة
ماذا ينبغي أن أضع في ملف CLAUDE.md؟ أوامر البناء والاختبار، وبنية المشروع، والأعراف التي تختلف عن الإعدادات الافتراضية، والتصحيحات التي تجد نفسك تكرّرها. اجعل كل مدخل محددًا وقابلًا للتحقق. احذف نمط الشيفرة (استخدم أداة فحص)، والإجراءات الخاصة بمهمة بعينها (استخدم المهارات)، وأي شيء يستطيع Claude قراءته من الشيفرة.
كيف أكتب ملف CLAUDE.md المثالي؟
لا وجود لملف مثالي، لكن النمط الموثوق قصير ومحدد: دون 200 سطر، وتعليمات ملموسة، مُجمَّعة تحت عناوين Markdown، مع دفع التفاصيل الظرفية إلى الاستيرادات أو القواعد أو المهارات. ابدأ بـ /init، ثم شذّب بـ /doctor وحسّن كلما ارتكب Claude أخطاءً.
هل يستطيع Claude إنشاء ملف CLAUDE.md نيابةً عني؟
نعم. تشغيل /init يولّد ملف CLAUDE.md مبدئيًا من قاعدة شيفرتك، ويمكنك أن تطلب من Claude إضافة مدخلات أو تحريرها في أي وقت. ويبقى الملف النهائي ملكك — فاصنع بيدك القواعد التي لم يستطع اكتشافها بنفسه.
بمَ يختلف CLAUDE.md عن AGENTS.md؟
AGENTS.md معيار مفتوح مشترك بين الأدوات؛ أما CLAUDE.md فهو الملف الذي يحمّله Claude Code فعليًا. لا يقرأ Claude Code ملف AGENTS.md مباشرةً، لذا إن كنت تصون واحدًا، فاستورده إلى CLAUDE.md بـ @AGENTS.md أو اربط بين الاثنين برابط رمزي بدلًا من الاحتفاظ بملفات مكرّرة.
لماذا يتجاهل Claude ملف CLAUDE.md الخاص بي؟
عادةً لا يكون الملف في موقع يُحمَّل منه — شغّل /context وتحقّق من Memory files. وإن كان قد تم تحميله ومع ذلك ظل Claude ينحرف، فاجعل التعليمة أكثر تحديدًا، وأزِل التناقضات، وأي شيء يجب أن يُشغَّل دائمًا انقله إلى خُطّاف (hook) بدلًا من الاعتماد على النثر.
Sources
- Claude Code docs — How Claude remembers your project: المرجع الرسمي لمواقع CLAUDE.md، وترتيب التحميل، والاستيرادات، وحدود الحجم، و
/init، و/memory، والذاكرة التلقائية. - HumanLayer — Writing a good CLAUDE.md: إرشادات هندسة السياق حول الطول، والكشف التدريجي، وسقف الـ 150–200 تعليمة تقريبًا.
وقاص احمد وسیر
وقاص احمد وسیر مطوّر ومهندس أتمتة بخبرة تزيد على 8 سنوات في بناء أنظمة إنتاجية يستخدمها أكثر من 100 ألف شخص. يبني تطبيقات SaaS متعددة المستأجرين، وأتمتة بالذكاء الاصطناعي (n8n، تدفقات LLM، بوتات واتساب)، وبنية استضافة (WHM/cPanel، CloudLinux) — وهو صانع WaSphere وFlowMaticX وعلامة الاستضافة WaseerHost. أنجز أكثر من 100 مشروع لشركات صغيرة ومتوسطة ووكالات وشركات ناشئة ممولة.
