ملف CLAUDE.md: كيف تكتب ملفًا يتبعه Claude

ملف CLAUDE.md هو ملف Markdown فيه تعليمات يقرؤها Claude Code في بداية كل جلسة. ضعه في جذر المستودع وأبقِه قصيرًا: الأوامر الدقيقة والأعراف والتصحيحات التي لا يستنتجها Claude من الكود. شغّل /init لإنشاء مسودة أولى، ثم احذف كل سطر لا يحتاج إليه Claude.

ما ملف CLAUDE.md؟#

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

أين تضع ملف CLAUDE.md؟#

المكان يحدد من تصله التعليمات:

يحمّل Claude Code ملفي CLAUDE.md وCLAUDE.local.md من المجلد الذي تشغّله منه ومن كل مجلد فوقه، ويجمعها بدلًا من أن يلغي ملفٌ ملفًا آخر. أما الملف في مجلد فرعي، مثل packages/api/CLAUDE.md، فيُحمَّل عندما يعمل Claude على ملف في ذلك المجلد. ولمعرفة ما حُمِّل، شغّل /context وانظر تحت Memory files.

كيف تنشئ ملف CLAUDE.md؟#

شغّل /init في مشروعك. يقرأ Claude قاعدة الكود ويكتب أول ملف CLAUDE.md فيه أوامر البناء وتعليمات الاختبار والأعراف التي يجدها، أو يقترح تحسينات على الملف إن كان موجودًا. وينقل أيضًا القواعد التي كتبتها لأدوات أخرى، مثل .cursorrules. بعد ذلك يكون أغلب العمل حذف أسطر.

وللنسخة الموجّهة، شغّل Claude Code بالأمر CLAUDE_CODE_NEW_INIT=1 claude ثم اكتب /init: يطرح عليك أسئلة متابعة، ويعرض مقترحًا تراجعه قبل أن يكتب أي شيء.

ماذا تكتب في ملف CLAUDE.md؟#

كل سطر يأخذ قليلًا من انتباه Claude في كل مهمة، لذلك لا تُبقِ إلا ما لا يستنتجه Claude من الكود:

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

واترك بنية المجلدات وقوائم الاعتماديات، فـ Claude يقرؤها من المستودع وحده. وبعض الأسطر مكانها في موضع آخر:

قالب لملف CLAUDE.md#

هذا هو الملف القصير الذي يقدمه دليل أفضل الممارسات من Anthropic مثالًا. ضع أوامر مشروعك وقواعده مكان ما فيه:

# Commands
- Install: pnpm install
- Run one test file: pnpm vitest run path/to/file.test.ts
- Typecheck: pnpm tsc --noEmit

# Conventions
- Use the error helpers in src/lib/errors.ts, never throw raw strings
- src/legacy/ is still live but don't copy its patterns into new code

# Gotchas
- Integration tests need DATABASE_URL set, see .env.example

سطر فحص الأنواع هو الأمر وحده، حتى يفحص Claude عمله بنفسه. أما سطر مثل «افحص الأنواع دائمًا قبل أن تنتهي» فينجح في أغلب المرات، لا في كل مرة، ولفرضه استخدم خطاف Stop.

اكتب كل سطر بحيث تستطيع التحقق منه:

أبقِ الملف تحت 200 سطر تقريبًا، مقسّمًا بعناوين ونقاط، وشغّل /doctor prompt-audit من حين لآخر ليبحث عن التعليمات القديمة أو المتعارضة.

الاستيراد وقواعد المسارات#

يستطيع ملف CLAUDE.md أن يجلب ملفًا آخر بسطر فيه @path، مثل - Git workflow: @docs/git-instructions.md. تُحسب المسارات النسبية من الملف الذي فيه الاستيراد، والمسار المكتوب بين علامتي backtick يبقى نصًا عاديًا ولا يُستورد. ويساعدك الاستيراد في تنظيم ملف طويل، لكنه لا يقلل تكلفته في السياق، لأن النص المستورد يُحمَّل معه.

ولتُحمَّل القاعدة حيث تنطبق فقط، ضعها في .claude/rules/ مع حقل paths. والقاعدة التي ليس فيها paths تُحمَّل عند التشغيل مثل CLAUDE.md:

---
paths:
  - "src/api/**/*.ts"
---
- Validate request bodies with the zod schemas in src/api/schemas/, don't hand-roll checks
- Every new endpoint needs an entry in openapi.yaml, CI fails without it

هل يقرأ Claude Code ملف AGENTS.md؟#

نعم، منذ الإصدار 2.1.277، فالمستودع المجهّز لوكلاء برمجة آخرين يعمل دون ملف CLAUDE.md. وهذا ما يقرؤه افتراضيًا:

ولا يُحسب ملف ~/.claude/CLAUDE.md ولا ملفات .claude/rules/ في هذا الفحص. أما CLAUDE.local.md فيُحسب، لذلك إذا أضفته لملاحظاتك الخاصة توقف Claude عن قراءة ملف AGENTS.md الخاص بالفريق. ولقراءة الاثنين معًا، اكتب /config واضبط Project instructions على claude-md-and-agents-md.

ومع عنوان أساس مخصص، كما في مفتاح 5abeer، يحتاج ذلك إلى الإصدار 2.1.281 أو أحدث، وهو الإصدار الذي أضاف دعم AGENTS.md لبوابات LLM. وفي الإصدارات الأقدم، أو لتضيف أسطرًا يحتاج إليها Claude وحده، ابدأ ملف CLAUDE.md باستيراد:

@AGENTS.md

## Claude Code
Use plan mode for changes under src/billing/.

أخطاء شائعة في ملف CLAUDE.md#

• ملف طويل. بعد نحو 200 سطر تضيع الأسطر المفردة. انقل الإجراءات إلى مهارات، وقواعد المجلدات إلى .claude/rules/.
• التعارض. حين يختلف سطران قد يختار Claude أيهما، لذلك اقرأ كل ملفات التعليمات معًا.
• التشديد بدل الإصلاح. إضافة IMPORTANT أو الأحرف الكبيرة نادرًا ما تفيد النماذج الحالية، وغالبًا تجعل Claude يطبّق القاعدة أكثر من اللازم.
• قواعد لا تقبل أي استثناء. سطر «لا تقرأ ملف .env أبدًا» ينجح في أغلب المرات، لا في كل مرة. استخدم لها قاعدة رفض أو خطافًا.

ملف CLAUDE.md أم الذاكرة التلقائية؟#

أنت تكتب CLAUDE.md. أما الذاكرة التلقائية فهي ملاحظات يكتبها Claude لنفسه، مثل التصحيحات التي قدمتها، في ~/.claude/projects/<project>/memory/. ويحمّل Claude Code ملف CLAUDE.md كاملًا، لكنه لا يحمّل من فهرس الذاكرة MEMORY.md إلا أول 200 سطر أو 25KB. والذاكرة التلقائية تبقى على جهازك، فلا يراها فريقك.

قل «تذكّر أن اختبارات API تحتاج إلى Redis محلي» فيحفظها Claude في الذاكرة التلقائية، أو قل «أضف هذا إلى CLAUDE.md» ليكتبها في الملف. والأمر /memory يفتح الاثنين ويشغّل الذاكرة التلقائية أو يوقفها. وللمقارنة بين المهارات والخطافات والوكلاء الفرعيين، راجع مهارات Claude Code.

هل يزيد ملف CLAUDE.md التكلفة؟#

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

ملف CLAUDE.md عبر 5abeer#

5abeer خدمة مستقلة لا تتبع Anthropic. واجهتها البرمجية تتبع صيغة Anthropic Messages، لذلك يعمل معها Claude Code كما يصدر، والطريقان بسعر أقل من السعر الرسمي. وملف CLAUDE.md ملف على جهازك، لذلك يعمل بالطريقة نفسها مع مفتاح 5abeer؛ لا يتغير إلا عنوان الأساس والمفتاح.

بمفتاح API: أنشئ مفتاحًا لنماذج Claude، ثم ضع عنوان الأساس والمفتاح في إعدادات Claude Code:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}

يُخصم كل طلب من رصيدك بحسب النموذج وعدد التوكنات، وتتحكم في كل مفتاح بحد إنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها. الإعداد الكامل في إعداد Claude Code، والأسعار في Claude API.

واجهة Messages البرمجية لا تقرأ ملف CLAUDE.md، لذلك أرسل القواعد نفسها من الكود الخاص بك في الحقل system من الطلب، كما في Anthropic Messages.

بالاشتراك: يفعّل تطبيق 5abeer AI أداة Claude Code على اشتراكك بضغطة واحدة، دون مفتاح ودون تعديل ملفات. ويعمل الاشتراك بحد كل خمس ساعات وحد أسبوعي، كما في حدود الاشتراك. الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع ما الذي تشغّله كل باقة وصفحة الأسعار.

أسئلة شائعة#

هل يجب أن يكون اسم الملف CLAUDE.md؟#

نعم، أو CLAUDE.local.md لملاحظاتك الخاصة. ويقرأ Claude Code أيضًا AGENTS.md عندما لا يوجد CLAUDE.md. ولا يُحمَّل أي ملف آخر إلا باستيراد @path أو من .claude/rules/.

هل أضع ملف CLAUDE.md في git؟#

ملف المشروع نعم، فإيداعه يعطي فريقك التعليمات نفسها. واحفظ ملاحظاتك الخاصة في CLAUDE.local.md وأضفه إلى .gitignore. هذا الملف لا يوجد إلا في الـ worktree الذي أنشأته فيه، لذلك إذا عملت على أكثر من worktree فاستورد ملفًا من مجلدك الرئيسي، مثل @~/.claude/my-project-instructions.md.

ما الطول المناسب لملف CLAUDE.md؟#

أقل من 200 سطر تقريبًا، كما توصي Anthropic، ويعرض Claude Code تحذيرًا عند التشغيل وفي /status عندما يطول ملف عن ذلك. وملفات المجلدات الفرعية وقواعد المسارات، التي تُحمَّل عند الحاجة، تُقطع عند 40,000 حرف في نافذة سياق 200K.

لماذا يتجاهل Claude ملف CLAUDE.md؟#

شغّل /context. إذا لم يظهر تحت Memory files ملفٌ يجب أن يُحمَّل عند التشغيل، فراجع اسمه ومكانه. وإذا كان محمَّلًا، فاجعل السطر أدق، واحذف ما يعارضه، واختصر الملف. القاعدة التي يجب أن تصمد كل مرة مكانها خطاف.

هل يبقى ملف CLAUDE.md بعد /compact؟#

ملف CLAUDE.md في جذر المشروع يبقى: يقرؤه Claude Code مرة أخرى من القرص بعد /compact. وتعود ملفات المجلدات الفرعية وقواعد المسارات عندما يعمل Claude على ملف مطابق. أما التعليمات التي قلتها في المحادثة وحدها فقد تضيع، لذلك اكتب في الملف ما تريد الاحتفاظ به.

المصادر#

راجعنا هذه المصادر في 2 نوفمبر 2026.

• توثيق Claude Code: How Claude remembers your project
• توثيق Claude Code: Best practices for Claude Code
• سجل تغييرات Claude Code، الإصداران 2.1.277 و2.1.281

ابدأ#

للمقارنة بين الباقات والمفاتيح في Claude Code، اقرأ أرخص طريقة لـ Claude Code، أو جهّز Claude Code الآن.