# أصبح Claude Code يقرأ AGENTS.md: ما الذي تغيّر في 2.1.277 > في 18 سبتمبر 2026، أضاف Claude Code 2.1.277 دعمًا مباشرًا لـ AGENTS.md: متى يُحمَّل الملف، وكيفية اختيار واحدة من 4 أوضاع، وما ينبغي فعله بشأن عمليات الاستيراد. Source: https://ailoot.ai/blog/ar/claude-code-agents-md-support/ Canonical: https://ailoot.ai/blog/ar/claude-code-agents-md-support/ Language: ar Publisher: Ailoot (https://ailoot.ai/) Translation: guide-041 Revision: sha256-02933d2c3a996350434823f3bf7dce22a7e56de366ffbcb80fcf60ebd4eb7b83 في 18 سبتمبر 2026، أُضيف دعم `AGENTS.md` إلى Claude Code 2.1.277. إذا كانت الميزة متاحة في الجلسة ومجلد العمل، ولم يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في أي موضع ضمن سلسلة المجلدات الأعلى منه، فسيقرأ Claude Code ملف `AGENTS.md` تلقائيًا، من دون استيراد يدوي. في السابق، كان ذلك يتم عبر استيراد `@AGENTS.md` في `CLAUDE.md` أو عبر إنشاء رابط رمزي من `CLAUDE.md` إلى `AGENTS.md`؛ لمزيد من التفاصيل، راجع المقالة [عن ملف تعليمات واحد لعدة وكلاء](https://ailoot.ai/blog/ar/agents-md-claude-md-one-instruction-file/). إذا كنت تستخدم Claude Code وأداة أو أداتين أخريين في المستودع نفسه، فإن وضع Project instructions الذي تختاره يحدد ملفات التعليمات التي يقرأها Claude Code. فيما يلي شروط كل واحد من الأوضاع الأربعة وخطوات الانتقال من الإعداد القديم. تتوفر مواد أخرى عن إعداد الأدوات في [وثائق Ailoot](https://ailoot.ai/docs/).
[أدلة Ailoot](https://ailoot.ai/docs/)
## ما الذي تغيّر في الإصدار 2.1.277؟
الخلاصة الرئيسية اعتبارًا من 18 سبتمبر 2026، يقرأ Claude Code ملف `AGENTS.md` تلقائيًا إذا لم يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في أي موضع ضمن سلسلة المجلدات من مجلد العمل إلى المجلدات الأعلى. إذا وُجد أحد هذه الملفات، فلن تكون القراءة التلقائية لـ `AGENTS.md` عبر Project instructions مفعّلة. يظل الاستيراد الصريح لـ `@AGENTS.md` من `CLAUDE.md` صالحًا. تُحمَّل ملفات `~/.claude/CLAUDE.md` على مستوى المستخدم، وملفات `CLAUDE.md` التي تديرها المؤسسة، وملفات `.claude/rules/` بصورة مستقلة عن الاختيار بين ملفات المشروع. يجري تغيير الوضع عبر `/config`. الميزة غير متاحة بعد على Bedrock وVertex وFoundry.
يصف ملف CHANGELOG.md الرسمي لمشروع Claude Code على GitHub الأمر كما يلي:

أُضيف دعم AGENTS.md: في مشروع لا يحتوي على CLAUDE.md، يقرأ Claude Code ملف AGENTS.md بدلًا منه؛ غيّر ذلك ضمن "Project instructions" في /config (غير متاح بعد على Bedrock أو Vertex أو Foundry)

— Anthropic، commit في claude-code CHANGELOG.md، ca02e7d، https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
الترجمة: أُضيف دعم `AGENTS.md`؛ ففي المشروع الذي لا يحتوي على `CLAUDE.md`، يقرأ Claude Code الآن ملف `AGENTS.md` بدلًا منه. ويمكن تغيير ذلك في “Project instructions” ضمن `/config` (الميزة غير متاحة بعد على Bedrock أو Vertex أو Foundry). قبل هذا الإصدار، لم يكن غياب `CLAUDE.md` و`.claude/CLAUDE.md` و`CLAUDE.local.md` في مجلد العمل وما فوقه كافيًا بحد ذاته لتفعيل قراءة `AGENTS.md`. كان يلزم استيراد صريح أو رابط رمزي أو hook يدوي. أما الآن، فيحمّل الوكيل الملف تلقائيًا عندما تكون الميزة متاحة. ## الملفات التي تمنع القراءة التلقائية لـ AGENTS.md
الخلاصة الرئيسية في الوضع الافتراضي، يجري التحقق من `CLAUDE.md` و`.claude/CLAUDE.md` و`CLAUDE.local.md` في مجلد العمل والمجلدات الأعلى منه. لا تمنع ملفات `~/.claude/CLAUDE.md` الشخصية، وملفات `CLAUDE.md` التي تديرها المؤسسة، وملفات `.claude/rules/` قراءة `AGENTS.md`، بل تُحمَّل معه.
إذا كان لديك ملف شخصي `~/.claude/CLAUDE.md` يتضمن إعدادات لأسلوب البرمجة، فلن يمنع ذلك Claude Code من قراءة ملف `AGENTS.md` الخاص بالمشروع. لكن وجود أي ملف `CLAUDE.local.md` في مجلد العمل، حتى لو لم يُضف إلى Git وكان مستخدمًا للملاحظات الشخصية، يمنع القراءة التلقائية لـ `AGENTS.md` في الوضع الافتراضي. يظل الاستيراد الصريح صالحًا؛ ولقراءة الملفين مباشرة، عليك تغيير الوضع. إذا اختير وضع القراءة المباشرة ضمن Project instructions (انظر “أوضاع Project instructions الأربعة: أيّها تختار؟” أدناه) ولم يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو المجلدات الأعلى منه، فسيقرأ Claude Code عند بدء الجلسة كل ملفات `AGENTS.md` و`.claude/AGENTS.md` في تلك المجلدات. في حالة عدم وجود ملفات مانعة، تعرض الوثائق سطرًا مثل هذا في جلسة تفاعلية: ``` no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md ``` يُحمَّل ملف `AGENTS.md` الموجود في مجلد فرعي عندما يفتح Claude ملفًا هناك باستخدام أداة Read. في وضع `claude-md-or-agents-md`، يحدث ذلك فقط إذا لم يكن في ذلك المجلد الفرعي ملف `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` خاص به. أما وضع `claude-md-and-agents-md`، فتصف الوثائق قاعدته العامة: يُقرأ `CLAUDE.md` و`AGENTS.md` معًا، بحيث يُقرأ `CLAUDE.md` أولًا ثم `AGENTS.md` في كل مجلد. لا تُقرأ ملفات `AGENTS.local.md` و`AGENTS.override.md` وأي ملفات داخل مجلد `.agents/` تلقائيًا. تتوفر مواد عن إعداد مساحة عمل وكيل الذكاء الاصطناعي، بما في ذلك ملفات التعليمات التي تتضمن سياق المشروع، في [وثائق Ailoot](https://ailoot.ai/docs/).
[أدلة Ailoot](https://ailoot.ai/docs/)
## أوضاع Project instructions الأربعة: أيّها تختار؟
الخلاصة الرئيسية في قسم Project instructions من الأمر `/config`، توجد أربع قيم: `claude-md-or-agents-md` (الافتراضي—أحد الملفين)، و`claude-md-and-agents-md` (كلاهما معًا)، و`claude-md` (لا يُقرأ تلقائيًا إلا `CLAUDE.md`، حتى لو كان `AGENTS.md` هو الملف الوحيد في المشروع)، و`managed-only` (عند بدء التشغيل، لا يُقرأ إلا `CLAUDE.md` الذي تديره المؤسسة والذاكرة التلقائية، من دون ملفات المشروع أو الملفات الشخصية). يسري التغيير مع الرسالة التالية وفي كل جلسة جديدة.
تشرح وثائق Anthropic سلوك الأوضاع الوارد في الجدول. ويقدّم العمود الأيمن توصيات للاختيار بينها: | القيمة | ما الذي يقرأه Claude Code | متى تستخدمها | |----|----|----| | `claude-md-or-agents-md` | `CLAUDE.md`، أو `AGENTS.md` إذا لم يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو المجلدات الأعلى منه | الوضع الافتراضي إذا كان المستودع يستخدم أحد الملفين فقط ولم توجد ملفات مانعة في المجلدات الأعلى منه | | `claude-md-and-agents-md` | كلا الملفين معًا: في كل مجلد، يُقرأ `CLAUDE.md` أولًا ثم `AGENTS.md` | عندما تحتاج إلى ملف `AGENTS.md` مشترك بين جميع الأدوات وملف `CLAUDE.md` قصير خاص بـ Claude؛ أو عندما تحتاج إلى قراءة `AGENTS.md` مع وجود `CLAUDE.local.md` | | `claude-md` | `CLAUDE.md` فقط؛ تُعطّل القراءة التلقائية لـ `AGENTS.md` عبر Project instructions حتى لو كان `AGENTS.md` هو الملف الوحيد (ويظل الاستيراد الصريح لـ `@AGENTS.md` من `CLAUDE.md` صالحًا) | عندما يكون `AGENTS.md` مكتوبًا لأداة أخرى وقد يربك Claude | | `managed-only` | عند بدء الجلسة، لا يُقرأ إلا `CLAUDE.md` الذي تديره المؤسسة والذاكرة التلقائية؛ وتُستبعد من المجموعة الأولية ملفات `CLAUDE.md` الخاصة بالمشروع والملفات المحلية وملفات المستخدم و`.claude/rules/` وجميع ملفات `AGENTS.md`. ومع ذلك، تُحمَّل ملفات `CLAUDE.md` و`.claude/rules/` في المجلدات الفرعية لاحقًا عندما يفتح Claude ملفًا هناك. يقيّد هذا الوضع المجموعة الأولية، ولا يوفّر عزلًا كاملًا عن ملفات المشروع | للمؤسسات التي تهتم بمجموعة التعليمات التي يبدأ Claude Code بها الجلسة، بصرف النظر عما إذا كان المشروع يحتوي على `CLAUDE.md` أو `AGENTS.md` | يمكنك أيضًا اختيار الوضع من دون الواجهة، عبر `settings.json`: ```json { "pluginConfigs": { "agents-md@builtin": { "options": { "instructionFiles": "claude-md-and-agents-md" } } } } ``` يتجاهل Claude Code هذه القيمة في إعدادات `project` و`local`. ووفقًا لوثائق Anthropic، يمكن تعيينها في `~/.claude/settings.json` أو في ملف `--settings` أو في الإعدادات التي تديرها المؤسسة. إذا سبق لك إعداد ملف تعليمات مشترك لعدة أدوات ذكاء اصطناعي في مستودع واحد، فتشرح [تعليمات الإصدارات السابقة لـ 2.1.277](https://ailoot.ai/blog/ar/agents-md-claude-md-one-instruction-file/) طريقة عمل استيراد `@`. وما زالت هذه الطريقة صالحة اليوم. ## لماذا لا يظهر Project instructions في /config؟
الخلاصة الرئيسية وفقًا لوثائق Anthropic، قد لا يظهر قسم Project instructions للأسباب التالية: - إصدار Claude Code أقدم من 2.1.277. - لا تتلقى الجلسة أعلام الميزات من Anthropic—على سبيل المثال، عند استخدام Bedrock أو موفّر آخر من طرف ثالث أو عند تعطيل القياس عن بُعد. - هذه هي الجلسة الأولى مباشرة بعد التثبيت أو التحديث من إصدار أقدم. إذا كان هذا هو السبب الوحيد، فستظهر الميزة في الجلسة التالية. ولا يُحمَّل `AGENTS.md` نفسه إلا عند استيفاء شروط الوضع المحدد. - تعطيل الملحق المضمّن `agents-md` في `/plugin`.
تحقق أولًا من الإصدار باستخدام الأمر `claude --version`. إذا كان أقدم من 2.1.277، فحدّث Claude Code. وإذا كان الإصدار مناسبًا لكن القسم لا يزال غير ظاهر، فتحقق من الأسباب الأخرى المذكورة أعلاه. وإلى أن تصبح الميزة متاحة، يظل استيراد `@AGENTS.md` في `CLAUDE.md` بديلًا صالحًا. ## ماذا تفعل باستيراد @AGENTS.md القديم؟
الخلاصة الرئيسية يمكنك الإبقاء على استيراد `@AGENTS.md` في `CLAUDE.md` وعلى الرابط الرمزي؛ فلن يُقرأ الملف مرتين في أي وضع. إذا أبقيت على `CLAUDE.md`، فينبغي استبدال طلب نصي مثل “اقرأ AGENTS.md” باستيراد. قبل حذف أي ملف، احفظ كل التعليمات اللازمة وتحقق من شروط الوضع المحدد. إذا انتقلت إلى القراءة المباشرة، فأزل أي hook باسم `SessionStart` كان يطبع محتويات `AGENTS.md` يدويًا؛ وإلا فستدخل نسخة ثانية من الملف إلى السياق. بعد ذلك، تحقق من التحميل في جلسة جديدة؛ إذ تعتمد طريقة التحقق على الإصدار ووجود ملفات مانعة من عدمه.
تعتمد الخطوات التالية على الإعداد القديم. أولًا، تأكد من أن الميزة متاحة في جلستك كما هو موضح في القسم السابق. - **`CLAUDE.md` يتضمن استيراد `@AGENTS.md`.** يمكنك تركه كما هو؛ فلن يقرأ Claude Code الملف مرتين مهما كانت قيمة Project instructions. حذف `CLAUDE.md` اختياري، لأن الاستيراد يمنح Claude بالفعل إمكانية الوصول إلى محتوى `AGENTS.md`. واصل التحقق من التحميل عبر الاستيراد باستخدام `/memory`؛ أما سؤال Claude مباشرة عن محتويات التعليمات فهو تحقق ضعيف فحسب. - **`CLAUDE.md` يطلب بالكلمات قراءة `AGENTS.md`.** هذا الطلب ليس استيرادًا ولا يضمن بمفرده تحميل الملف. استبدل الصياغة باستيراد `@AGENTS.md` إذا أردت الإبقاء على `CLAUDE.md` (مثلًا للأدوات التي تقرأه أيضًا). إذا قررت حذف `CLAUDE.md` بالكامل واخترت وضع `claude-md-or-agents-md`، فتحقق أولًا من أن `CLAUDE.md` لا يتضمن تعليمات فريدة، ومن عدم وجود أي ملف آخر `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو المجلدات الأعلى منه؛ وإلا فسيواصل Claude Code قراءة الملف المتبقي بدلًا من `AGENTS.md`. بعد حذفه، تأكد من اكتمال الانتقال: عند عدم وجود ملفات مانعة، يظهر السطر `AGENTS.md loaded` في جلسة تفاعلية. وإذا بقي `CLAUDE.md` وقُرئ الملفان في وضع `claude-md-and-agents-md`، فتحقق من `/memory` (في الإصدار 2.1.280+). لا يمكن للسؤال المباشر الموجّه إلى Claude التمييز بين التحميل المباشر والاستيراد. - **رابط رمزي من `CLAUDE.md` إلى `AGENTS.md`.** يمكنك الإبقاء عليه؛ فلا يؤدي أي وضع إلى القراءة المكررة. قبل حذف الرابط في وضع `claude-md-or-agents-md`، تحقق من حفظ التعليمات اللازمة ومن عدم وجود ملف آخر `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو المجلدات الأعلى منه. تحقّق من التحميل بالطريقة نفسها: ابحث عن السطر `AGENTS.md loaded` عند بدء الجلسة إذا لم توجد ملفات مانعة، أو استخدم `/memory` (الإصدار 2.1.280+). إذا أبقيت على `CLAUDE.md` في وضع `claude-md-and-agents-md`، فالسؤال المباشر إلى Claude ليس سوى تحقق ضعيف. عدم ظهور خطأ لا يكفي لتأكيد التحميل. - **hook باسم `SessionStart` يطبع محتويات `AGENTS.md` يدويًا.** عند قراءة الملف مباشرة، يضيف هذا الـ hook نسخة ثانية إلى السياق. أثناء تشغيله، لا يؤكد السؤال “ما الذي تتضمنه تعليماتك؟” القراءة المباشرة؛ إذ قد يجيب Claude استنادًا إلى النص الذي أضافه الـ hook. انتقل باتباع الخطوات التالية بالترتيب: 1. تحقق من إتاحة الميزة: الإصدار 2.1.277 أو أحدث، وتلقّي الجلسة أعلام الميزات، وتفعيل الملحق، واكتمال الجلسة الأولى بعد التثبيت أو التحديث. اختر وضعًا للقراءة المباشرة—ليس `claude-md` ولا `managed-only`. وفي الوضع الافتراضي، تحقق أيضًا من عدم وجود ملفات مانعة. 2. أزل الـ hook. 3. أغلق الجلسة وافتح جلسة جديدة. يضيف hook `SessionStart` نصه عند بدء التشغيل، لذا يظل محتواه ضمن سياق الجلسة المفتوحة بالفعل. ولن يؤكد جواب Claude عن محتويات التعليمات في تلك الجلسة القراءة المباشرة. 4. تحقق من التحميل في الجلسة الجديدة. في الإصدار 2.1.280+، يظهر مسار `AGENTS.md` في `/memory`. وفي الإصدارات 2.1.277–2.1.279، إذا لم توجد ملفات مانعة، فابحث عن السطر `AGENTS.md loaded` عند بدء التشغيل؛ إذ تصف الوثائق هذا السطر تحديدًا لحالة عدم العثور على `CLAUDE.md`. إذا أبقيت على `CLAUDE.md` واستخدمت وضع `claude-md-and-agents-md`، فإمكان التحقق محدود: لا يعرض `/memory` ملف `AGENTS.md` في هذه الإصدارات، ولا تصف الوثائق سطر تحميل لهذه الحالة، كما أن إعادة صياغة التعليمات لا تميّز القراءة المباشرة عن استيراد `@` داخل `CLAUDE.md`. في هذه الحالة، حدّث إلى الإصدار 2.1.280+ وتحقق عبر `/memory`. ## كيفية التحقق من تحميل AGENTS.md
الخلاصة الرئيسية بدءًا من الإصدار 2.1.280، يظهر ملف `AGENTS.md` المحمّل عبر Project instructions في `/memory` وفي قائمة ملفات الذاكرة ضمن الأمر `/context`. أما في الإصدارات 2.1.277–2.1.279 فلا يظهر هناك، مع أن الأوامر نفسها تعمل وتعرض ملفات `CLAUDE.md` وملفات الذاكرة الأخرى المحمّلة. في هذه الإصدارات، إذا لم توجد ملفات مانعة، فتحقق من ظهور السطر `AGENTS.md loaded` عند بدء الجلسة. سؤال Claude عن محتويات التعليمات هو تحقق ضعيف فحسب: لا يمكن للجواب التمييز بين القراءة المباشرة واستيراد `@`، وقد يستند إلى نص أضافه hook باسم `SessionStart`. لذلك، من الأفضل طرح السؤال في جلسة جديدة فقط، بعد إزالة هذا الـ hook.
هناك اختلافان آخران عن `CLAUDE.md` العادي: لا تُفعَّل hooks باسم `InstructionsLoaded` لهذا النوع من ملفات `AGENTS.md` (لكنها تعمل لملف `AGENTS.md` المستورد بصيغة `@` من `CLAUDE.md` أو المرتبط برابط رمزي باسم `CLAUDE.md`)؛ والمجلدات المضافة باستخدام الخيار `--add-dir` مع المتغير `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD` لا تحمّل إلا ملف `CLAUDE.md` الخاص بذلك المجلد، ولا تتضمن ملف `AGENTS.md` فيه. إذا كنت بحاجة إلى مراجعة محتويات ملف تعليمات مشروع كبير، فراجع التحليل المنفصل [حول إعداد CLAUDE.md من دون جعله متضخمًا](https://ailoot.ai/blog/ar/claude-md-template/). يتناول بنية التعليمات، بينما تشرح الأقسام أعلاه شروط تحميل `AGENTS.md`. وللاطلاع على ملاحظات العمل بين الجلسات، راجع التحليل عن [الذاكرة الثانية في Claude Code](https://ailoot.ai/blog/ar/claude-code-second-brain/)، الذي يتناول الذاكرة الشخصية المضافة فوق تعليمات المشروع. ## ما الخطوة التالية؟ صدرت الميزة في 18 سبتمبر 2026، ضمن الإصدار 2.1.277. قد توضّح Anthropic تفاصيل الأوضاع في الإصدارات المقبلة؛ لذا، قبل تغيير الإعدادات في مشروع مهم، قارن هذه المقالة بإعدادات `/config` الحالية وسجل التغييرات الرسمي.
### المصادر - [Claude Code، commit في GitHub يتضمن مدخل 2.1.277 في CHANGELOG.md (18 سبتمبر 2026)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3) - [وثائق Claude Code: كيف يتذكر Claude مشروعك - قسم AGENTS.md](https://code.claude.com/docs/en/memory)
[أدلة Ailoot](https://ailoot.ai/docs/)
[انتقل إلى Ailoot](https://ailoot.ai/)
## أسئلة شائعة ### لماذا لا يُحمّل AGENTS.md رغم وجود الملف؟ في الوضع الافتراضي، يمنع وجود CLAUDE.md أو .claude/CLAUDE.md أو CLAUDE.local.md في مجلد العمل أو أحد أسلافه اختيار AGENTS.md تلقائيًا. افحص أيضًا إصدار Claude Code وإتاحة الميزة ووضع Project instructions في /config. ### كيف أتحقق من التحميل المباشر بعد إزالة hook يدوي؟ افتح جلسة جديدة حتى لا يظهر إخراج SessionStart القديم. في الإصدار 2.1.280 فما بعده، افحص /memory أو قائمة Memory files في /context. وفي 2.1.277–2.1.279، ينطبق سطر التحميل عند البدء إذا غابت ملفات CLAUDE.md المانعة. إعادة صياغة Claude للتعليمات وحدها دليل ضعيف. ## Ailoot · الشركة ومحفظة مشاريعها تستند Ailoot إلى خبرة تشغيلية متراكمة وقاعدة عملاء واسعة وخدمة مستقرة ومراقبة مستمرة لمؤشرات الأداء KPI. الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا. توظف Ailoot هذه الخبرة التشغيلية لإتاحة الوصول عبر API إلى قدرات الذكاء الاصطناعي في منتجات العملاء ووكلائهم وتطبيقاتهم وعمليات الأتمتة.