أصبح Claude Code يقرأ AGENTS.md: ما الذي تغيّر في 2.1.277

في 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؛ لمزيد من التفاصيل، راجع المقالة عن ملف تعليمات واحد لعدة وكلاء.

إذا كنت تستخدم Claude Code وأداة أو أداتين أخريين في المستودع نفسه، فإن وضع Project instructions الذي تختاره يحدد ملفات التعليمات التي يقرأها Claude Code. فيما يلي شروط كل واحد من الأوضاع الأربعة وخطوات الانتقال من الإعداد القديم.

تتوفر مواد أخرى عن إعداد الأدوات في وثائق Ailoot.

ما الذي تغيّر في الإصدار 2.1.277؟#

يصف ملف CHANGELOG.md الرسمي لمشروع Claude Code على GitHub الأمر كما يلي:

الترجمة: أُضيف دعم 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/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.

أوضاع Project instructions الأربعة: أيّها تختار؟#

تشرح وثائق Anthropic سلوك الأوضاع الوارد في الجدول. ويقدّم العمود الأيمن توصيات للاختيار بينها:

يمكنك أيضًا اختيار الوضع من دون الواجهة، عبر settings.json:

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": {
        "instructionFiles": "claude-md-and-agents-md"
      }
    }
  }
}

يتجاهل Claude Code هذه القيمة في إعدادات project وlocal. ووفقًا لوثائق Anthropic، يمكن تعيينها في ~/.claude/settings.json أو في ملف --settings أو في الإعدادات التي تديرها المؤسسة.

إذا سبق لك إعداد ملف تعليمات مشترك لعدة أدوات ذكاء اصطناعي في مستودع واحد، فتشرح تعليمات الإصدارات السابقة لـ 2.1.277 طريقة عمل استيراد @. وما زالت هذه الطريقة صالحة اليوم.

لماذا لا يظهر Project instructions في /config؟#

تحقق أولًا من الإصدار باستخدام الأمر claude --version. إذا كان أقدم من 2.1.277، فحدّث Claude Code. وإذا كان الإصدار مناسبًا لكن القسم لا يزال غير ظاهر، فتحقق من الأسباب الأخرى المذكورة أعلاه. وإلى أن تصبح الميزة متاحة، يظل استيراد @AGENTS.md في CLAUDE.md بديلًا صالحًا.

ماذا تفعل باستيراد @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#

هناك اختلافان آخران عن 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 من دون جعله متضخمًا. يتناول بنية التعليمات، بينما تشرح الأقسام أعلاه شروط تحميل AGENTS.md. وللاطلاع على ملاحظات العمل بين الجلسات، راجع التحليل عن الذاكرة الثانية في Claude Code، الذي يتناول الذاكرة الشخصية المضافة فوق تعليمات المشروع.

ما الخطوة التالية؟#

صدرت الميزة في 18 سبتمبر 2026، ضمن الإصدار 2.1.277. قد توضّح Anthropic تفاصيل الأوضاع في الإصدارات المقبلة؛ لذا، قبل تغيير الإعدادات في مشروع مهم، قارن هذه المقالة بإعدادات /config الحالية وسجل التغييرات الرسمي.