CLAUDE.md (Claude Code): مكانه وكيفية قراءته من الأدوات

ملف CLAUDE.md هو ملف الذاكرة الذي يحمّله Claude Code عند التشغيل من مجلدك الرئيسي والمشروع وكل المجلدات الأم. تضيف القواعد المحددة حسب المسار في .claude/rules/ إرشادات لا تُحمّل إلا عند قراءة ملفات تطابق المسارات المحددة.

مكان الملف

• المشروع: ./CLAUDE.md أو ./.claude/CLAUDE.md، يُضاف إلى المستودع ويُشارك مع الفريق.
• محلي: ./CLAUDE.local.md، للملاحظات الشخصية التي لا تريد إضافتها إلى Git.
• المستخدم: ~/.claude/CLAUDE.md، ويُطبّق على كل مشروع.
• القواعد: ./.claude/rules/**/*.md و ~/.claude/rules/**/*.md، ويمكن تحديد نطاقها اختياريًا باستخدام ترويسة paths.
• السياسة المُدارة: /Library/Application Support/ClaudeCode/CLAUDE.md على macOS، أو C:\Program Files\ClaudeCode\CLAUDE.md على Windows، أو المفتاح claudeMd في managed-settings.json.

التنسيق

Markdown. يمكن أن تبدأ الملفات في .claude/rules/ ببيانات YAML وصفية، ويتضمن مفتاح paths فيها أنماط glob. أدرج ملفات أخرى باستخدام @path/to/file، بعمق يصل إلى 4 مستويات؛ لا يوجد حد أقصى موثّق للحجم، لكن Anthropic تنصح بألا يتجاوز كل ملف 200 سطر.

مفاتيح Frontmatter: paths

@AGENTS.md

# Claude Code notes

- Run `pnpm test` after every change under src/.
- Use the `gh` CLI for issues and pull requests.
- Ask before adding a dependency.

## API

- Error format is described in @docs/api-errors.md.
- One handler file per route in src/api/.

الأولوية والدمج

لا يُستبدل أي محتوى: تُجمع كل الملفات المكتشفة في ملف واحد. تُحمّل السياسة المُدارة أولاً، ثم الملفات بدءاً من جذر نظام الملفات وصولاً إلى مجلد التشغيل، لذا تُقرأ الملفات الأقرب أخيراً؛ وفي المجلد نفسه يأتي CLAUDE.local.md بعد CLAUDE.md. تُحمّل الملفات في المجلدات الفرعية عند الطلب، عندما يقرأ Claude ملفات فيها، ولا يمكن استثناء السياسة المُدارة باستخدام claudeMdExcludes.

الأدوات التي تقرأه

نصائح

• إذا كنت تحتفظ بملف CLAUDE.md، فابدأه بـ @AGENTS.md؛ وإلا فسيتجاهل Claude Code ملف AGENTS.md في الإعداد الافتراضي.
• انقل الإرشادات الخاصة بمناطق معينة إلى .claude/rules/، وأضف بيانات paths الوصفية لتحميلها مع الملفات المطابقة فقط.
• تُسهّل عمليات الاستيراد تنظيم الملف، لكنها تستهلك مساحة من السياق أيضاً، لأن النص المستورَد يُحمّل كذلك.
• شغّل /doctor لمراجعة CLAUDE.md وCLAUDE.local.md وAGENTS.md والقواعد والمهارات دفعة واحدة.

ملفات التعليمات الأخرى