---
title: "استخدم AGENTS.md في Claude Code وCodex"
description: "يقرأ Codex ملف AGENTS.md افتراضيًا. ويقرؤه Claude Code 2.1.277 أو أحدث عندما لا يحتوي مشروعك على CLAUDE.md. وللاحتفاظ بالملفين معًا، ضع @AGENTS.md في ملف CLAUDE.md."
canonical: "https://logbrew.co/ar/guides/agents-md"
last_updated: "2026-11-10"
---

# استخدم AGENTS.md في Claude Code وCodex

يقرأ Codex ملف `AGENTS.md` افتراضيًا. ويقرؤه Claude Code 2.1.277 أو أحدث عندما لا يحتوي مشروعك على `CLAUDE.md`. وللاحتفاظ بالملفين معًا، ضع `@AGENTS.md` في ملف `CLAUDE.md`.

اختُبر في 10 نوفمبر 2026 باستخدام Claude Code 2.1.319 وCodex CLI 0.167.0

بقلم [Furkan Erday](https://github.com/furkanerday). Furkan Erday مؤسس LogBrew، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

Canonical: https://logbrew.co/ar/guides/agents-md

## متى يحمّل كل وكيل `AGENTS.md`

| في مشروعك | Claude Code | Codex |
| --- | --- | --- |
| `AGENTS.md` فقط | حُمّل | حُمّل |
| `AGENTS.md` و`CLAUDE.md` | لم يُحمّل | حُمّل |
| `CLAUDE.md` يستورد `@AGENTS.md` | حُمّل | حُمّل |
| `CLAUDE.md` رابط رمزي إلى `AGENTS.md` | حُمّل | حُمّل |
| `AGENTS.md` و`CLAUDE.local.md` | لم يُحمّل | حُمّل |

قرأنا التعليمات التي أرسلها كل وكيل مع أول طلب.

## جهّز ملفًا واحدًا لكلا الوكيلين

### اكتب AGENTS.md في جذر المشروع

ضع أوامر البناء وأوامر الاختبار وقواعد الكود في ملف واحد. يقرؤه الوكيلان بدءًا من جذر مستودع Git وصولًا إلى مجلدك الحالي.

### حدّث Claude Code

يقرأ Claude Code ملف `AGENTS.md` بنفسه بدءًا من الإصدار 2.1.277. أما الإصدارات الأقدم فتحتاج إلى الاستيراد في الخطوة التالية.

```bash
claude update
```

### استورد AGENTS.md من CLAUDE.md

وجود `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلدك أو في مجلد أعلى منه يمنع Claude Code من قراءة `AGENTS.md`. أضف هذا السطر إلى `CLAUDE.md` لتحميل الملفين.

```bash
@AGENTS.md
```

### أو اربط CLAUDE.md بـ AGENTS.md

إذا كان `CLAUDE.md` لن يحتوي إلا على سطر الاستيراد، فاجعله رابطًا رمزيًا بدلًا من ذلك.

```bash
ln -s AGENTS.md CLAUDE.md
```

### أو حمّل الملفين عبر إعداد

للاحتفاظ بملف `CLAUDE.local.md` مع تحميل `AGENTS.md`، أضف هذا إلى `~/.claude/settings.json`. وفي الجلسة، يضبط خيار Project instructions في `/config` القيمة نفسها.

```bash
{
  "pluginConfigs": {
    "cc-plugin-agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}
```

### تحقّق مما حمّله Codex

شغّل هذا الأمر من المجلد الذي تعمل فيه. تذكر مستندات Codex هذا الأمر ليكرّر Codex التعليمات التي حمّلها.

```bash
codex --ask-for-approval never "Summarize the current instructions."
```

## ما رأيناه في الاختبار

وجّهنا الوكيلين إلى خادم اختبار محلي، وقرأنا التعليمات التي أرسلها كل وكيل مع أول طلب. هكذا يظهر بدقة أي الملفات يحمّلها كل وكيل.

حمّل Claude Code ملف `AGENTS.md` عندما لم يكن في المشروع `CLAUDE.md`، وكتب سجل التصحيح `no CLAUDE.md found; AGENTS.md loaded`. ومع وجود `CLAUDE.md` بجانبه، تجاهل Claude Code ملف `AGENTS.md`. ومع استيراد `@AGENTS.md` أو الرابط الرمزي، ظهر نص `AGENTS.md` مرة واحدة بالضبط.

حمّل إعداد `pluginConfigs` أعلاه الملفين معًا، حتى مع وجود `CLAUDE.local.md` في المشروع.

حمّل Codex أولًا `~/.codex/AGENTS.md`، ثم `AGENTS.md` في الجذر، ثم الملف في المجلد الحالي. وحلّ `AGENTS.override.md` محل `AGENTS.md` في مجلده. وتخطّى Codex ملف `CLAUDE.md` حتى أضفناه إلى `project_doc_fallback_filenames`. وعندما وُجد الملفان معًا، حمّل Codex ملف `AGENTS.md` فقط، حتى مع ضبط الاسم الاحتياطي.

## AGENTS.md أم CLAUDE.md

يقرأ Codex ملف `AGENTS.override.md` أو `AGENTS.md` في كل مجلد، إضافة إلى الملف العام `~/.codex/AGENTS.md`، بحد أقصى 32 KiB إجمالًا افتراضيًا. ولا يقرأ `CLAUDE.md` إلا إذا أضفته إلى `project_doc_fallback_filenames`.

يقرأ Claude Code ملف `CLAUDE.md` أولًا. ولا يقرأ `AGENTS.md` و`.claude/AGENTS.md` إلا عندما لا ينطبق أي ملف `CLAUDE.md` للمشروع. أما ملفك الشخصي `~/.claude/CLAUDE.md` فلا يُحتسب، لذلك يُحمَّل بجانب `AGENTS.md`.

## ماذا تقول بلاغات GitHub

طلب البلاغ #6235، وفيه 409 تعليقات، أن يدعم Claude Code ملف AGENTS.md. وفي 17 أغسطس 2026 أغلقه مهندس من Anthropic مقترحًا الاستيراد والرابط الرمزي المذكورين أعلاه. والآن يقرأ Claude Code الملف بنفسه. ويطلب البلاغ #31005 دعم `.agents/skills/` أيضًا، وما زال مفتوحًا.

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

### هل يقرأ Claude Code ملف AGENTS.md؟

نعم، بدءًا من الإصدار 2.1.277، إذا لم يوجد `CLAUDE.md` أو `.claude/CLAUDE.md` أو `CLAUDE.local.md` في مجلدك أو في مجلد أعلى منه. وتأكدنا من ذلك على 2.1.319.

### هل أستخدم AGENTS.md أم CLAUDE.md؟

استخدم `AGENTS.md` إذا كان أي شخص في فريقك يستخدم Codex أو وكيلًا آخر. واحتفظ بملف `CLAUDE.md` فقط للقواعد الخاصة بـ Claude Code، واستورد منه `@AGENTS.md`.

### هل يمكنني ربط CLAUDE.md بـ AGENTS.md برابط رمزي؟

نعم. في اختبارنا، حمّل Claude Code الملف المرتبط مرة واحدة، تمامًا مثل الاستيراد.

### هل يقرأ Codex ملف CLAUDE.md؟

ليس افتراضيًا. أضف `project_doc_fallback_filenames = ["CLAUDE.md"]` إلى `~/.codex/config.toml`.

## امنح وكيلك أخطاء الإنتاج

اربط خادم MCP من LogBrew، وسيقرأ Claude Code أو Codex الأخطاء والسجلات والتتبّعات للمشاريع التي توافق عليها. ابدأ بخطة مجانية سخية دون بطاقة.

[اربط وكيلك](https://logbrew.co/ar/agents)

## المصادر

- [Claude Code docs, How Claude remembers your project](https://code.claude.com/docs/en/memory#agents-md)
- [Codex docs, Custom instructions with AGENTS.md](https://learn.chatgpt.com/docs/agent-configuration/agents-md)
- [anthropics/claude-code#6235](https://github.com/anthropics/claude-code/issues/6235)
- [anthropics/claude-code#31005](https://github.com/anthropics/claude-code/issues/31005)

## أدلة أخرى لوكلاء البرمجة بالذكاء الاصطناعي

- [أضف خادم MCP إلى Claude Code وCodex](https://logbrew.co/ar/guides/mcp-server-claude-code-codex)
- [أصلح خطأ Claude overloaded 529 وخطأ rate limit 429](https://logbrew.co/ar/guides/claude-overloaded-rate-limit-error)
- [كيف تصلح الأخطاء في Claude Code وCodex وJavaScript في المتصفح](https://logbrew.co/ar/guides)