AI-translated from English; not yet reviewed by a fluent editor.

# قد يتجاوز Claude Code ملف AGENTS.md عند إيقاف القياس عن بُعد

> يعتمد الدعم الأصلي لملف AGENTS.md في Claude Code على الإصدار وإمكانية الوصول إلى أعلام الميزات ومزوّد الخدمة وأولوية الملفات. أما صفوف القياس عن بُعد في إضافة agents-md المنشورة، فلا تتضمن المسارات أو نصوص الملفات.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

أضاف Claude Code 2.1.277 دعمًا أصليًا لتعليمات المستودعات في `AGENTS.md`. لكن للميزة قيدًا مهمًا: توضح وثائق Anthropic الحالية أن الجلسات التي لا تستطيع جلب أعلام الميزات، ومنها الجلسات التي أُوقف فيها القياس عن بُعد وكثير من إعدادات مزوّدي الخدمات الخارجيين، لا تحمّل إلا `CLAUDE.md`.

تفصل إضافة `agents-md` المنشورة تحميل الملفات عن صفوف القياس عن بُعد الاختيارية. تتضمن تلك الصفوف أعدادًا وخيارات ثابتة، ولا تتضمن المسارات أو نصوص الملفات. ويقع الاعتماد في طبقة أسبق، حيث يحدد علم بعيد ما إذا كان المُحمّل المدمج متاحًا.

## التغيير الأبرز

- **ما الذي تغيّر:** أصبح ملف تعليمات محلي خاضعًا الآن لحدّ طرح ميزة عن بُعد: فإمكانية الوصول إلى أعلام الميزات تحدد ما إذا كان قارئ `AGENTS.md` المدمج في Claude Code متاحًا.
- **لماذا يهم:** قد يحصل مطوّران يعملان على الالتزام البرمجي نفسه على تعليمات مختلفة للمشروع بسبب اختلاف الإصدار أو المزوّد أو إعدادات الخصوصية، ما يصعّب تكرار سلوك الوكيل داخل الفريق.
- **ما الذي ينبغي مراقبته:** يمكن للفرق التي تستخدم عدة مزوّدين أو بيئات مقيّدة أن تتعامل مع تحميل التعليمات بوصفه اعتمادًا وقت التشغيل، وأن تتحقق منه في كل إعداد، وأن تحتفظ باستيراد `CLAUDE.md` بوصفه المسار القابل للنقل.

## ما الذي يثبته الإصدار والتقرير

تنص [ملاحظات الإصدار 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) المؤرخة في 18 سبتمبر على أن Claude Code يقرأ `AGENTS.md` عندما لا يحتوي المشروع على ملف `CLAUDE.md`. كما تستثني الملاحظات Bedrock وVertex وFoundry من ذلك الإصدار.

كما تستثني [وثائق ذاكرة المشروع](https://code.claude.com/docs/en/memory) الحالية الجلسة الأولى بعد تثبيت إصدار داعم أو الترقية إليه، والجلسات التي عُطّلت فيها الإضافة المدمجة.

يصف [تقرير برزمك شيبوفسكي الذي أطلق النقاش](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) اختبارًا تمهيديًا على الإصدار 2.1.280. ويذكر أن `DISABLE_TELEMETRY` و `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` منعا تحميل ملف `AGENTS.md` لديه، بينما نجح استيراد ملف `CLAUDE.md` المجاور. لم تُعِد BIG CHANGE اختبار النموذج المدفوع هذا. وتذكر وثائق Anthropic الآن شروط الإتاحة نفسها بصورة مستقلة.

## إتاحة الميزة وتسجيل القياس عن بُعد أمران منفصلان

تقول [وثائق متغيرات البيئة](https://code.claude.com/docs/en/env-vars) لدى Anthropic إن أي قيمة غير فارغة لـ `DISABLE_TELEMETRY`، بما في ذلك `0` أو `false`، توقف القياس عن بُعد وتعطّل جلب أعلام الميزات. ويمكن أيضًا لكل من `DO_NOT_TRACK`، `DISABLE_GROWTHBOOK` و `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` إيقاف ذلك الجلب. وتُستثنى جلسات مزوّدي الخدمات الخارجيين ما لم يضبط المضيف المضمّن `CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`؛ كما تُستثنى جلسات بوابة تطبيقات Claude.

تنص [ملفات README للإضافة المنشورة](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) على إسقاط استدعاءات القياس عن بُعد المفقودة من دون تغيير أعمال الإضافة الأخرى. ويعرض المستودع [نظرة عامة على الإضافات المدمجة](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) التي تحدد القياس عن بُعد و `agents-md` باعتبارهما إضافتين مدمجتين منفصلتين.

يصف المصدر مُحمّلًا عاملًا؛ أما وثائق المنتج فتوضح ما إذا كانت الجلسة تحصل على ذلك المُحمّل. ولا يلغي التسجيل الاختياري داخل الوحدة شرط الإتاحة الموجود خارجها.

في 23 سبتمبر، جلبت BIG CHANGE ملف `agents-md` README [ووحدة التسجيل](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) من كل من `main` وعلامة الإصدار 2.1.280 الصادرة في 22 سبتمبر؛ وكان كل زوج متطابقًا بايتًا ببايت.

## متى يحمّل Claude Code الملف

في الوضع الافتراضي، ومع إتاحة الإضافة وتمكينها، تُطبّق الأولوية التالية:

| ملفات التعليمات | النتيجة الافتراضية |
| --- | --- |
| `AGENTS.md`، مع عدم وجود ملف تعليمات Claude خاص بالمشروع | `AGENTS.md` يحمّل |
| تعليمات المشروع `CLAUDE.md`، `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلد العمل أو أحد المجلدات الأعلى منه | يتقدّم التحميل المباشر `AGENTS.md` على هذه الملفات |
| إعدادات المستخدم أو الإدارية `CLAUDE.md`، أو `.claude/rules/` | لا تحل هذه الملفات محل `AGENTS.md` |

غيّر تعليمات المشروع في `/config` لتحميل نوعي الملفين. ويجب أن يكون خيار JSON ضمن إعدادات المستخدم، `--settings` أو الإعدادات الإدارية؛ أما ملفات إعدادات المشروع والإعدادات المحلية فيتم تجاهلها.

## البديل هو استيراد صريح واحد

للجلسات التي لا يتوفر فيها الدعم المباشر، توصي Anthropic بوضع `CLAUDE.md` بجانب الملف المشترك، على أن يتضمن:

`@AGENTS.md`

يضمّ الاستيراد الملف فعلًا؛ أما النص الذي يطلب من Claude قراءته فيترك هذا القرار للنموذج.

تحقّق من وجود `claude --version` وتعليمات المشروع في `/config`. في الإصدار 2.1.280، قد يعرض الأمران `/memory` أو `/context` ملف `AGENTS.md` الذي حُمّل مباشرة؛ أما الإصدارات الداعمة الأقدم فلم تعرضه هناك.

## Sources

- [يقرأ Claude Code ملف AGENTS.md فقط عند تشغيل القياس عن بُعد](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — اختبارات برزمك شيبوفسكي التمهيدية المبلغ عنها على الإصدار 2.1.280 والحل البديل الذي استخدمه. لم تُعِد BIG CHANGE اختبار النموذج المدفوع؛ ويفصل المقال بين ملاحظاته وتوثيق المنتج الرسمي وتفسير المصدر.
- [إصدار Claude Code v2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — سجل الإصدار الرسمي الذي أضاف دعم AGENTS.md واستثنى Bedrock وVertex وFoundry من الإتاحة عند الإطلاق.
- [كيف يتذكر Claude مشروعك](https://code.claude.com/docs/en/memory) — الوثائق الرسمية الحالية بشأن الحد الأدنى للإصدار وأولوية الملفات وأنماط تعليمات المشروع وشروط الجلسات غير المتاحة والتشخيص وخيار استيراد CLAUDE.md.
- [متغيرات بيئة Claude Code](https://code.claude.com/docs/en/env-vars) — توثيق رسمي حالي يوضح أن إيقاف القياس عن بُعد يعطّل أيضًا جلب أعلام الميزات، ما يجعل تحميل AGENTS.md مباشرة غير متاح، ويسرد الجلسات الأخرى المتأثرة.
- [المصدر المدمج لإضافة agents-md وسلوكها، Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — وصف المصدر المنشور لأنماط ملفات التعليمات وأولويتها وصفوف القياس عن بُعد الاختيارية. ويذكر أن الصفوف تتضمن أعدادًا وخيارات ثابتة، لا مسارات أو نصوص ملفات.
- [الإضافات المدمجة في Claude Code، v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — نظرة عامة منشورة تؤكد أن القياس عن بُعد وagents-md إضافتان مدمجتان منفصلتان، وأن المصدر الموسوم يُشحن داخل Claude Code.
- [وحدة تسجيل إضافة agents-md، Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — مصدر التسجيل المنشور الذي فُحص إلى جانب ملف README. وعند التحقق في 23 سبتمبر، تطابقت بايتاته مع الملف المقابل في الفرع main.