> https://learn.abdulosama.com/qamoos/claude-md

![رسم توضيحي يشرح CLAUDE.md (ملف CLAUDE.md): ملف نصي في المشروع يقرؤه الوكيل أولًا ليعرف قواعد المكان قبل أن يعمل.](https://learn.abdulosama.com/images/guide/claude-md.webp)

# CLAUDE.mdملف CLAUDE.md

## ما هو CLAUDE.md؟

ملف نصي في المشروع يقرؤه الوكيل أولًا ليعرف قواعد المكان قبل أن يعمل.

## ما معنى CLAUDE.md بالعربي؟

الاسم المعتمد الآن هو «**ملف CLAUDE.md** ». ولأن كثيرًا من المصطلحات لم يستقرّ لها اسم عربي واحد، يكتب هذا القاموس قرّاؤه: صوّت للاسم الذي تراه أوضح، أو اقترح اسمًا أفضل. نراجع الأصوات في كل جولة ونعتمد ما يختاره الناس.

1. ملف CLAUDE.md الاسم المعتمد اسم القاموس
2. ملف تعليمات كلود وصف عربي لوظيفة الملف
3. ملف كلود دوت إم دي نطق اسم الملف بين المستخدمين

صوت واحد لكل قارئ في كل مصطلح، وتستطيع نقله إلى اسم آخر. حين يتجاوز اسمٌ الاسمَ المعتمد ويصل إلى 5 أصوات على الأقل، نعرضه للاعتماد في الجولة التالية.

اقترح اسمًا عربيًا أفضل هل الشرح غير واضح أو فيه خطأ؟

تخيّل ورقة معلّقة على باب مكتب: «هنا نحفظ العقود في الخزانة الزرقاء. الاجتماعات يوم الأحد. لا تُرسل أي عرض سعر قبل أن يراجعه المدير. ورقم الصيانة في الدرج الأول». أي شخص يدخل لأول مرة يقرأ الورقة قبل أن يلمس شيئًا، فيعمل كما يعمل أهل المكان لا كما يخمّن.

CLAUDE.md هو هذه الورقة لمشروع برمجي. ملف نصي بسيط مكتوب بتنسيق [Markdown](https://learn.abdulosama.com/qamoos/markdown)، يوضع في مجلد المشروع، ويقرؤه الوكيل البرمجي Claude Code تلقائيًا في بداية كل جلسة قبل أن يفعل أي شيء. فيه ما يحتاج أي قادم جديد إلى معرفته: ما هذا المشروع، وأين توجد الأجزاء المهمة، وكيف يُشغَّل ويُختبر، وما الأخطاء التي وقع فيها الفريق من قبل فلا تتكرر.

وهو يأتي غالبًا في طبقتين:

- ملف عام في مجلد إعداداتك الشخصي، فيه ما يصح في كل مشروع: «اشرح بلغة بسيطة، فأنا لست مبرمجًا»، «اسألني إذا كان الطلب غامضًا».
- ملف خاص بالمشروع داخل مجلده، يشاركه كل من يعمل عليه، فيه قواعد هذا المشروع وحده.

يقرأ الوكيل الاثنين معًا، وعند التعارض تغلب عادة القاعدة الأكثر تحديدًا، أي قاعدة المشروع. والأدوات الأخرى لها ملفات بالفكرة نفسها وأسماء مختلفة، مثل AGENTS.md.

الفائدة تظهر في الجلسة الثانية والعاشرة. بدون هذا الملف، تبدأ كل جلسة بشرح طويل للمشروع من جديد، أو يكتشف الوكيل الأمور بالتجربة والخطأ. ومعه، يدخل الوكيل وقد قرأ القواعد. وكل مرة تصحّح فيها خطأً مهمًا، تضيف سطرًا إلى الملف فلا يتكرر الخطأ مع أي جلسة لاحقة.

ولأن الملف يُقرأ كاملًا في كل مرة، فطوله يستهلك جزءًا من [نافذة السياق](https://learn.abdulosama.com/qamoos/context-window). الملف الجيد مختصر، يذكر ما يهم ويشير إلى مكان التفاصيل بدل أن ينسخها كلها.

## لماذا يهمك CLAUDE.md؟

إذا كنت تبني موقعك أو أداتك بمساعدة وكيل، فهذا الملف هو ذاكرة المشروع التي لا تضيع بين جلسة وأخرى، ويمكنك أن تكتبه وتعدّله بنفسك. وإذا انتقل المشروع إلى مطوّر جديد، وجد فيه الخلاصة جاهزة.

## متى ستسمع كلمة CLAUDE.md؟

يقول لك المطوّر: «الوكيل كرر الخطأ نفسه، سأضيف القاعدة إلى CLAUDE.md حتى لا يعود إليه».

## كلمات قريبة

- [System Prompt · موجّه النظام](https://learn.abdulosama.com/qamoos/system-prompt)
- [Markdown · تنسيق Markdown](https://learn.abdulosama.com/qamoos/markdown)
- [Session · الجلسة](https://learn.abdulosama.com/qamoos/session)
- [Progressive Disclosure · الإفصاح التدريجي](https://learn.abdulosama.com/qamoos/progressive-disclosure)

## حمّل القاموس كاملًا بصيغة PDF

قاموس التقنية بالعربي: 101 مصطلحًا في كتاب واحد مصوّر، تقرؤه على هاتفك أو تطبعه. اكتب اسمك ورقم واتساب، وتنضمّ إلى قائمة عبدول على واتساب، ويظهر لك رابط التحميل فورًا.

**تمّ.** انضممت إلى القائمة، وهذا رابط القاموس. يعمل الرابط سبعة أيام، فاحفظ الملف على جهازك.

تحميل القاموس (PDF)

لن نشارك رقمك مع أحد. يمكنك الخروج من القائمة في أي وقت.

## تريد إضافته إلى موقعك؟

أداة مجانية لموقعك أو مدونتك: يظهر خط منقّط تحت مصطلحات القاموس في مقالاتك، ومن يمرّ عليها يرى اسمها العربي ومعناها، ورابطًا للشرح الكامل في صفحة جديدة. لا تجمع أي بيانات عن زوّارك.

1. **الصق هذا السطر** قبل نهاية صفحات موقعك (قبل `</body>`):
`<script src="https://learn.abdulosama.com/qamoos/embed.js" defer></script>`
2. **أو اطلب ذلك من وكيل الذكاء الاصطناعي** الذي يبني موقعك (Claude Code أو Cursor أو غيرهما): انسخ هذه الجملة وأرسلها له.
`أضف أداة «قاموس التقنية بالعربي» إلى موقعي، واتبع التعليمات هنا: https://learn.abdulosama.com/qamoos/install.md`
3. **دليل التثبيت** لووردبريس وShopify وWebflow وNext.js وغيرها: [افتحه ↗](https://learn.abdulosama.com/qamoos/install.md)