مشخصات AGENTS.md — راهنمای کامل
پیشنهاد مشترک OpenAI · Google · Cursor · Factory · سازگار با CLAUDE.md · مثال‌های مخزن واقعی · از 2026-10-07، Claude Code 2.1.277+ در پروژه‌های بدون CLAUDE.md، AGENTS.md را می‌خواند
چرا به AGENTS.md نیاز بود
تا اوایل 2025، هر ابزار کدنویسی با هوش مصنوعی قالب حافظه پروژه خودش را داشت — Cursor از .cursorrules استفاده می‌کرد، Claude Code از CLAUDE.md، Codex از instructions.md و Aider از .aider.conf.yml. تغییر ابزار به معنای بازنویسی دانش پروژه شما بود. در اوت 2025، OpenAI، Google، Cursor، Factory و دیگران AGENTS.md را به‌عنوان یک استاندارد چندسازنده‌ای به‌طور مشترک منتشر کردند تا یک فایل پیکربندی با هر عامل سازگار کار کند.
پنج بخش اصلی
AGENTS.md پنج بخش استانداردشده را تعریف می‌کند که با سرفصل‌های H2 در Markdown از هم جدا می‌شوند و با هر ویرایشگر Markdown سازگارند:
Identity: هویت عامل، نقش، زبان پاسخ
Capabilities: اعلام قابلیت‌ها، ترجیحات ابزار، نسخه‌های مدل
Tools: فهرست ابزارهای موجود، دامنه مجوز، پیکربندی API خارجی
Memory: زمینه پروژه، قواعد، واژه‌نامه، تصمیم‌های گذشته
Constraints: رفتارهای ممنوع، قواعد ایمنی، رعایت مقررات
هم‌کارکردی با CLAUDE.md و .cursorrules
AGENTS.md جایگزین نیست — بزرگ‌ترین وجه مشترک میان ابزارهاست. رفتار مستندشده Claude Code (بررسی‌شده در 2026-10-07) به‌طور پیش‌فرض «یا این یا آن» است: وقتی CLAUDE.md وجود ندارد AGENTS.md را می‌خواند و وقتی هر دو وجود دارند، فقط CLAUDE.md را می‌خواند. Cursor از نسخه 1.2 AGENTS.md را به‌صورت بومی می‌خواند. Codex CLI ابتدا AGENTS.md را جست‌وجو می‌کند و در صورت نبودن، به instructions.md برمی‌گردد.
پشتیبانی فعلی زنجیره ابزار
CursorCursor 1.2+: پشتیبانی بومی؛ AGENTS.md بر .cursorrules اولویت دارد
Claude CodeClaude Code: از نسخه 2.1.277 (منتشرشده در 2026-09-18) آن را به‌صورت بومی می‌خواند؛ تغییرات‌نامه می‌گوید «پشتیبانی AGENTS.md اضافه شد: در پروژه‌ای که CLAUDE.md ندارد، Claude Code به‌جای آن AGENTS.md را می‌خواند». پیش‌فرض «یا این یا آن» است: وقتی CLAUDE.md در پوشه کاری یا بالاتر از آن وجود دارد، فقط CLAUDE.md بارگذاری می‌شود؛ برای خواندن هر دو، Project instructions را در /config تنظیم کنید. از نسخه 2.1.281 (2026-09-23) این قابلیت پشت گیت‌وی‌های LLM هم کار می‌کند (بررسی‌شده در 2026-10-07).
Codex CLICodex CLI: از 2026-02 به‌طور پیش‌فرض به دنبال AGENTS.md می‌گردد، در همه ابزارهای OpenAI
AiderAider: پشتیبانی آزمایشی از نسخه 0.65، که با --agents-md فعال می‌شود
پنج ضدالگوی رایج
1) انباشتن همه تصمیم‌های تاریخی در Memory تا جایی که فایل متورم شود و از 10 KB فراتر رود؛ 2) نوشتن Identity به‌صورت متن بازاریابی به‌جای دستورهای اجرایی؛ 3) فهرست‌کردن اصول انتزاعی در Constraints به‌جای رفتارهای ممنوع مشخص؛ 4) فهرست‌های Tools کهنه‌ای که هیچ‌کس آن‌ها را مرتب نکرده است؛ 5) مخلوط‌کردن آن با .gitignore — AGENTS.md باید در کنترل نسخه باشد تا تیم آن را به اشتراک بگذارد.
اجرای Claude Code با AGENTS.md از شبکه‌های محدود
یک پرسش رایج: «من توسعه‌دهنده‌ای در سرزمین اصلی چین هستم و Claude Code در پروژه AGENTS.md من مکرراً دچار تایم‌اوت می‌شود — حالا چه کنم؟». این مسئله‌ای مربوط به دسترسی شبکه است و به خود مشخصات ربطی ندارد. گزینه‌ها: اشتراک مستقیم از Anthropic (در شبکه‌های پایدار خارج از کشور بهترین است)؛ استفاده از سرویس اشتراک API دارای برند مانند QCode.cc (دسترسی بهینه‌شده برای چین + صورت‌حساب یکپارچه + یک کلید برای چهار مدل)؛ یا ساخت گیت‌وی سازمانی خودتان (زمان آماده‌سازی طولانی).
نخستین پروژه AGENTS.md خود را روی QCode.cc اجرا کنید
Claude Fable 5 · gpt-6.1-sol · Codex — یک کلید، چندین ابزار (مدل‌های قابل فراخوانی در /models)
ایجاد حساب کاربری QCode
یک کلید برای Claude، GPT و مدل‌های چینی، با صورت‌حساب به‌ازای توکن — نرخ‌های زنده در /models.