Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md هو ملف إعداد بصيغة Markdown يُوضع في جذر مشروعك ليوفر لـ Claude Code تعليمات دائمة وخاصة بالمشروع. يُخبر الوكيل بأعراف البرمجة والمعمارية والأوامر الشائعة والقواعد — إذ يعمل كشكل من أشكال الذاكرة طويلة الأمد التي تسري على كل جلسة في ذلك المشروع.

كيف يعمل CLAUDE.md

عندما يبدأ Claude Code جلسة، يقرأ تلقائياً ملف CLAUDE.md في جذر مشروعك (وأي ملفات CLAUDE.md في الدلائل الأم أو الفرعية). يصبح المحتوى جزءاً من سياق النظام للوكيل، لذا يتبع تعليماتك دون الحاجة إلى التذكير في كل جلسة. هذا يجعل الوكيل يتصرف باتساق مع أعراف فريقك.

ما الذي يجب تضمينه في CLAUDE.md

  • +نظرة عامة على معمارية المشروع ومواقع الملفات الرئيسية
  • +أعراف البرمجة (التسمية، والتنسيق، والأنماط التي يجب اتباعها أو تجنبها)
  • +الأوامر الشائعة للاختبار والبناء والنشر
  • +قواعد مثل "اكتب دائماً اختبارات للدوال الجديدة" أو "لا تعدّل وحدة auth مباشرة"
  • +تفاصيل مجموعة التقنيات التي يجب أن يكون الوكيل على دراية بها
markdown
# CLAUDE.md

## Project
Next.js 14 app with App Router, TypeScript, Tailwind CSS.

## Commands
- `npm run dev` — start dev server
- `npm test` — run Jest tests
- `npm run lint` — ESLint check

## Conventions
- Use server components by default
- Client components go in `components/client/`
- All API routes must validate input with Zod
- Write tests for every new utility function

## Do NOT
- Modify files in `lib/core/` without explicit approval
- Use `any` type in TypeScript
- Add new dependencies without justification

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

أين يجب أن أضع ملف CLAUDE.md؟+
ضعه في جذر دليل مشروعك. يدعم Claude Code أيضاً ملفات CLAUDE.md في الدلائل الفرعية للتعليمات الخاصة بالوحدات، وفي الدلائل الأم للقواعد على مستوى المؤسسة. تُدمج جميع الملفات المنطبقة معاً.
هل يعمل CLAUDE.md مع أدوات الذكاء الاصطناعي الأخرى؟+
CLAUDE.md خاص بـ Claude Code. ومع ذلك، اعتمدت بعض الأدوات الأخرى مفاهيم مماثلة. يستخدم Cursor ملف .cursorrules، وقد تقرأ الوكلاء الآخرون ملفات إعداد مخصصة. أصبح مفهوم التعليمات على مستوى المشروع للذكاء الاصطناعي نمطاً شائعاً.
كم يجب أن يكون طول CLAUDE.md؟+
حافظ عليه في حدود 500 سطر. ركّز على أهم الأعراف والقواعد. يمكن للوكيل دائماً قراءة الملفات الفردية للحصول على التفاصيل — يجب أن يوفر CLAUDE.md السياق الرفيع المستوى الذي ينطبق على المهام المختلفة.

Related terms

البرمجة الوكيليةClaude Codeهندسة المطالبات للبرمجة

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS