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

> ما ملف CLAUDE.md، وأين تضعه، وما الذي تكتبه فيه، مع قالب قصير، وعلاقته بملف AGENTS.md، وتشغيل Claude Code به بمفتاح API.

آخر تحديث: 2026-11-02

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

## ما ملف CLAUDE.md؟

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

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

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

| المستوى | المكان | من تصله |
| --- | --- | --- |
| المشروع | `./CLAUDE.md` أو `./.claude/CLAUDE.md` | فريقك كله، عبر نظام إدارة الإصدارات |
| محلي | `./CLAUDE.local.md`، بعد إضافته إلى `.gitignore` | أنت وحدك، في هذا المشروع |
| المستخدم | `~/.claude/CLAUDE.md` | أنت وحدك، في كل مشاريعك |
| مُدار | مجلد نظام يتحكم فيه فريق تقنية المعلومات، مثل `/etc/claude-code/CLAUDE.md` على Linux | كل من في مؤسستك |

يحمّل 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 يقرؤها من المستودع وحده. وبعض الأسطر مكانها في موضع آخر:

| إذا كان السطر | انقله إلى |
| --- | --- |
| إجراءً متعدد الخطوات، مثل إصدار نسخة جديدة | [مهارة](https://5abeer.ai/ar/guides/claude-code-skills)، يُحمَّل نصها الكامل عند الاستخدام فقط |
| قاعدة لجزء واحد من قاعدة الكود | `.claude/rules/`، مع حقل `paths` |
| شيئًا يجب أن يحدث كل مرة، مثل تشغيل أداة التنسيق | [خطاف](https://5abeer.ai/ar/guides/claude-code-hooks)، يعمل عند كل حدث مطابق |
| تفضيلًا شخصيًا لك | `CLAUDE.local.md` أو `~/.claude/CLAUDE.md` |

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

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

```text
# 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`.

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

| غامض | محدد |
| --- | --- |
| نسّق الكود جيدًا | استخدم إزاحة بمسافتين |
| اختبر تغييراتك | شغّل `npm test` قبل كل إيداع |
| نظّم الملفات | معالجات API في `src/api/handlers/` |

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

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

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

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

```text
---
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 Code |
| --- | --- |
| `AGENTS.md`، ولا يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو فوقه | `AGENTS.md` |
| `AGENTS.md` وأحد هذه الملفات الثلاثة | ملفات `CLAUDE.md` وحدها |
| ملف `CLAUDE.md` يستورد `@AGENTS.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` باستيراد:

```text
@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](https://5abeer.ai/ar/guides/claude-code-skills#vs-claude-md).

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

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

Claude Sonnet 5.5 (`claude-sonnet-5.5`) لكل مليون توكن: الإدخال 0.60 US$ (الرسمي 2 US$)، الإخراج 3 US$ (الرسمي 10 US$). آخر مراجعة للسعر الرسمي: 19 أكتوبر 2026.

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

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

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

| الصيغة | العنوان الأساسي | ترويسة المفتاح |
| --- | --- | --- |
| OpenAI | `https://api.5abeer.ai/v1` | `Authorization: Bearer <KEY>` |
| Anthropic | `https://api.5abeer.ai` | `x-api-key: <KEY>` |
| Gemini | `https://api.5abeer.ai/v1beta` | `x-goog-api-key: <KEY>` |

`~/.claude/settings.json`

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

يُخصم كل طلب من رصيدك بحسب النموذج وعدد التوكنات، وتتحكم في كل مفتاح بحد إنفاق وتاريخ انتهاء وقائمة عناوين IP مسموح بها. الإعداد الكامل في [إعداد Claude Code](https://5abeer.ai/ar/docs/apps/claude-code.md)، والأسعار في [Claude API](https://5abeer.ai/ar/api/claude).

واجهة Messages البرمجية لا تقرأ ملف `CLAUDE.md`، لذلك أرسل القواعد نفسها من الكود الخاص بك في الحقل `system` من الطلب، كما في [Anthropic Messages](https://5abeer.ai/ar/docs/api/messages.md#params).

**بالاشتراك:** يفعّل تطبيق 5abeer AI أداة Claude Code على اشتراكك بضغطة واحدة، دون مفتاح ودون تعديل ملفات. ويعمل الاشتراك بحد كل خمس ساعات وحد أسبوعي، كما في [حدود الاشتراك](https://5abeer.ai/ar/docs/subscriptions/limits.md). الباقات مخصصة للتطبيقات المدعومة، ولاستخدام النماذج من الكود الخاص بك تحتاج إلى مفتاح API. راجع [ما الذي تشغّله كل باقة](https://5abeer.ai/ar/docs/subscriptions/plan-apps.md#claude-code) و[صفحة الأسعار](https://5abeer.ai/ar/pricing).

## أسئلة شائعة

### هل يجب أن يكون اسم الملف 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](https://code.claude.com/docs/en/memory)
- [توثيق Claude Code: Best practices for Claude Code](https://code.claude.com/docs/en/best-practices)
- [سجل تغييرات Claude Code](https://code.claude.com/docs/en/changelog)، الإصداران 2.1.277 و2.1.281

## ابدأ

للمقارنة بين الباقات والمفاتيح في Claude Code، اقرأ [أرخص طريقة لـ Claude Code](https://5abeer.ai/ar/guides/claude-code-cheapest-way)، أو جهّز Claude Code الآن.