A Claude Code mostantól beolvassa az AGENTS.md fájlt: mi változott a 2.1.277-ben

2026. szeptember 18-án bekerült az AGENTS.md támogatása a Claude Code 2.1.277-es verziójába. Ha a funkció elérhető a munkamenetben és a munkakönyvtárban, és a fölötte lévő könyvtárak láncában sehol sincs CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md, a Claude Code alapértelmezés szerint, kézi importálás nélkül olvassa be az AGENTS.md fájlt. Korábban ezt a CLAUDE.md fájlban lévő @AGENTS.md importtal vagy a CLAUDE.md fájl AGENTS.md-re mutató szimbolikus hivatkozásával lehetett megtenni — további részletekért lásd a több ügynökhöz használható egyetlen utasításfájlról szóló cikket.

Ha a Claude Code mellett még egy vagy két másik eszközt is használsz ugyanabban a tárolóban, a választott Project instructions mód határozza meg, hogy a Claude Code mely utasításfájlokat olvassa be. Az alábbiakban bemutatjuk mind a négy mód feltételeit, valamint a régi beállításról való átállás lépéseit.

Az eszközök konfigurálásáról további anyagok találhatók az Ailoot dokumentációjában.

Mi változott a 2.1.277-es verzióban?#

A hivatalos Claude Code-projekt GitHubon található CHANGELOG.md fájlja így fogalmaz:

Fordítás: bekerült az AGENTS.md támogatása — a CLAUDE.md nélküli projektekben a Claude Code mostantól az AGENTS.md fájlt olvassa be helyette; ez a /config „Project instructions” részében állítható át (Bedrockon, Vertexen és Foundryban egyelőre nem érhető el).

A verzió előtt a CLAUDE.md, a .claude/CLAUDE.md és a CLAUDE.local.md hiánya a munkakönyvtárban és a fölötte lévő könyvtárakban önmagában még nem tette lehetővé az AGENTS.md beolvasását. Ehhez explicit import, szimbolikus hivatkozás vagy kézi hook kellett. Mostantól, ha a funkció elérhető, az ügynök automatikusan beolvassa a fájlt.

Mely fájlok akadályozzák az AGENTS.md automatikus beolvasását?#

Ha van egy személyes ~/.claude/CLAUDE.md fájlod kódolási stílusra vonatkozó beállításokkal, az nem akadályozza meg a Claude Code-ot a projekt AGENTS.md fájljának beolvasásában. A munkakönyvtárban található bármely CLAUDE.local.md fájl viszont — még az is, amelyet nem adtál hozzá a Githez, és személyes jegyzetekre használsz — megakadályozza az AGENTS.md automatikus beolvasását alapértelmezett módban. Az explicit import továbbra is működik; ha mindkét fájlt közvetlenül szeretnéd beolvasni, módot kell váltanod.

Ha a Project instructions részben közvetlen beolvasási módot választottál (lásd alább: „4 Project instructions mód — melyiket válaszd?”), és a munkakönyvtárban vagy fölötte sehol sincs CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md, a Claude Code a munkamenet indításakor beolvassa az ezekben a könyvtárakban található összes AGENTS.md és .claude/AGENTS.md fájlt. Ha nincs akadályozó fájl, a dokumentáció szerint egy interaktív munkamenetben ehhez hasonló sor jelenik meg:

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

Az alkönyvtárban lévő AGENTS.md akkor töltődik be, amikor a Claude a Read eszközzel megnyit egy ott található fájlt. A claude-md-or-agents-md módban ez csak akkor történik meg, ha az adott alkönyvtárban nincs saját CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md. A claude-md-and-agents-md esetében a dokumentáció az általános szabályt ismerteti: a CLAUDE.md és az AGENTS.md együtt töltődik be, minden könyvtárban először a CLAUDE.md, majd az AGENTS.md. Az AGENTS.local.md, az AGENTS.override.md és a .agents/ könyvtárban lévő tartalom nem töltődik be automatikusan.

A mesterségesintelligencia-ügynök munkaterületének beállításáról, köztük a projekt kontextusát tartalmazó utasításfájlokról az Ailoot dokumentációjában találsz további anyagokat.

4 Project instructions mód — melyiket válaszd?#

A táblázatban szereplő módok működését az Anthropic dokumentációja ismerteti. A jobb oldali oszlop ajánlásokat ad a választáshoz:

A módot a felület nélkül, a settings.json fájlon keresztül is kiválaszthatod:

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

A Claude Code figyelmen kívül hagyja ezt az értéket a project és a local beállításokban. Az Anthropic dokumentációja szerint a ~/.claude/settings.json fájlban, egy --settings fájlban vagy szervezet által kezelt beállításokban adható meg.

Ha már beállítottál egy közös utasításfájlt több mesterségesintelligencia-eszköz számára ugyanabban a tárolóban, a 2.1.277 előtti verziókra vonatkozó útmutató ismerteti az @ import működését. Ez a módszer ma is működik.

Miért nem látható a Project instructions a /config parancsban?#

Először ellenőrizd a verziót a claude --version paranccsal. Ha régebbi, mint a 2.1.277, frissítsd a Claude Code-ot. Ha a verzió megfelelő, de a szakasz továbbra sem jelenik meg, ellenőrizd a fent felsorolt többi okot. Amíg a funkció nem érhető el, a CLAUDE.md fájlba importált @AGENTS.md működő megoldás marad.

Mit tegyél a régi @AGENTS.md importtal?#

A következő lépések a régi beállítástól függenek. Először győződj meg róla, hogy a funkció elérhető a munkamenetben, ahogy az előző szakasz leírja.

• CLAUDE.md @AGENTS.md importtal. Meghagyhatod változatlanul — a Claude Code a Project instructions bármelyik értéke mellett sem olvassa be kétszer a fájlt. A CLAUDE.md törlése nem kötelező: az import már hozzáférést biztosít a Claude számára az AGENTS.md tartalmához. Az importon keresztüli betöltést továbbra is ellenőrizd a /memory paranccsal; a Claude-nak az utasítások tartalmáról feltett közvetlen kérdés csak gyenge ellenőrzés.
• A CLAUDE.md szövegesen kéri az AGENTS.md beolvasását. Az ilyen kérés nem import, és önmagában nem garantálja a fájl betöltését. Ha meg szeretnéd tartani a CLAUDE.md fájlt (például mert más eszközök is beolvassák), cseréld le a szöveget @AGENTS.md importra. Ha úgy döntesz, hogy teljesen törlöd a CLAUDE.md fájlt, és a claude-md-or-agents-md mód van kiválasztva, először ellenőrizd, hogy a CLAUDE.md nem tartalmaz egyedi utasításokat, és a munkakönyvtárban vagy fölötte nincs másik CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md; különben a Claude Code továbbra is a megmaradt fájlt olvassa be az AGENTS.md helyett. Törlés után ellenőrizd, hogy megtörtént-e az átállás: ha már nincs akadályozó fájl, az interaktív munkamenetben megjelenik az AGENTS.md loaded sor. Ha a CLAUDE.md megmarad, és mindkét fájl a claude-md-and-agents-md módban töltődik be, ellenőrizd a /memory paranccsal (a 2.1.280-as vagy újabb verzióban). A Claude-nak feltett közvetlen kérdés nem tud különbséget tenni a közvetlen betöltés és az import között.
• Az AGENTS.md fájlra mutató szimbolikus CLAUDE.md hivatkozás. Meghagyhatod: egyik módban sem történik dupla beolvasás. Mielőtt törlöd a hivatkozást a claude-md-or-agents-md módban, ellenőrizd, hogy a szükséges utasítások megmaradnak, és a munkakönyvtárban vagy fölötte nincs másik CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md. A betöltést ugyanígy ellenőrizd: ha nincs akadályozó fájl, a munkamenet indításakor keresd az AGENTS.md loaded sort, vagy használd a /memory parancsot (2.1.280+). Ha a CLAUDE.md megmarad a claude-md-and-agents-md módban, a Claude-nak feltett közvetlen kérdés csak gyenge ellenőrzés. A hibaüzenet hiánya nem elég a betöltés igazolására.
• SessionStart hook, amely kézzel kiírta az AGENTS.md tartalmát. Közvetlen beolvasás esetén az ilyen hook a fájl második példányát adja hozzá a kontextushoz. Amíg fut a hook, a „mi szerepel az utasításaidban?” kérdés nem igazolja a közvetlen betöltést: a Claude a hook által hozzáadott szöveg alapján is válaszolhat. Az átállás lépései:
  1. Ellenőrizd, hogy a funkció elérhető-e: a verzió 2.1.277-es vagy újabb, a munkamenet megkapja a funkciójelzőket, a bővítmény engedélyezve van, és a telepítés vagy frissítés utáni első munkamenet már befejeződött. Válassz közvetlen beolvasási módot — ne a claude-md vagy a managed-only módot. Alapértelmezett mód esetén azt is ellenőrizd, hogy nincs akadályozó fájl.
  2. Távolítsd el a hookot.
  3. Zárd be a munkamenetet, és nyiss egy újat. A SessionStart hook induláskor illeszti be a szövegét, ezért az egy már megnyitott munkamenet kontextusában marad. Az utasítások tartalmáról adott Claude-válasz egy ilyen munkamenetben nem igazolja a közvetlen betöltést.
  4. Ellenőrizd a betöltést az új munkamenetben. A 2.1.280-as vagy újabb verzióban az AGENTS.md fájl elérési útja látható a /memory parancsban. A 2.1.277–2.1.279 verziókban, ha nincs akadályozó fájl, keresd az AGENTS.md loaded sort az indításkor: a dokumentáció kifejezetten arra az esetre írja le, amikor nem található CLAUDE.md. Ha megtartod a CLAUDE.md fájlt, és a claude-md-and-agents-md módot használod, az ellenőrzés korlátozott: ezekben a verziókban a /memory nem mutatja az AGENTS.md fájlt, a dokumentáció nem ír le betöltési sort erre az esetre, és az utasítások átfogalmazása nem különbözteti meg a közvetlen beolvasást a CLAUDE.md fájlban lévő @ importtól. Ilyenkor frissíts 2.1.280-as vagy újabb verzióra, majd ellenőrizd a /memory paranccsal.

Hogyan ellenőrizd, hogy betöltődött-e az AGENTS.md?#

A szokásos CLAUDE.md-hez képest még két különbség van: az InstructionsLoaded hookok nem futnak le az ilyen típusú AGENTS.md esetében (viszont működnek a CLAUDE.md fájlból @ szintaxissal importált vagy CLAUDE.md szimbolikus hivatkozással összekapcsolt AGENTS.md fájlokkal); a --add-dir kapcsolóval, valamint a CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD változóval hozzáadott könyvtárakból csak az adott könyvtár CLAUDE.md fájlja töltődik be — az AGENTS.md nem.

Ha egy nagy projektutasítás-fájl tartalmát szeretnéd áttekinteni, lásd a külön elemzést arról, hogyan állítsd be a CLAUDE.md fájlt úgy, hogy ne duzzadjon túl nagyra. Ez az utasítások felépítését tárgyalja; az AGENTS.md betöltési feltételeit fent ismertettük. A munkamenetek közötti jegyzetekhez lásd a Claude Code-ban használható második agyról szóló elemzést — a projektutasításokra rétegzett személyes memóriáról.

Mi következik?#

A funkció 2026. szeptember 18-án jelent meg a 2.1.277-es verzióban. Az Anthropic a későbbi kiadásokban még pontosíthatja a módok részleteit, ezért mielőtt fontos projektben módosítanád a beállításokat, vesd össze ezt a cikket a jelenlegi /config felülettel és a hivatalos changeloggal.