קלוד קוד קורא עכשיו AGENTS.md — ולמה אצלכם הוא כנראה לא

גרסה 2.1.277 של קלוד קוד, שיצאה ב-18 בספטמבר, הוסיפה שורה אחת שיומן השינויים מנסח בקצרה: בפרויקט שאין בו CLAUDE.md, קלוד קוד קורא AGENTS.md במקומו. ב-Hacker News הפריט אסף יותר מ-600 נקודות ביממה, וזה הגיוני: AGENTS.md הוא הקובץ שכל שאר סוכני הקוד כבר קוראים.

אבל התיעוד מדויק הרבה יותר מהשורה הזאת, ויש בו ארבעה מצבים שבהם הקובץ פשוט אינו נטען — בלי שגיאה ובלי אזהרה.

הכלל: קלוד קוד קורא AGENTS.md רק כשאין שום CLAUDE.md בתיקיית העבודה או מעליה. ברגע שיש שם קובץ אחד כזה, הוא נקרא ו-AGENTS.md נשאר מחוץ לתמונה.

מה נקרא, ומתי

שלושת המצבים, לפי התיעוד:

יש AGENTS.md ואין CLAUDE.md: נקרא ה-AGENTS.md שלכם
יש שניהם: נקראים קבצי ה-CLAUDE.md בלבד
CLAUDE.md שכבר מצרף את AGENTS.md בשורת ‎@path‎: נקרא ה-CLAUDE.md, ו-AGENTS.md נכנס דרך הצירוף

השאלה המעניינת היא אילו קבצים בכלל נחשבים לצורך הבדיקה, וכאן יושבת המלכודת:

נחשבים, ולכן מבטלים את AGENTS.md: קובץ CLAUDE.md, קובץ ‎.claude/CLAUDE.md‎ או קובץ CLAUDE.local.md בתיקיית העבודה או בכל תיקייה מעליה
אינם נחשבים, וממשיכים להיטען לצד AGENTS.md: ה-CLAUDE.md האישי שלכם ב-‎~/.claude/‎, ה-CLAUDE.md המנוהל של הארגון, וקבצי ‎.claude/rules/‎

שימו לב ל-CLAUDE.local.md. זה בדיוק הקובץ שאנשים מוסיפים כדי להחזיק הערות פרטיות שלא נכנסות ל-git, והוא נחשב. כלומר מי שמוסיף אותו לפרויקט שנשען על AGENTS.md מפסיק לקרוא את AGENTS.md — אצלו בלבד, בלי ששאר הצוות ירגיש משהו. התיעוד מציין את המקרה הזה במפורש, והפתרון אינו למחוק את הקובץ אלא לבקש ששניהם ייקראו.

ארבע סיבות שהקובץ לא נטען

גרסה מוקדמת מ-2.1.277. במקרה הזה גם ההגדרה עצמה לא תופיע ב-‎/config‎
סשן שאינו מושך דגלי פיצ’רים מאנתרופיק. זו הסיבה הנפוצה ביותר בארגונים: ספק צד-שלישי כמו Amazon Bedrock, פלטפורמת הסוכנים של גוגל או Microsoft Foundry, סשן של שער Claude apps, או אחד מארבעה משתני סביבה שמכבים את המשיכה: ‎DISABLE_TELEMETRY‎, ‎DO_NOT_TRACK‎, ‎DISABLE_GROWTHBOOK‎ ו-‎CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC‎
הסשן הראשון אחרי התקנה או שדרוג. הדגלים נמשכים במהלכו, כך שהקובץ נטען מהסשן הבא והלאה. שווה לדעת לפני שמתחילים לחפש באג
‎disableAllHooks‎ או ‎allowManagedHooksOnly‎ מוגדרים, או שהתוסף המובנה ‎agents-md‎ כובה ב-‎/plugin‎

נקודה אחת שקל ליפול בה: ‎CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC‎ מכבה את התעבורה גם כשמציבים לו ‎0‎ או ‎false‎, שלא כמו רוב משתני הכן-ולא. כדי להחזיר אותו צריך לבטל את המשתנה, לא לאפס אותו.

בכל אחד מהמצבים האלה קלוד קוד קורא קבצי CLAUDE.md בלבד, והדרך לתת לו את ההנחיות שלכם היא לצרף את AGENTS.md מתוך CLAUDE.md בשורת ‎@path‎.

איך יודעים שזה בכלל עבד

בסשן אינטראקטיבי מופיעה בשיחה שורה בנוסח הזה:

no CLAUDE.md found; AGENTS.md loaded: /home/you/repo/AGENTS.md

וזו כמעט הדרך היחידה לדעת. AGENTS.md שנקרא דרך ההגדרה אינו מופיע ב-‎/memory‎ ואינו מופיע ברשימת קבצי הזיכרון ב-‎/context‎ — שם רואים רק קבצי CLAUDE.md. מי שפספס את השורה יכול פשוט לשאול את קלוד מה ההנחיות שהוא קיבל לפרויקט.

איך משנים את ההתנהגות

בתוך סשן: ‎/config‎, ואז השדה Project instructions. ארבעה ערכים:

‎claude-md-or-agents-md‎ — ברירת המחדל, בדיוק ההתנהגות שתוארה למעלה
‎claude-md-and-agents-md‎ — שניהם. בכל תיקייה נטענים קודם קבצי ה-CLAUDE.md ואחריהם ה-AGENTS.md, וקובץ שכבר נטען דרך צירוף או קישור סימבולי אינו נקרא פעמיים. זה הערך שפותר את מלכודת ה-CLAUDE.local.md
‎claude-md‎ — רק קבצי CLAUDE.md
‎managed-only‎ — רק ההנחיות המנוהלות של הארגון והזיכרון האוטומטי

אפשר לקבוע את זה גם בקובץ הגדרות, תחת התוסף המובנה:

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

הערך נקרא מ-‎~/.claude/settings.json‎, מקובץ ‎--settings‎ או מהגדרות מנוהלות — ומהגדרות פרויקט או הגדרות מקומיות הוא נעלם בשקט. השינוי תופס מההודעה הבאה ובכל סשן חדש.

שלושה הבדלים שכדאי להכיר

hooks מסוג ‎InstructionsLoaded‎ אינם רצים על AGENTS.md שנקרא דרך ההגדרה. על קובץ שמצורף מתוך CLAUDE.md הם רצים כרגיל, וזו עוד סיבה להעדיף את הצירוף בסביבה שנשענת על hooks
קבצים שאינם נקראים בכלל: AGENTS.local.md, AGENTS.override.md, וכל מה שיושב בתיקיית ‎.agents/‎
תיקיות שמוסיפים עם ‎--add-dir‎: ה-CLAUDE.md שלהן נטען כשמוגדר ‎CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD‎, אבל ה-AGENTS.md שלהן לא נטען גם אז

שורה תחתונה

מי שכבר עובד עם CLAUDE.md לא צריך לעשות כלום — אצלו שום דבר לא זז. מי שמגיע מסוכן אחר עם AGENTS.md מוכן מקבל פרויקט שעובד בלי להוסיף ולו קובץ אחד, ובתנאי שהסשן שלו מושך דגלי פיצ’רים. ומי שרוצה את שני הקבצים יחד צריך לבחור בזה במפורש, כי זו אינה ברירת המחדל ואין שום סימן שמודיע על כך.

מה בכלל כותבים בקובץ ההנחיות, ואיך לא מנפחים אותו: המדריך ל-CLAUDE.md. מתי אילוץ שייך לכלל ממוקד-נתיב ולא לקובץ הראשי: כלל ממוקד-נתיב. ואיפה עובר הגבול בין קלוד קוד לקודקס: ההשוואה המלאה.