Claude Code קורא AGENTS.md רק כשהטלמטריה דלוקה

Claude Code 2.1.277 הוסיף תמיכה ב-AGENTS.md: בפרויקט בלי CLAUDE.md הכלי אמור לקרוא את קובץ ההוראות החלופי. חקירה שפורסמה ב-blog.szypowi.cz מראה שהתמיכה הזו תלויה בשקט בטלמטריה דלוקה ובתעבורה לא-חיונית אחרת.

הטוען ממתין לדגל מרוחק

הטוען של AGENTS.md מגיע כתוסף מובנה בשם agents-md. בגרסה 2.1.280 הרישום שלו קובע isOnByDefault כ-false, וקובע זמינות דרך דגל תכונה מרוחק בשם tengu_agents_md_mod, עם false כברירת מחדל. כשהדגל לא נטען, התוסף אינו זמין והקובץ המקומי לא נקרא כלל — אף שקריאת קובץ markdown מתיקיית העבודה אינה דורשת רשת. המחבר איתר את הסיבה ב-issue #95690 ב-GitHub והוסיף מדידות משלו.

בדיקות קנרית עם טלמטריה כבויה

הבדיקה הייתה מינימלית: תיקייה ריקה ובה רק AGENTS.md עם מילת סימן, ובקשה מה-CLI למסור את המילה בלי לקרוא קבצים. כל תצורה הורצה פעמיים, כי ההפעלה הראשונה רק מושכת את הדגל.

עם CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 או DISABLE_TELEMETRY=1 הקובץ לא נטען; היה צריך לנקות את שני המשתנים. הצבה של 0 לא עוזרת, כי כל ערך נחשב. בלוק env ב-.claude/settings.json של הפרויקט לא משפיע, כך שאין דרך להפעיל את התכונה לריפו בודד. עקיפה ברמת הסשן דרך --settings עובדת, מהסשן השני והלאה. באף מקרה לא נדפסת אזהרה. גם שערים חיצוניים, Bedrock ו-Vertex נתקלים באותה בעיה, כי שם הדגל לא יכול להתקבל כ-true.

העקיפה

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

למה השקט הוא הבעיה

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