Claude Code endi AGENTS.md faylini o‘qiydi: 2.1.277 versiyasida nimalar o‘zgardi

2026-yil 18-sentabrda Claude Code 2.1.277 versiyasida AGENTS.md uchun qo‘llab-quvvatlash qo‘shildi. Agar bu funksiya sessiyada va ishchi katalogda mavjud bo‘lsa, kataloglar zanjirida yuqorida hech qayerda CLAUDE.md, .claude/CLAUDE.md yoki CLAUDE.local.md bo‘lmasa, Claude Code AGENTS.md faylini qo‘lda import qilmasdan standart ravishda o‘qiydi. Avval bu CLAUDE.md ichidagi @AGENTS.md importi yoki AGENTS.md fayliga ko‘rsatuvchi CLAUDE.md ramziy havolasi orqali bajarilardi — batafsil ma’lumot uchun bir nechta agent uchun bitta ko‘rsatmalar fayli haqidagi maqolaga qarang.

Agar bir repozitoriyda Claude Code va yana bitta yoki ikkita vositadan foydalansangiz, tanlagan Project instructions rejimingiz Claude Code qaysi ko‘rsatmalar fayllarini o‘qishini belgilaydi. Quyida to‘rtta rejimning har biri uchun shartlar va eski sozlamadan o‘tish bosqichlari keltirilgan.

Vositalarni sozlash bo‘yicha qo‘shimcha materiallar Ailoot hujjatlarida mavjud.

2.1.277 versiyasida nimalar o‘zgardi?#

GitHub’dagi rasmiy Claude Code loyihasining CHANGELOG.md faylida bu quyidagicha bayon qilingan:

Tarjimasi: AGENTS.md faylini qo‘llab-quvvatlash qo‘shildi — CLAUDE.md bo‘lmagan loyihada Claude Code endi uning o‘rniga AGENTS.md faylini o‘qiydi; buni /config ichidagi “Project instructions” bo‘limida almashtirish mumkin (Bedrock, Vertex yoki Foundry’da hali mavjud emas).

Bu versiyadan oldin ishchi katalogda va uning yuqorisida CLAUDE.md, .claude/CLAUDE.md hamda CLAUDE.local.md yo‘qligining o‘zi AGENTS.md faylini o‘qishni yoqmasdi. Aniq import, ramziy havola yoki qo‘lda ishlaydigan hook kerak bo‘lardi. Endi funksiya mavjud bo‘lsa, agent faylni avtomatik ravishda topadi.

Qaysi fayllar AGENTS.md faylining avtomatik o‘qilishiga to‘sqinlik qiladi#

Agar kodlash uslubi sozlamalari bo‘lgan shaxsiy ~/.claude/CLAUDE.md faylingiz bo‘lsa, u Claude Code’ning loyiha AGENTS.md faylini o‘qishiga xalaqit bermaydi. Ammo ishchi katalogdagi istalgan CLAUDE.local.md — hatto Git’ga qo‘shilmagan va shaxsiy qaydlar uchun ishlatiladigan fayl ham — standart rejimda AGENTS.md faylining avtomatik o‘qilishini to‘sadi. Aniq import ishlashda davom etadi; ikkala faylni ham bevosita o‘qish uchun rejimni almashtirish kerak.

Agar Project instructions bo‘limida bevosita o‘qish rejimi tanlangan bo‘lsa (quyidagi “4 ta Project instructions rejimi — qaysi birini tanlash kerak” bo‘limiga qarang) va ishchi katalogda yoki uning yuqorisida CLAUDE.md, .claude/CLAUDE.md yoxud CLAUDE.local.md bo‘lmasa, Claude Code sessiya boshlanganda shu kataloglardagi barcha AGENTS.md va .claude/AGENTS.md fayllarini o‘qiydi. To‘sqinlik qiluvchi fayllar bo‘lmagan holat uchun hujjat interaktiv sessiyada shunga o‘xshash qatorni ko‘rsatadi:

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

Quyi katalogdagi AGENTS.md fayli Claude u yerdagi faylni Read vositasi yordamida ochganda yuklanadi. claude-md-or-agents-md rejimida bu faqat o‘sha quyi katalogning o‘zida CLAUDE.md, .claude/CLAUDE.md yoki CLAUDE.local.md bo‘lmagan taqdirdagina sodir bo‘ladi. claude-md-and-agents-md rejimi uchun hujjat umumiy qoidani bayon qiladi: CLAUDE.md va AGENTS.md birgalikda o‘qiladi; har bir katalogda avval CLAUDE.md, so‘ng AGENTS.md o‘qiladi. AGENTS.local.md, AGENTS.override.md va .agents/ katalogidagi hech narsa avtomatik o‘qilmaydi.

Loyiha kontekstini o‘z ichiga olgan ko‘rsatmalar fayllari bilan birga AI agent ish maydonini sozlash materiallari Ailoot hujjatlarida mavjud.

4 ta Project instructions rejimi — qaysi birini tanlash kerak#

Jadvaldagi rejimlarning xatti-harakati Anthropic hujjatlarida bayon qilingan. O‘ng ustunda rejimni tanlash bo‘yicha tavsiyalar berilgan:

Rejimni interfeyssiz, settings.json orqali ham tanlash mumkin:

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

Claude Code bu qiymatni project va local sozlamalarida e’tiborsiz qoldiradi. Anthropic hujjatlariga ko‘ra, uni ~/.claude/settings.json faylida, --settings faylida yoki tashkilot tomonidan boshqariladigan sozlamalarda belgilash mumkin.

Agar bitta repozitoriyda bir nechta AI vositasi uchun umumiy ko‘rsatmalar faylini allaqachon sozlagan bo‘lsangiz, 2.1.277 dan oldingi versiyalar uchun ko‘rsatmalar @ importi qanday ishlashini tushuntiradi. Bu usul bugun ham ishlaydi.

Nega /config ichida Project instructions ko‘rinmaydi#

Avval claude --version buyrug‘i bilan versiyani tekshiring. Agar u 2.1.277 dan eski bo‘lsa, Claude Code’ni yangilang. Versiya mos bo‘lsa-yu, bo‘lim hali ham ko‘rinmasa, yuqorida sanalgan boshqa sabablarni tekshiring. Funksiya mavjud bo‘lmagan paytda CLAUDE.md ichidagi @AGENTS.md importi ishlaydigan muqobil usul bo‘lib qoladi.

Eski @AGENTS.md importi bilan nima qilish kerak#

Keyingi qadamlar avvalgi sozlamaga bog‘liq. Dastlab, avvalgi bo‘limda aytilganidek, funksiya sessiyangizda mavjudligini tekshiring.

• @AGENTS.md importi mavjud CLAUDE.md. Uni o‘z holicha qoldirishingiz mumkin — Claude Code Project instructions qiymati qanday bo‘lishidan qat’i nazar, faylni ikki marta o‘qimaydi. CLAUDE.md faylini o‘chirish ixtiyoriy: import allaqachon Claude’ga AGENTS.md mazmunidan foydalanish imkonini beradi. Import orqali yuklanishni /memory yordamida tekshirishda davom eting; ko‘rsatmalar mazmuni haqida Claude’ga bevosita savol berish kuchsiz tekshiruv hisoblanadi.
• CLAUDE.md ichida AGENTS.md faylini o‘qish so‘z bilan so‘ralgan. Bunday so‘rov import emas va o‘z-o‘zidan fayl yuklanishini kafolatlamaydi. Agar CLAUDE.md faylini saqlamoqchi bo‘lsangiz (masalan, uni o‘qiydigan boshqa vositalar uchun), matnni @AGENTS.md importi bilan almashtiring. Agar CLAUDE.md faylini butunlay o‘chirishga va claude-md-or-agents-md rejimini tanlashga qaror qilsangiz, avval CLAUDE.md ichida yagona ko‘rsatmalar yo‘qligini va ishchi katalogda yoki uning yuqorisida boshqa CLAUDE.md, .claude/CLAUDE.md yoki CLAUDE.local.md mavjud emasligini tekshiring; aks holda Claude Code AGENTS.md o‘rniga qolgan faylni o‘qishda davom etadi. O‘chirganingizdan so‘ng o‘tish amalga oshganini tekshiring: to‘sqinlik qiluvchi fayllar qolmasa, interaktiv sessiyada AGENTS.md loaded qatori ko‘rinadi. Agar CLAUDE.md qolsa va claude-md-and-agents-md rejimida ikkala fayl o‘qilsa, /memory orqali tekshiring (2.1.280+ versiyada). Claude’ga bevosita savol berish bevosita yuklashni importdan farqlay olmaydi.
• AGENTS.md fayliga ramziy havola bo‘lgan CLAUDE.md. Uni qoldirishingiz mumkin: hech bir rejimda takroriy o‘qish bo‘lmaydi. claude-md-or-agents-md rejimida havolani o‘chirishdan oldin kerakli ko‘rsatmalar saqlanganini va ishchi katalogda yoki uning yuqorisida boshqa CLAUDE.md, .claude/CLAUDE.md yoki CLAUDE.local.md yo‘qligini tekshiring. Yuklanishni xuddi shu usulda tekshiring: to‘sqinlik qiluvchi fayllar bo‘lmaganda sessiya boshidagi AGENTS.md loaded qatori yoki /memory (2.1.280+). Agar CLAUDE.md qolsa va claude-md-and-agents-md rejimi yoqilgan bo‘lsa, Claude’ga bevosita savol berish kuchsiz tekshiruv hisoblanadi. Xato ko‘rinmasligi yuklanganini tasdiqlash uchun yetarli emas.
• AGENTS.md mazmunini qo‘lda chiqaradigan SessionStart hook’i. Fayl bevosita o‘qilganda, bunday hook kontekstga ikkinchi nusxani qo‘shadi. Hook ishlayotgan paytda “ko‘rsatmalaringizda nima bor?” degan savol bevosita yuklanganini tasdiqlamaydi: Claude hook qo‘shgan matnga asoslanib javob berishi mumkin. O‘tishni quyidagi tartibda bajaring:
  1. Funksiya mavjudligini tekshiring: 2.1.277 yoki undan yuqori versiya, sessiya funksiya bayroqlarini oladi, plagin yoqilgan va o‘rnatish yoki yangilashdan keyingi birinchi sessiya tugagan bo‘lishi kerak. Bevosita o‘qish rejimini tanlang — claude-md ham, managed-only ham emas. Standart rejim uchun to‘sqinlik qiluvchi fayllar yo‘qligini ham tekshiring.
  2. Hook’ni olib tashlang.
  3. Sessiyani yoping va yangisini oching. SessionStart hook’i ishga tushishda matn qo‘shadi, shuning uchun uning mazmuni allaqachon ochiq sessiya kontekstida qoladi. Bunday sessiyada Claude’ning ko‘rsatmalar mazmuni haqidagi javobi bevosita yuklanganini tasdiqlamaydi.
  4. Yangi sessiyada yuklanishni tekshiring. 2.1.280+ versiyada AGENTS.md faylining yo‘li /memory ichida ko‘rinadi. 2.1.277–2.1.279 versiyalarida to‘sqinlik qiluvchi fayllar bo‘lmasa, ishga tushishda AGENTS.md loaded qatorini qidiring: hujjat bu qatorni aynan CLAUDE.md topilmagan holat uchun bayon qiladi. Agar CLAUDE.md faylini saqlab, claude-md-and-agents-md rejimidan foydalansangiz, tekshirish imkoniyati cheklangan: bu versiyalarda /memory AGENTS.md faylini ko‘rsatmaydi, hujjatda bu holat uchun yuklanish qatori bayon qilinmagan va ko‘rsatmalarni qayta ifodalash CLAUDE.md ichidagi bevosita o‘qishni @ importidan farqlay olmaydi. Bunday holatda 2.1.280+ versiyaga yangilang va /memory orqali tekshiring.

AGENTS.md yuklanganini qanday tekshirish kerak#

Oddiy CLAUDE.md bilan solishtirganda yana ikki farq bor: InstructionsLoaded hook’lari bunday AGENTS.md uchun ishga tushmaydi (CLAUDE.md dan @ sintaksisi orqali import qilingan yoki CLAUDE.md ramziy havolasi bilan bog‘langan AGENTS.md uchun esa ishlaydi); --add-dir bayrog‘i va CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD o‘zgaruvchisi bilan qo‘shilgan kataloglar faqat o‘sha katalogning CLAUDE.md faylini yuklaydi — uning AGENTS.md fayli kiritilmaydi.

Agar katta loyiha ko‘rsatmalar faylining mazmunini ko‘rib chiqishingiz kerak bo‘lsa, CLAUDE.md faylini hajmini oshirmasdan sozlash haqidagi alohida tahlilga qarang. Unda ko‘rsatmalar tuzilishi yoritiladi, AGENTS.md yuklanish shartlari esa yuqorida bayon qilingan. Sessiyalar orasidagi ish qaydlari uchun Claude Code’dagi ikkinchi miya haqidagi tahlilga qarang — unda loyiha ko‘rsatmalariga qo‘shimcha ravishda qatlamlangan shaxsiy xotira haqida so‘z yuritiladi.

Keyin nima qilish kerak#

Funksiya 2026-yil 18-sentabrda 2.1.277 versiyasida chiqarildi. Anthropic kelgusi versiyalarda rejimlar tafsilotlarini aniqlashtirishi mumkin, shuning uchun muhim loyihadagi sozlamalarni o‘zgartirishdan oldin ushbu maqolani joriy /config holati va rasmiy o‘zgarishlar jurnaliga solishtiring.