Claude Code dabar skaito AGENTS.md: kas pasikeitė 2.1.277 versijoje

2026 m. rugsėjo 18 d. Claude Code 2.1.277 buvo pridėtas AGENTS.md palaikymas. Jei ši funkcija pasiekiama sesijoje ir darbiniame kataloge, o visoje aukštesnių katalogų grandinėje nėra jokio CLAUDE.md, .claude/CLAUDE.md ar CLAUDE.local.md, Claude Code pagal numatytuosius nustatymus skaito AGENTS.md be rankinio importavimo. Anksčiau tai buvo daroma importuojant @AGENTS.md į CLAUDE.md arba sukuriant simbolinę nuorodą iš CLAUDE.md į AGENTS.md — daugiau informacijos rasite straipsnyje apie vieną instrukcijų failą keliems agentams.

Jei tame pačiame saugyklos kataloge naudojate Claude Code ir vieną ar du kitus įrankius, pasirinktas Project instructions režimas lemia, kuriuos instrukcijų failus skaito Claude Code. Toliau pateikiamos kiekvieno iš keturių režimų sąlygos ir perėjimo nuo ankstesnės sąrankos veiksmai.

Daugiau medžiagos apie įrankių konfigūravimą rasite Ailoot dokumentacijoje.

Kas pasikeitė 2.1.277 versijoje?#

Oficialiame Claude Code projekto CHANGELOG.md faile GitHub platformoje tai aprašyta taip:

Vertimas: pridėtas AGENTS.md palaikymas — projekte be CLAUDE.md Claude Code dabar skaito AGENTS.md; šią parinktį galima pakeisti /config skiltyje „Project instructions“ (dar nepasiekiama Bedrock, Vertex ar Foundry).

Iki šios versijos vien tai, kad darbiniame aplanke ir aukščiau esančiuose kataloguose nėra CLAUDE.md, .claude/CLAUDE.md ir CLAUDE.local.md, neįjungdavo AGENTS.md skaitymo. Reikėjo aiškaus importo, simbolinės nuorodos arba rankinio hook. Dabar, kai funkcija pasiekiama, agentas failą aptinka automatiškai.

Kurie failai blokuoja automatinį AGENTS.md skaitymą#

Jei turite asmeninį ~/.claude/CLAUDE.md su kodo stiliaus nustatymais, jis netrukdys Claude Code skaityti projekto AGENTS.md. Tačiau bet kuris darbiniame aplanke esantis CLAUDE.local.md — net jei jis nepridėtas prie Git ir naudojamas asmeninėms pastaboms — numatytuoju režimu blokuoja automatinį AGENTS.md skaitymą. Aiškus importas ir toliau veikia; norėdami abu failus skaityti tiesiogiai, turite pakeisti režimą.

Jei Project instructions nustatytas tiesioginio skaitymo režimas (žr. toliau esantį skyrių „4 Project instructions režimai — kurį pasirinkti“) ir darbiniame kataloge arba aukščiau esančiuose kataloguose nėra CLAUDE.md, .claude/CLAUDE.md ar CLAUDE.local.md, Claude Code sesijos pradžioje skaito kiekvieną AGENTS.md ir .claude/AGENTS.md šiuose kataloguose. Kai nėra blokuojančių failų, dokumentacijoje nurodoma, kad interaktyvioje sesijoje rodoma panaši eilutė:

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

Pakatalogyje esantis AGENTS.md įkeliamas, kai Claude, naudodamas Read įrankį, atidaro tame kataloge esantį failą. Režimu claude-md-or-agents-md taip nutinka tik jei pakatalogyje nėra atskiro CLAUDE.md, .claude/CLAUDE.md ar CLAUDE.local.md. Apie režimą claude-md-and-agents-md dokumentacijoje aprašoma bendroji taisyklė: CLAUDE.md ir AGENTS.md skaitomi kartu — kiekviename kataloge pirmiausia CLAUDE.md, tada AGENTS.md. AGENTS.local.md, AGENTS.override.md ir failai kataloge .agents/ automatiškai neskaitomi.

Medžiagą apie AI agento darbo srities konfigūravimą, įskaitant instrukcijų failus su projekto kontekstu, rasite Ailoot dokumentacijoje.

4 Project instructions režimai — kurį pasirinkti#

Lentelėje pateiktų režimų veikimas aprašytas Anthropic dokumentacijoje. Dešiniajame stulpelyje pateikiamos rekomendacijos, kada juos rinktis:

Režimą taip pat galite pasirinkti be sąsajos, naudodami settings.json:

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

Claude Code ignoruoja šią reikšmę project ir local nustatymuose. Anthropic dokumentacijoje nurodoma, kad ją galima nustatyti faile ~/.claude/settings.json, faile, perduodamame su --settings, arba organizacijos valdomuose nustatymuose.

Jei jau sukonfigūravote bendrą instrukcijų failą keliems AI įrankiams vienoje saugykloje, iki 2.1.277 versijos skirtose instrukcijose paaiškinta, kaip veikia @ importas. Šis būdas veikia ir dabar.

Kodėl /config nėra Project instructions#

Pirmiausia patikrinkite versiją komanda claude --version. Jei ji senesnė nei 2.1.277, atnaujinkite Claude Code. Jei versija tinkama, bet skiltis vis tiek nerodoma, patikrinkite kitas pirmiau išvardytas priežastis. Kol funkcija nepasiekiama, @AGENTS.md importas į CLAUDE.md lieka veikiančia alternatyva.

Ką daryti su senu @AGENTS.md importu#

Tolesni veiksmai priklauso nuo ankstesnės sąrankos. Pirmiausia įsitikinkite, kad funkcija pasiekiama jūsų sesijoje, kaip aprašyta ankstesniame skyriuje.

• CLAUDE.md su @AGENTS.md importu. Galite palikti jį tokį, koks yra — Claude Code neskaitys failo du kartus esant jokiai Project instructions reikšmei. CLAUDE.md trinti nebūtina: importas jau suteikia Claude prieigą prie AGENTS.md turinio. Toliau tikrinkite įkėlimą per importą naudodami /memory; tiesioginis Claude klausimas apie instrukcijų turinį yra tik silpnas patikrinimas.
• CLAUDE.md, kuriame žodžiais prašoma perskaityti AGENTS.md. Toks prašymas nėra importas ir savaime negarantuoja, kad failas bus įkeltas. Jei norite palikti CLAUDE.md (pavyzdžiui, įrankiams, kurie taip pat jį skaito), pakeiskite tekstą į @AGENTS.md importą. Jei nuspręsite visiškai ištrinti CLAUDE.md ir pasirinktas režimas claude-md-or-agents-md, pirmiausia įsitikinkite, kad CLAUDE.md nėra unikalių instrukcijų ir darbiniame kataloge ar aukščiau esančiuose kataloguose nėra kito CLAUDE.md, .claude/CLAUDE.md ar CLAUDE.local.md; priešingu atveju Claude Code toliau skaitys likusį failą vietoj AGENTS.md. Ištrynę įsitikinkite, kad perėjimas įvyko: kai nebelieka blokuojančių failų, interaktyvioje sesijoje rodoma eilutė AGENTS.md loaded. Jei CLAUDE.md lieka, o režimu claude-md-and-agents-md skaitomi abu failai, patikrinkite /memory (2.1.280+ versijoje). Tiesioginis Claude klausimas neleidžia atskirti tiesioginio įkėlimo nuo importo.
• Simbolinė nuoroda CLAUDE.md į AGENTS.md. Galite ją palikti: nė vienu režimu failas nebus skaitomas dukart. Prieš ištrindami nuorodą režimu claude-md-or-agents-md, patikrinkite, ar išsaugotos reikalingos instrukcijos ir ar darbiniame kataloge arba aukščiau esančiuose kataloguose nėra kito CLAUDE.md, .claude/CLAUDE.md ar CLAUDE.local.md. Įkėlimą tikrinkite taip pat: jei nėra blokuojančių failų, sesijos pradžioje ieškokite eilutės AGENTS.md loaded, arba patikrinkite /memory (2.1.280+). Jei CLAUDE.md lieka režimu claude-md-and-agents-md, tiesioginis Claude klausimas yra tik silpnas patikrinimas. Klaidos nebuvimo nepakanka įkėlimui patvirtinti.
• SessionStart hook, kuris rankiniu būdu pateikdavo AGENTS.md turinį. Kai failas skaitomas tiesiogiai, toks hook į kontekstą įdeda antrą kopiją. Kol hook veikia, klausimas „kas parašyta tavo instrukcijose?“ tiesioginio įkėlimo nepatvirtina: Claude gali atsakyti remdamasis hook pridėtu tekstu. Pereikite tokia tvarka:
  1. Patikrinkite, ar funkcija pasiekiama: versija 2.1.277 arba naujesnė, sesija gauna funkcijų žymas, papildinys įjungtas ir baigta pirmoji sesija po įdiegimo arba naujinimo. Pasirinkite tiesioginio skaitymo režimą — nei claude-md, nei managed-only. Jei pasirinkote numatytąjį režimą, taip pat patikrinkite, ar nėra blokuojančių failų.
  2. Pašalinkite hook.
  3. Uždarykite sesiją ir atidarykite naują. SessionStart hook tekstą įterpia paleidimo metu, todėl jo turinys lieka jau atidarytos sesijos kontekste. Claude atsakymas apie instrukcijų turinį tokioje sesijoje nepatvirtins tiesioginio įkėlimo.
  4. Patikrinkite įkėlimą naujoje sesijoje. 2.1.280+ versijoje AGENTS.md kelias matomas per /memory. 2.1.277–2.1.279 versijose, jei nėra blokuojančių failų, paleidimo metu ieškokite eilutės AGENTS.md loaded: dokumentacijoje ji aprašoma būtent tam atvejui, kai nerasta CLAUDE.md. Jei paliekate CLAUDE.md ir naudojate claude-md-and-agents-md režimą, patikrinimo galimybės ribotos: šiose versijose /memory nerodo AGENTS.md, dokumentacijoje nenurodoma šio atvejo įkėlimo eilutė, o instrukcijų perfrazavimas neleidžia atskirti tiesioginio skaitymo nuo @ importo faile CLAUDE.md. Tokiu atveju atnaujinkite į 2.1.280+ versiją ir patikrinkite /memory.

Kaip patikrinti, ar AGENTS.md įkeltas#

Nuo įprasto CLAUDE.md tai skiriasi dar dviem dalykais: InstructionsLoaded hook nesuveikia šio tipo AGENTS.md failams (jie veikia, kai AGENTS.md importuojamas iš CLAUDE.md naudojant @ sintaksę arba prijungiamas simboline nuoroda CLAUDE.md); naudojant --add-dir vėliavą kartu su kintamuoju CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD pridėtuose kataloguose įkeliamas tik to katalogo CLAUDE.md — jo AGENTS.md neįtraukiamas.

Jei norite peržiūrėti didelio projekto instrukcijų failo turinį, žr. atskirą analizę kaip konfigūruoti CLAUDE.md, kad jis netaptų pernelyg didelis. Joje aptariama instrukcijų struktūra, o AGENTS.md įkėlimo sąlygos aprašytos aukščiau. Apie darbo užrašus tarp sesijų skaitykite analizėje antrasis Claude Code protas — joje rašoma apie asmeninę atmintį, papildančią projekto instrukcijas.

Kas toliau#

Ši funkcija išleista 2026 m. rugsėjo 18 d. su 2.1.277 versija. Anthropic būsimuose leidimuose gali patikslinti režimų veikimą, todėl prieš keisdami svarbaus projekto nustatymus palyginkite šį straipsnį su dabartiniu /config ir oficialiu pakeitimų žurnalu.