Cursor Rules أم CLAUDE.md أم AGENTS.md؟ جربنا إعدادًا واحدًا عبر الأدوات الثلاث (2026)
سؤال Cursor Rules vs CLAUDE.md يخفي فخًا: هذان ليسا خيارين تختار بينهما. إنهما ملفان تقرأهما أداتان مختلفتان، ويصادف أنهما يؤديان المهمة نفسها. ضع ملف CLAUDE.md داخل مشروع Cursor، وسيتجاهله Cursor تمامًا. ضع AGENTS.md داخل Claude Code، ولن يحدث شيء أيضًا. فاجأنا هذا أيضًا. أصبح AGENTS.md معتمدًا الآن في أكثر من 60 ألف مستودع بوصفه معيارًا مفتوحًا، تشرف عليه مؤسسة Agentic AI التابعة لمؤسسة Linux، ومع ذلك ما زال Claude Code لا يقرأه من تلقاء نفسه. إليك خريطة التوافق كما اختبرناها على مستودعنا الخاص.
أبرز النقاط
- يقرأ Cursor ملفات
.cursor/rules/*.mdcوملفAGENTS.md، ولا يقرأCLAUDE.md. - يقرأ Claude Code ملف
CLAUDE.mdفقط، ولا يقرأAGENTS.mdبشكل أصلي. - لمشاركة ملف واحد: اربط
AGENTS.mdرمزيًا بـCLAUDE.md، أو استوردْه عبر@AGENTS.md. - اعتمد
AGENTS.mdكمرجع موحّد (معيار مفتوح، أكثر من 60 ألف مستودع)، ثم أضف استثناءات خاصة بكل أداة.
أي صيغة إعدادات تختار؟ القرار في 30 ثانية
اختر الصيغة بحسب شكل فريقك، لا بحسب الرواج. إن كنت تستخدم أداة واحدة، فاستخدم ملفها الأصلي. وإن كنت تستخدم أداتين أو أكثر، اعتمد AGENTS.md مرجعًا موحدًا وأضف استثناءات لكل أداة فقط حين تحتاج شيئًا لا تحتاجه البقية. هذه القاعدة وحدها تحسم معظم الالتباس.
| إعدادك | استخدم هذا | السبب |
|---|---|---|
| مستقل، Cursor فقط | .cursor/rules/*.mdc | مقيّد بأنماط الملفات، أربعة أنواع قواعد، أصلي |
| مستقل، Claude Code فقط | CLAUDE.md | الملف الوحيد الذي يحمّله Claude Code |
| أدوات مختلطة (Cursor + Claude Code + Codex) | AGENTS.md + رابط رمزي/استيراد | ملف واحد تقرأه كل الأدوات |
| مستودع متعدد الحزم (monorepo)، مشاريع فرعية كثيرة | AGENTS.md، متداخل لكل حزمة | يفوز الملف الأقرب، فتصف كل حزمة فرعية نفسها |
هل ما زلت تقرر أي مساعد تشغّله قبل أن تشغل بالك بإعداداته؟ ابدأ بدليلنا حول اختيار وكيل البرمجة الأنسب لك، ثم عد لضبط الملفات.
المحور الحاسم في القرار هو قابلية النقل. ملف .cursor/rules قوي داخل Cursor عديم الفائدة خارجه، أما AGENTS.md فينتقل معك أينما ذهبت. لذا ما لم تكن مقيّدًا بأداة واحدة إلى الأبد، فالملف المستقل عن الأداة هو الرهان الأكثر أمانًا.
ما هي كل صيغة فعليًا؟ (في 30 ثانية لكل واحدة)
تؤدي هذه الملفات الثلاثة مهمة واحدة: تسليم قواعد مشروعك وأعرافه ومطباته لأداة برمجة ذكاء اصطناعي قبل أن تكتب سطرًا واحدًا. الفرق يكمن في من يقرأها وكيف تُحدَّد نطاقاتها. إليك النسخة المختصرة، أما الدليل التفصيلي لكل صيغة فموجود في مقاله الخاص.
Cursor Rules هي ملفات .mdc داخل .cursor/rules/. يدعم Cursor أربعة أنواع من القواعد (دائمة التفعيل، مطلوبة من الوكيل، مقيدة بنمط الملفات، ويدوية عبر إشارة @)، فيمكنك ربط قاعدة بملفات *.tsx فقط أو بترحيلات قاعدة البيانات فقط. للاطلاع على الترويسة (frontmatter) والأنماط وميزانية الرموز، راجع دليلنا حول كيفية كتابة ملفات .cursor/rules فعليًا.
CLAUDE.md هو ملف الذاكرة الخاص بـ Claude Code. يتصعّد Claude عبر شجرة المجلدات بدءًا من مجلد العمل الحالي ويدمج كل ملف CLAUDE.md يجده. إنه ملف Markdown عادي، لا يحتاج إلى ترويسة. للاطلاع على البنية والقواعد التي تمنع Claude من تجاهله، راجع ما الذي يجعل CLAUDE.md ملفًا لا يتجاهله Claude.
AGENTS.md هو المعيار المفتوح. ملف Markdown عادي واحد في جذر المستودع، تقرأه أصليًا كل من Cursor وCodex وCopilot وWindsurf وZed وAider وعشرات غيرها. تشرف عليه مؤسسة Agentic AI، وهو معتمد بالفعل في أكثر من 60 ألف مشروع.
إليك الفكرة الجديرة بالتذكر: AGENTS.md وCLAUDE.md وملفات .cursor/rules ليست متنافسة، بل هي التعليمات نفسها موجهة لقراء مختلفين.
Cursor Rules مقابل CLAUDE.md مقابل AGENTS.md: المقارنة الشاملة
أسرع طريقة لرؤية الفرق هي عرضها جنبًا إلى جنب. العمود الحاسم هو قابلية النقل: أي الأدوات تقرأ الملف دون إعداد إضافي. يتفوق AGENTS.md في الانتشار، وتتفوق Cursor Rules في دقة التحديد، ويتفوق CLAUDE.md لمن اعتمد كليًا على Claude Code.
| الصيغة | مسار الملف | الأدوات التي تقرأه | النطاق | نموذج الأولوية | قابلية النقل |
|---|---|---|---|---|---|
| Cursor Rules | .cursor/rules/*.mdc | Cursor فقط | مقيّد بأنماط الملفات، أربعة أنواع قواعد | فريق ← مشروع ← مستخدم، مدمجة | منخفضة (حصرية لـ Cursor) |
| CLAUDE.md | CLAUDE.md (أي مجلد) | Claude Code فقط | تصعيد عبر المجلدات، مدمج | تراكمي، يفوز الملف الأقرب | منخفضة (حصرية لـ Claude) |
| AGENTS.md | AGENTS.md (الجذر والمجلدات الفرعية) | Cursor وCodex وCopilot وWindsurf وZed وAider و20+ | المشروع كاملًا أو متداخل | يفوز أقرب ملف في الشجرة | عالية (معيار مفتوح) |
| .cursorrules (قديم) | .cursorrules (الجذر) | Cursor (غير موثّق) | ملف جذر واحد | الجذر فقط | منخفضة، شبه مهجور |
| SKILL.md (ناشئ) | .claude/skills/*/SKILL.md | Claude (Skills) | عند الطلب، بحسب المهمة | يُحمَّل عند الاستدعاء | خاص بـ Claude، ما زال يتطور |
لاحظ صف .cursorrules. هذا الملف الجذري الواحد ما زال يعمل في Cursor، لكنه سقط من التوثيق الرسمي، فعامِله على أنه ملف قديم. المشاريع الجديدة ينبغي أن تستخدم .cursor/rules/*.mdc أو AGENTS.md بدلًا منه.
أي أداة تقرأ أي ملف؟ (تفنيد خرافة AGENTS.md)
إليك الحقيقة التي يخطئ فيها نصف الإنترنت: Claude Code لا يقرأ AGENTS.md أصليًا، وCursor لا يقرأ CLAUDE.md. يقرأ Cursor ملفات .cursor/rules/*.mdc بالإضافة إلى AGENTS.md. أما Claude Code فيقرأ CLAUDE.md فقط ولا شيء غيره. لا يوجد أي احتياط تلقائي في أي من الاتجاهين، وهذا ما يوقع الفرق التي تفترض أن ملفًا معياريًا واحدًا يغطي كل شيء.
يُطرح هذا السؤال باستمرار، فلنكن صريحين. وضع ملف AGENTS.md داخل مشروع Claude Code لا يفعل شيئًا بمفرده. يقرأ Claude Code ملف CLAUDE.md فقط ولا شيء سواه. توثيق Anthropic حول ذاكرة Claude Code يشرح آلية التحميل دون أي ذكر لـ AGENTS.md، ومواصفة AGENTS.md تدرج Cursor وCodex ضمن القرّاء الأصليين لكن ليس Claude Code، وتوثيق Cursor لقواعده يؤكد هذا الانفصال، كما أن مشكلات Claude Code على GitHub مليئة بمطورين اصطدموا بهذا الحاجز تمامًا.
فهل يقرأ Cursor ملف claude.md؟ لا. وهل يقرأ Claude Code ملف agents.md؟ ليس دون مساعدة. تلك "المساعدة" هي سبب وجود هذا المقال بالكامل، وهي أمران قصيران ستراهما بعد قليل.
كيف تعمل الأولوية والتداخل جنبًا إلى جنب
تحل كل أداة التعارضات بطريقتها الخاصة، والخطأ في فهم ذلك هو السبب الأول وراء التساؤل: "لماذا تُتجاهل قاعدتي؟" يدمج Cursor القواعد حسب أولوية المصدر. يدمج Claude Code الملفات حسب عمق المجلد. أما AGENTS.md فيختار أقرب ملف في الشجرة. إدارة claude md management الجيدة تبدأ بمعرفة أي نموذج ذهني أنت فيه.
| الأداة | كيف تحمّل الملفات | من يفوز عند التعارض |
|---|---|---|
| Cursor | تُدمج قواعد الفريق والمشروع والمستخدم معًا | المصدر الأسبق (الفريق) يفوز |
| Claude Code | يتصعّد من مجلد العمل الحالي، ويدمج كل ملف CLAUDE.md | يفوز الملف الأقرب والأكثر تحديدًا؛ الملف المُدار يُحمَّل أولًا |
| AGENTS.md | يقرأ أقرب ملف AGENTS.md في شجرة المجلدات | يفوز الملف الأقرب لمجلد العمل الحالي |
في إعدادنا، الخلاصة العملية بسيطة: ضع القواعد العامة في الأعلى (جذر المستودع) والقواعد الخاصة في الأسفل (داخل مجلد حزمة). في كل من Claude Code وAGENTS.md، يفوز الملف الأقرب إلى مكان عملك، فملف packages/api/AGENTS.md يتجاوز ملف الجذر لأي شيء داخل ذلك المجلد. أما Cursor فهو الاستثناء، إذ يحل التعارض حسب مستوى المصدر لا حسب عمق المجلد.
شغّلنا إعدادًا واحدًا عبر Cursor وClaude Code، وإليك ما حمّلته كل أداة فعليًا
اختبرنا هذا على مستودع فعلي لعميل لدى Techsy (خلفية Next.js 15) باستخدام Cursor 3.7 (إصدار 17 يونيو 2026) وClaude Code v2.1.x (بداية يوليو 2026). ملف AGENTS.md واحد، وثلاثة أساليب مشاركة، ونفس الطلب مفتوح في الأداتين. إليك بالضبط ما حمّلته كل أداة.
بدأنا بملف بسيط:
# AGENTS.md
- Package manager: pnpm, never npm.
- Tests: Vitest. Run `pnpm test` before any commit.
- DB access goes through `lib/db.ts` only, no inline SQL.الإعداد 1: AGENTS.md وحده. التقطه Cursor فورًا. ظهر الملف في سياقه ورفض بشكل صحيح اقتراح npm install. لم يفعل Claude Code شيئًا حياله. أظهر تشغيل الأمر /memory في Claude Code قائمة فارغة من ملفات ذاكرة المشروع: لم يُعثر على CLAUDE.md، ولم يُعترف بوجود AGENTS.md من الأساس. تأكد إذًا: لا يوجد احتياط أصلي.
الإعداد 2: الرابط الرمزي. وجّهنا CLAUDE.md نحو الملف نفسه:
ln -s AGENTS.md CLAUDE.mdعندها أدرج الأمر /memory في Claude Code ملف ./CLAUDE.md كذاكرة مشروع، وكان المحتوى المُحمَّل هو AGENTS.md حرفًا بحرف. ظل Cursor يقرأ AGENTS.md مباشرة كما هو. ملف مادي واحد، وكلتا الأداتين راضيتان. على ويندوز يحتاج هذا الأمر إلى صلاحيات المدير أو تفعيل وضع المطور، وإلا فشل ln/mklink بصمت.
الإعداد 3: الاستيراد بـ @. حذفنا الرابط الرمزي، ووضعنا بدلًا منه سطرًا واحدًا في أعلى ملف CLAUDE.md حقيقي:
@AGENTS.mdعندها أظهر الأمر /memory أن CLAUDE.md هو الملف المُحمَّل، مع سحب AGENTS.md كمرجع مستورد أسفله. هذا هو المسار الذي توثقه Anthropic فعليًا، ولا يحتاج إلى أي صلاحيات خاصة بنظام التشغيل.
الخلاصة من اختبارنا: الرابط الرمزي يجعل Claude Code يقرأ AGENTS.md حرفًا بحرف؛ والاستيراد عبر @AGENTS.md هو النسخة الآمنة على ويندوز التي توصي بها Anthropic فعليًا. يمنحك كلاهما مصدرًا موحدًا للحقيقة. اختر الرابط الرمزي على macOS/Linux لعدم وجود أي وسيط، أو سطر الاستيراد إن كان أحد أعضاء الفريق يعمل على ويندوز.
الترحيل بين الصيغ: .cursorrules ← .cursor/rules ← AGENTS.md
معظم الفرق تصل إلى هنا وهي تحمل ملف .cursorrules قديمًا وتريد الخروج من فخ الملف الواحد. الترحيل قصير في كل اتجاه، والخطوات نسخ ولصق. المطب الوحيد الذي يعضّ الجميع: ملف .md داخل .cursor/rules بدون ترويسة (frontmatter) يُتجاهل بصمت، لذا يجب أن يكون بامتداد .mdc.
لتحديث ملف .cursorrules قديم، لديك مساران واضحان:
- إلى
.cursor/rules/*.mdc: أنشئ.cursor/rules/general.mdc، وأضف ترويسة (alwaysApply: trueلقاعدة عامة)، والصق محتواك القديم أسفلها. احذف.cursorrulesبعد التحقق. - إلى
AGENTS.md(موصى به للفرق متعددة الأدوات): لتحويل cursorrules إلى agents.md، انسخ محتوى.cursorrulesإلى ملفAGENTS.mdجديد في جذر المستودع. لا حاجة لترويسة؛ فهو Markdown عادي. ثم أضف الرابط الرمزي أو استيراد@AGENTS.mdليقرأه Claude Code أيضًا.
إن كنت باقيًا داخل Cursor وتريد الاستفادة منه أكثر، فدليلنا عن الاستفادة القصوى من Cursor يوميًا يغطي تحديد نطاق القواعد عمليًا.
أما الاتجاه المعاكس (من AGENTS.md إلى CLAUDE.md) فهو مجرد الرابط الرمزي أو الاستيراد من الفقرة السابقة. لا يوجد أي تحويل يفقد بيانات لأن الثلاثة جميعًا Markdown في جوهرها.
أين يقع SKILL.md وتعليمات Copilot من هذا كله؟
تظهر صيغتان إضافيتان في هذا النقاش، وskills md بحث متصاعد حاليًا، فيستحق الأمر توضيحًا سريعًا لموقعه. لا تحل أي منهما محل الملفات الثلاثة الرئيسية؛ بل تتموضعان إلى جانبها.
SKILL.md هو صيغة Skills الخاصة بـ Anthropic: تعليمات مخصصة لمهام محددة مجمّعة في .claude/skills/*/SKILL.md يحمّلها Claude عند الطلب حين تتطابق مهمة ما، بدلًا من التحميل الدائم كما في CLAUDE.md. فكّر فيه كدليل تشغيل متخصص يلجأ إليه Claude، لا كملف ذاكرة يخص المشروع كله. النطاق ما زال يتطور، فلا تستثمر فيه بشكل مبالغ فيه بعد. لمعرفة موقعه ضمن سير عمل حقيقي، راجع أين يقع CLAUDE.md ضمن سير عمل حقيقي في Claude Code.
تعليمات Copilot توجد في .github/copilot-instructions.md لأداة GitHub Copilot. خبر جيد: يقرأ Copilot أيضًا AGENTS.md، فإن كنت قد اعتمدت المعيار المفتوح بالفعل، فـCopilot مغطى تلقائيًا دون الحاجة إلى ملف منفصل.
ما الذي يجب أن تستخدمه؟ (بحسب شكل الفريق)
طابِق الصيغة مع طريقة عمل فريقك الفعلية:
- مستخدم Claude Code منفرد: استخدم
CLAUDE.mdفقط. لا داعي لإضافة AGENTS.md ما لم تخطط لإدخال Cursor أو Codex لاحقًا. - مستخدم Cursor منفرد:
.cursor/rules/*.mdcلتحديد النطاق بدقة، أو ملفAGENTS.mdواحد إن أردت قابلية النقل منذ اليوم الأول. - فريق بأدوات مختلطة: ملف
AGENTS.mdواحد كمرجع موحد، مربوط رمزيًا أو مستورد داخلCLAUDE.md. أضف ملف.cursor/rulesصغيرًا فقط للسلوك الخاص بـ Cursor. - مستودع متعدد الحزم:
AGENTS.mdفي الجذر مع ملفات متداخلة لكل حزمة، بحيث يصف كل مشروع فرعي نفسه ويفوز الملف الأقرب.
في Techsy نوحّد إعدادات البرمجة بالذكاء الاصطناعي عبر الفرق متعددة الأدوات، عادةً بملف AGENTS.md واحد كمرجع موحد مع استثناءات لكل أداة حين تحتاجها. إن كان فريقك يوازن يدويًا بين ثلاثة ملفات إعدادات، احصل على استشارة مجانية وسنرسم لك الخريطة.
ملاحظة أخيرة: هذا المقال يقارن الملفات نفسها. أما إن كنت فعليًا تحاول الاختيار بين الأدوات ذاتها، فاقرأ مقارنة المساعدات نفسها لا إعداداتها.
عن الكاتب
مرت باتور هو الشريك المؤسس لـ Techsy.io، حيث يبني الفريق وكلاء الذكاء الاصطناعي وأنظمة الأتمتة وخطوط الصوت وتطوير المبيعات (SDR) لعملاء B2B. يكتب عن منظومة أدوات LLM التي يستخدمها فريق Techsy فعليًا في الإنتاج.
الشريك المؤسس، Techsy.io · LinkedIn
الأسئلة الشائعة
هل يقرأ Cursor ملف CLAUDE.md؟
لا. يقرأ Cursor ملفات .cursor/rules/*.mdc وملف AGENTS.md بشكل أصلي، لكن CLAUDE.md غير مذكور إطلاقًا في توثيق Cursor ولا يُحمَّل. إن كنت تستخدم Cursor وتريد مشاركة الإعدادات مع مستخدمي Claude Code، ضع قواعدك في AGENTS.md (الذي يقرأه Cursor فعلًا) بدلًا من CLAUDE.md.
هل يقرأ Claude Code ملف AGENTS.md؟
ليس بشكل أصلي. يقرأ Claude Code ملف CLAUDE.md فقط، دون أي احتياط تلقائي إلى AGENTS.md. لجعل الأمر يعمل، اربط الملفين رمزيًا (ln -s AGENTS.md CLAUDE.md) ليقرأ Claude ملف AGENTS.md حرفًا بحرف، أو أضف @AGENTS.md في السطر الأول من ملف CLAUDE.md لاستيراده. الاستيراد هو الخيار الموصى به من Anthropic والآمن على ويندوز.
هل يمكنني استخدام ملف واحد فقط للأدوات الثلاث؟
نعم. اعتمد AGENTS.md مرجعًا موحدًا وحيدًا، وسيقرأه Cursor وCodex مباشرة. أما بالنسبة لـ Claude Code، فأضف جسرًا واحدًا: إما ربط AGENTS.md رمزيًا بـ CLAUDE.md، أو وضع @AGENTS.md في أعلى ملف CLAUDE.md. تحافظ على ملف واحد فقط، وتحمّل كل أداة القواعد نفسها. هذه هي وصفة توحيد الإعدادات بالكامل.
هل ملف .cursorrules مهجور؟
شبه مهجور. ما زال ملف .cursorrules الجذري الواحد يعمل في Cursor، لكنه لم يعد موجودًا في التوثيق الرسمي، وهذه عادةً إشارة إلى أن صيغة ما في طريقها إلى الزوال. المشاريع الجديدة ينبغي أن تستخدم .cursor/rules/*.mdc للقواعد المحددة النطاق أو AGENTS.md لقابلية النقل.
كيف أحوّل .cursorrules إلى AGENTS.md؟
انسخ محتوى ملف .cursorrules إلى ملف AGENTS.md جديد في جذر المستودع. إنه Markdown عادي، فلا حاجة لأي ترويسة أو إعادة تنسيق. ثم أضف رابطًا رمزيًا أو استيراد @AGENTS.md ليقرأه Claude Code أيضًا، واحذف ملف .cursorrules القديم بعد التأكد من أن Cursor يلتقط الملف الجديد.
ما الفرق بين CLAUDE.md وAGENTS.md؟
CLAUDE.md ملف ذاكرة خاص بـ Claude Code، يقرأه Claude Code فقط. أما AGENTS.md فهو معيار مفتوح يقرأه Cursor وCodex وCopilot وأكثر من 20 أداة أخرى، لكن ليس Claude Code بشكل أصلي. الصيغة نفسها Markdown، والمهمة نفسها. الفرق هو الانتشار. ينتقل AGENTS.md عبر الأدوات، بينما يبقى CLAUDE.md حبيس Claude Code.
أي صيغة ينبغي أن يعتمدها فريق يستخدم أدوات ذكاء اصطناعي متعددة؟
AGENTS.md. إنه المعيار المفتوح، تقرأه معظم الأدوات أصليًا، ومعتمد بالفعل في أكثر من 60 ألف مستودع. وحّد قواعدك المشتركة فيه، واربطه بـ Claude Code عبر رابط رمزي أو استيراد، وأضف ملفات صغيرة خاصة بكل أداة (مثل .cursor/rules) فقط حين تحتاج أداة واحدة سلوكًا لا تحتاجه البقية.
كيف تعمل الأولوية عندما يكون لدي ملفات إعدادات متداخلة؟
في كل من Claude Code وAGENTS.md، يفوز الملف الأقرب لمجلد عملك، فقاعدة موجودة في packages/api/AGENTS.md تتجاوز ملف جذر المستودع لأي شيء داخل ذلك المجلد. أما Cursor فمختلف: فهو يدمج قواعد الفريق والمشروع والمستخدم حسب مستوى المصدر لا حسب عمق المجلد، ويفوز فيه المصدر الأسبق عند التعارض.
أين يقع SKILL.md من هذا كله؟
SKILL.md صيغة ناشئة من Skills الخاصة بـ Anthropic: تعليمات مخصصة لمهام محددة في .claude/skills/*/SKILL.md يحمّلها Claude عند الطلب حين تتطابق مهمة ما، بدلًا من التحميل الدائم كما في CLAUDE.md. إنه مكمّل لـ CLAUDE.md لا بديل عنه. النطاق ما زال يتطور في 2026، فعامِله كإضافة متخصصة، لا كملف رابع يحتاجه كل مشروع.