ضع ملفًا اسمه CLAUDE.md في مشروعك فيقرأه Claude في بداية كل محادثة — الـ stack عندك، أعرافك، الـ commands التي تُشغَّل. أسهل طريقة: في Claude Desktop، اطلب من Claude فقط أن يهيّئ واحدًا (أو شغّل /init)، ثم عدّله لاحقًا في لوحة الملفات مثل أي ملف آخر. وبشكل منفصل، يحتفظ Claude بـ memory خاصة به لأشياء يتعلمها عن طريقة عملك. واحد تكتبه أنت وتشاركه؛ والآخر يحتفظ به هو ويعيد استخدامه.
هناك طبقتان هنا، ويجدر التمييز بينهما. الـ CLAUDE.md هو
ملف تكتبه أنت وتضعه في مشروعك. يقرأه Claude في بداية كل
محادثة، فهو موضع الحقائق الثابتة للمشروع: الـ stack،
الأعراف، أي الـ commands تُشغَّل، وما الذي لا يُمَسّ أبدًا. ولأنه مُلتزَم به
في الـ repo، يشارك الجميع في الفريق الـ context نفسه. وأودّ الطرق إلى البدء بواحد
هي مباشرةً في Claude Desktop — اطلب من Claude أن «set up a CLAUDE.md for this
project» (و/init في الـ terminal يفعل الشيء نفسه)، ثم نقّحه في لوحة الملفات مثل
أي ملف نصّي آخر. دون حاجة إلى الـ terminal.
الـ memory هي النصف الآخر: ملاحظات يحتفظ بها Claude لنفسه عن طريقة عملك، تتراكم بهدوء مع الوقت. تكتب وتشارك الأول؛ ويحتفظ بالثاني ويعيد استخدامه. ومعًا يعنيان أن الـ context الذي كنت ستعيد شرحه في كل جلسة بات موجودًا فقط منذ الرسالة الأولى.
الانضباط الوحيد الذي يهمّ: أبقِ CLAUDE.md قصيرًا ومحددًا. يُقرأ في
كل محادثة على الإطلاق، فأي شيء غامض أو متضخّم تكلفة تدفعها مرارًا
وتكرارًا. ضع فيه حقائق المشروع الحقيقية، ودع الـ memory تحمل عاداتك الشخصية —
وفي اللحظة التي تضبط فيها نفسك تصحّح الأمر نفسه مرتين، دوّنه كي لا
تضطر إلى مرة ثالثة أبدًا.
مولّد
ابنِ ملف CLAUDE.md
أجب عن أسئلة قليلة وانسخ ملف ذاكرة المشروع الذي يقرأه Claude Code في كل تشغيل.
Commands
Guidelines
# CLAUDE.md
This file gives Claude Code guidance for working in this repository.
## Project
This project
## Guidelines
- Do not create a new branch unless I explicitly ask — work on the current branch by default.
- Run the test suite and make it pass before considering a task complete.
نقطة انطلاق — انسخه إلى مشروعك وعدّله حسب حاجتك.
لماذا يفيد اشرح مشروعك مرة واحدة. وكل محادثة قادمة تعرفه سلفًا.
أمثلة- أبقِ
CLAUDE.mdقصيرًا ومحددًا — يُقرأ في كل محادثة، فالتضخّم يكلّفك. - ضع حقائق المشروع في
CLAUDE.md(مشترك، مُلتزَم به)؛ ودعmemoryتحمل عاداتك الشخصية. - حين تجد نفسك تصحّح الأمر نفسه مرتين، دوّنه كي لا تفعل ذلك أبدًا مرة أخرى.
أسئلة يطرحها الناس
- ما هو ملف CLAUDE.md؟
- هو ملف تضعه في مشروعك ويقرأه Claude في بداية كل محادثة. استخدمه للحقائق الثابتة للمشروع — الـ stack عندك، أعرافك، الـ commands التي تُشغَّل، وما الذي لا يُمَسّ أبدًا — كي تتوقف عن إعادة شرحها في كل جلسة.
- ما الفرق بين CLAUDE.md والـ memory؟
- الـ `CLAUDE.md` ملف تكتبه أنت وتشاركه مع فريقك، مُلتزَم به في الـ repo. أما الـ memory فملاحظات خاصة يحتفظ بها Claude لنفسه عن طريقة عملك، تتراكم مع الوقت. واحد تؤلّفه أنت؛ والآخر يحفظه Claude.
- كيف أنشئ ملف CLAUDE.md؟
- أسهل طريقة في Claude Desktop أن تطلب في المحادثة — "set up a CLAUDE.md for this project" — أو أن تشغّل `/init`. يقرأ Claude مشروعك ويكتب لك مسودة نسخة أولى، ومن هناك تعدّلها في لوحة الملفات. دون حاجة إلى الـ terminal.
- هل يجب أن يكون الـ CLAUDE.md طويلًا؟
- لا — أبقِه قصيرًا ومحددًا. يُقرأ في كل محادثة على الإطلاق، فأي شيء غامض أو متضخّم تكلفة تدفعها مرارًا وتكرارًا. ضع فيه حقائق المشروع الحقيقية، ودع العادات الشخصية للـ memory.
- هل أحتاج إلى الـ terminal لتعديل CLAUDE.md؟
- لا. في Claude Desktop تطلب من Claude أن يكتب مسودة واحد ثم تعدّله في لوحة الملفات، مثل أي ملف نصّي آخر. أما `/init` في الـ terminal فهو مجرد طريقة إضافية لإنشائه.