Claude Code енді AGENTS.md файлын оқиды: 2.1.277 нұсқасында не өзгерді

2026 жылғы 18 қыркүйекте Claude Code 2.1.277 нұсқасына AGENTS.md қолдауы қосылды. Егер бұл мүмкіндік сеанста және жұмыс каталогында қолжетімді болса, әрі одан жоғары каталогтар тізбегінің ешбір жерінде CLAUDE.md, .claude/CLAUDE.md немесе CLAUDE.local.md болмаса, Claude Code AGENTS.md файлын әдепкі бойынша, қолмен импорттаусыз оқиды. Бұрын бұл CLAUDE.md ішіндегі @AGENTS.md импорты немесе AGENTS.md файлына жасалған CLAUDE.md символдық сілтемесі арқылы іске асырылатын — толығырақ бірнеше агентке арналған бір нұсқаулар файлы туралы мақаланы қараңыз.

Егер Claude Code пен сол репозиторийде тағы бір-екі құралды пайдалансаңыз, таңдалған Project instructions режимі Claude Code қай нұсқаулар файлдарын оқитынын анықтайды. Төменде төрт режимнің әрқайсысына қойылатын шарттар және ескі баптаудан көшу қадамдары берілген.

Құралдарды баптау жөніндегі қосымша материалдар Ailoot құжаттамасында бар.

2.1.277 нұсқасында не өзгерді?#

GitHub-тағы Claude Code жобасының ресми CHANGELOG.md файнында бұл былай жазылған:

Аудармасы: AGENTS.md қолдауы қосылды — CLAUDE.md жоқ жобада Claude Code енді оның орнына AGENTS.md файлын оқиды; мұны /config ішіндегі “Project instructions” бөлімінен ауыстыруға болады (әзірге Bedrock, Vertex немесе Foundry жүйелерінде қолжетімді емес).

Бұл нұсқаға дейін жұмыс каталогында және оның жоғары жағында CLAUDE.md, .claude/CLAUDE.md және CLAUDE.local.md болмауының өзі AGENTS.md файлын оқуға жеткіліксіз еді. Айқын импорт, символдық сілтеме немесе қолмен іске қосылатын hook қажет болатын. Енді мүмкіндік қолжетімді болса, агент файлды автоматты түрде табады.

Қандай файлдар AGENTS.md файлын автоматты оқуға кедергі жасайды#

Егер сізде кодтау мәнерінің баптаулары бар жеке ~/.claude/CLAUDE.md файлы болса, ол Claude Code-тың жоба ішіндегі AGENTS.md файлын оқуына кедергі болмайды. Бірақ жұмыс каталогындағы кез келген CLAUDE.local.md — тіпті Git-ке қосылмаған және жеке жазбаларға арналған файл да — әдепкі режимде AGENTS.md файлының автоматты оқылуына кедергі жасайды. Айқын импорт жұмыс істей береді; екі файлды да тікелей оқу үшін режимді ауыстыру қажет.

Project instructions ішінен тікелей оқу режимі таңдалса (төмендегі “4 Project instructions режимі — қайсысын таңдау керек” бөлімін қараңыз) және жұмыс каталогында не оның жоғары жағында CLAUDE.md, .claude/CLAUDE.md немесе CLAUDE.local.md болмаса, Claude Code сеанс басталғанда сол каталогтардағы әрбір AGENTS.md және .claude/AGENTS.md файлын оқиды. Кедергі жасайтын файлдар жоқ жағдай үшін құжаттамада интерактивті сеанста мынаған ұқсас жол көрсетілген:

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

Claude қосалқы каталогтағы файлды Read құралымен ашқанда, сол каталогтағы AGENTS.md файлы жүктеледі. claude-md-or-agents-md режимінде бұл тек қосалқы каталогтың өзінде CLAUDE.md, .claude/CLAUDE.md немесе CLAUDE.local.md болмаған жағдайда орындалады. claude-md-and-agents-md режимі үшін құжаттамада жалпы ереже берілген: әр каталогта алдымен CLAUDE.md, содан кейін AGENTS.md оқылады. AGENTS.local.md, AGENTS.override.md және .agents/ каталогының ішіндегілер автоматты түрде оқылмайды.

Жоба контексті бар нұсқаулар файлдарын қоса алғанда, AI агентінің жұмыс кеңістігін баптау жөніндегі материалдар Ailoot құжаттамасында бар.

4 Project instructions режимі — қайсысын таңдау керек#

Кестедегі режимдердің әрекеті Anthropic құжаттамасында сипатталған. Оң жақ бағанда режимді таңдау жөніндегі ұсыныстар берілген:

Режимді интерфейсті қолданбай, settings.json арқылы да таңдауға болады:

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

Claude Code project және local баптауларындағы бұл мәнді елемейді. Anthropic құжаттамасына сәйкес, оны ~/.claude/settings.json файлына, --settings файлына немесе ұйым басқаратын баптауларға орнатуға болады.

Егер бір репозиторийдегі бірнеше AI құралына ортақ нұсқаулар файлын әлдеқашан баптаған болсаңыз, 2.1.277 нұсқасына дейінгі нұсқауларда @ импортының қалай жұмыс істейтіні түсіндіріледі. Бұл әдіс әлі де жұмыс істейді.

Неліктен /config ішінде Project instructions жоқ#

Алдымен claude --version пәрменімен нұсқаны тексеріңіз. Егер ол 2.1.277-ден төмен болса, Claude Code бағдарламасын жаңартыңыз. Нұсқасы сәйкес болса, бірақ бөлім әлі де көрінбесе, жоғарыда аталған басқа себептерді тексеріңіз. Мүмкіндік қолжетімсіз болған кезде CLAUDE.md ішіне @AGENTS.md импортын қосу әлі де жұмыс істейтін балама жол болып табылады.

Ескі @AGENTS.md импортын не істеу керек#

Келесі қадамдар бұрынғы баптауға байланысты. Алдымен алдыңғы бөлімде сипатталғандай, мүмкіндік сеансыңызда қолжетімді екеніне көз жеткізіңіз.

• @AGENTS.md импорты бар CLAUDE.md. Оны сол күйінде қалдыруға болады — Claude Code кез келген Project instructions мәнінде файлды екі рет оқымайды. CLAUDE.md файлын жою міндетті емес: импорт Claude-қа AGENTS.md мазмұнын онсыз да қолжетімді етеді. Импорт арқылы жүктелуін /memory пәрменімен тексеруді жалғастырыңыз; Claude-тан нұсқаулар мазмұнын тікелей сұрау — әлсіз тексеру ғана.
• AGENTS.md файлын сөзбен оқуды сұрайтын CLAUDE.md. Мұндай өтініш импорт болып саналмайды және файлдың жүктелуіне өздігінен кепілдік бермейді. Егер CLAUDE.md файлын (мысалы, оны оқитын басқа құралдар үшін) сақтағыңыз келсе, мәтінді @AGENTS.md импортымен алмастырыңыз. Егер CLAUDE.md файлын толығымен жойып, claude-md-or-agents-md режимін таңдасаңыз, алдымен CLAUDE.md ішінде бірегей нұсқаулар жоқ екенін және жұмыс каталогында не оның жоғары жағында басқа CLAUDE.md, .claude/CLAUDE.md немесе CLAUDE.local.md жоқ екенін тексеріңіз; әйтпесе Claude Code AGENTS.md орнына қалған файлды оқи береді. Оны жойғаннан кейін ауысу аяқталғанына көз жеткізіңіз: кедергі жасайтын файлдар қалмаса, интерактивті сеанста AGENTS.md loaded жолы пайда болады. Егер CLAUDE.md қалса және екі файл да claude-md-and-agents-md режимінде оқылса, /memory пәрменімен тексеріңіз (2.1.280+ нұсқасында). Claude-қа тікелей сұрақ қою тікелей жүктелуді импорттан ажыратпайды.
• AGENTS.md файлына жасалған CLAUDE.md символдық сілтемесі. Оны қалдыруға болады: ешбір режимде екі рет оқылмайды. claude-md-or-agents-md режимінде сілтемені жоймас бұрын қажет нұсқаулар сақталғанын және жұмыс каталогында не оның жоғары жағында басқа CLAUDE.md, .claude/CLAUDE.md немесе CLAUDE.local.md жоқ екенін тексеріңіз. Жүктелуді сол тәсілдермен тексеріңіз: кедергі жасайтын файлдар жоқ болса, сеанс басталғанда AGENTS.md loaded жолын іздеңіз немесе /memory пәрменін қолданыңыз (2.1.280+). Егер CLAUDE.md қалса әрі claude-md-and-agents-md режимі таңдалса, Claude-қа тікелей сұрақ қою — әлсіз тексеру ғана. Қате шықпауы файлдың жүктелгенін растауға жеткіліксіз.
• AGENTS.md мазмұнын қолмен шығаратын SessionStart hook-ы. Файл тікелей оқылғанда мұндай hook контекстке екінші көшірмені қосады. Hook іске қосылып тұрған кезде “нұсқауларыңда не жазылған?” деген сұрақ тікелей жүктелуді растамайды: Claude hook қосқан мәтінге сүйеніп жауап беруі мүмкін. Режимді мына ретпен ауыстырыңыз:
  1. Мүмкіндік қолжетімді екенін тексеріңіз: нұсқа 2.1.277 немесе одан жоғары, сеанс мүмкіндік жалаушаларын алады, плагин қосылған және орнатудан не жаңартудан кейінгі алғашқы сеанс аяқталған. Тікелей оқу режимін таңдаңыз — claude-md де, managed-only да емес. Әдепкі режим үшін кедергі жасайтын файлдардың жоқтығын да тексеріңіз.
  2. Hook-ты алып тастаңыз.
  3. Сеансты жауып, жаңасын ашыңыз. SessionStart hook-ы мәтінін іске қосылғанда қосатындықтан, оның мазмұны ашық тұрған сеанстың контекстінде қала береді. Мұндай сеанста Claude-тың нұсқаулар мазмұны туралы жауабы тікелей жүктелуді растамайды.
  4. Жаңа сеанста жүктелуді тексеріңіз. 2.1.280+ нұсқасында AGENTS.md файлына апаратын жол /memory пәрменінде көрінеді. 2.1.277–2.1.279 нұсқаларында кедергі жасайтын файлдар болмаса, іске қосылғанда AGENTS.md loaded жолын іздеңіз: құжаттамада бұл жол арнайы CLAUDE.md табылмаған жағдай үшін сипатталған. Егер CLAUDE.md файлын сақтап, claude-md-and-agents-md режимін қолдансаңыз, тексеру мүмкіндігі шектеулі: бұл нұсқаларда /memory пәрмені AGENTS.md файлын көрсетпейді, құжаттамада бұл жағдайға арналған жүктелу жолы сипатталмаған, ал нұсқаулардың мазмұнын қайталап айту тікелей оқуды CLAUDE.md ішіндегі @ импортынан ажыратпайды. Мұндай жағдайда 2.1.280+ нұсқасына жаңартып, /memory пәрменін тексеріңіз.

AGENTS.md файлының жүктелгенін қалай тексеруге болады#

Кәдімгі CLAUDE.md файлынан тағы екі айырмашылығы бар: мұндай AGENTS.md үшін InstructionsLoaded hook-тары іске қосылмайды (олар CLAUDE.md ішіндегі @ синтаксисі арқылы импортталған немесе CLAUDE.md символдық сілтемесімен холбогдсон AGENTS.md үшін жұмыс істейді); --add-dir жалаушасымен және CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD айнымалысымен қосылған каталогтардан тек сол каталогтың CLAUDE.md файлы жүктеледі — оның AGENTS.md файлы қосылмайды.

Жоба нұсқауларының үлкен файлының мазмұнын қарап шығу қажет болса, CLAUDE.md файлын тым көлемді етпей баптау туралы бөлек талдауды қараңыз. Онда нұсқаулардың құрылымы қамтылған, ал AGENTS.md файлының жүктелу шарттары жоғарыда сипатталған. Сеанстар арасындағы жұмыс жазбалары үшін Claude Code-тағы екінші ми туралы талдауды қараңыз — онда жоба нұсқауларының үстіне қосылатын жеке жад туралы айтылады.

Әрі қарай не істеу керек#

Бұл мүмкіндік 2026 жылғы 18 қыркүйекте 2.1.277 нұсқасында шығарылды. Anthropic болашақ шығарылымдарда режимдер туралы мәліметтерді нақтылауы мүмкін, сондықтан маңызды жобада баптауларды өзгертпес бұрын осы мақаланы ағымдағы /config мәліметтерімен және ресми өзгерістер журналымен салыстырыңыз.