# A Claude Code mostantól beolvassa az AGENTS.md fájlt: mi változott a 2.1.277-ben
> 2026. szeptember 18-án a Claude Code 2.1.277 közvetlen támogatást kapott az AGENTS.md-hez: mikor töltődik be a fájl, hogyan válasszunk a 4 mód közül, és mit tegyünk az importálásokkal.
Source: https://ailoot.ai/blog/hu/claude-code-agents-md-support/
Canonical: https://ailoot.ai/blog/hu/claude-code-agents-md-support/
Language: hu
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-041
Revision: sha256-0ecf47498b882b92dc4d80503503e0683362cc77c181a2491fb9062a8bbb6c45
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](https://ailoot.ai/blog/hu/agents-md-claude-md-one-instruction-file/).
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](https://ailoot.ai/docs/).
[Ailoot útmutatók](https://ailoot.ai/docs/)
## Mi változott a 2.1.277-es verzióban?
Fő tanulság
2026. szeptember 18-tól a Claude Code alapértelmezés szerint beolvassa az `AGENTS.md` fájlt, ha a munkakönyvtártól felfelé haladó könyvtárak láncában sehol sincs `CLAUDE.md`, `.claude/CLAUDE.md` vagy `CLAUDE.local.md`. Ha létezik ilyen fájl, a Project instructions nem engedélyezi az `AGENTS.md` automatikus beolvasását. A `CLAUDE.md` fájlból explicit módon megadott `@AGENTS.md` import továbbra is működik. A felhasználói szintű `~/.claude/CLAUDE.md`, a szervezet által kezelt `CLAUDE.md` és a `.claude/rules/` a projektfájlok közötti választástól függetlenül töltődik be. A mód a `/config` paranccsal váltható át. A funkció egyelőre nem érhető el Bedrockon, Vertexen vagy Foundryban.
A hivatalos Claude Code-projekt GitHubon található CHANGELOG.md fájlja így fogalmaz:
Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in /config (not yet on Bedrock, Vertex or Foundry)
— Anthropic, claude-code CHANGELOG.md-commit, ca02e7d, https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3
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?
Fő tanulság
Az alapértelmezett módban a rendszer a munkakönyvtárban és a fölötte lévő könyvtárakban ellenőrzi a `CLAUDE.md`, a `.claude/CLAUDE.md` és a `CLAUDE.local.md` fájlt. A személyes `~/.claude/CLAUDE.md`, a szervezet által kezelt `CLAUDE.md` és a `.claude/rules/` fájljai nem akadályozzák az `AGENTS.md` beolvasását, és vele együtt töltődnek be.
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](https://ailoot.ai/docs/) találsz további anyagokat.
[Ailoot útmutatók](https://ailoot.ai/docs/)
## 4 Project instructions mód — melyiket válaszd?
Fő tanulság
A `/config` parancs Project instructions részében négy érték közül választhatsz: `claude-md-or-agents-md` (alapértelmezett — a két fájl közül az egyik), `claude-md-and-agents-md` (mindkettő együtt), `claude-md` (automatikusan csak a `CLAUDE.md` töltődik be, még akkor is, ha a projektben csak `AGENTS.md` van), valamint `managed-only` (induláskor csak a szervezet által kezelt `CLAUDE.md` és az automatikus memória, projekt- vagy személyes fájlok nélkül). A változás a következő elküldött üzenettől és minden új munkamenetben lép életbe.
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:
| Érték | Mit olvas be a Claude Code | Mikor használd |
|----|----|----|
| `claude-md-or-agents-md` | `CLAUDE.md`, vagy `AGENTS.md`, ha a munkakönyvtárban vagy fölötte nincs `CLAUDE.md`, `.claude/CLAUDE.md` vagy `CLAUDE.local.md` | Alapértelmezett választás, ha a tároló a két fájl közül csak az egyiket használja, és fölötte nincs akadályozó fájl |
| `claude-md-and-agents-md` | Mindkét fájl együtt: minden könyvtárban először a `CLAUDE.md`, majd az `AGENTS.md` | Közös `AGENTS.md` fájlra van szükséged minden eszköz számára, valamint egy rövid `CLAUDE.md` fájlra csak a Claude számára; vagy akkor is be szeretnéd olvasni az `AGENTS.md` fájlt, ha létezik `CLAUDE.local.md` |
| `claude-md` | Csak a `CLAUDE.md`; a Project instructions nem olvassa be automatikusan az `AGENTS.md` fájlt, még akkor sem, ha az `AGENTS.md` az egyetlen fájl (a `CLAUDE.md` fájlból megadott explicit `@AGENTS.md` import továbbra is működik) | Az `AGENTS.md` más eszközhöz készült, és összezavarhatja a Claude-ot |
| `managed-only` | A munkamenet indításakor csak a szervezet által kezelt `CLAUDE.md` és az automatikus memória töltődik be; a projekt-, helyi és felhasználói `CLAUDE.md`, a `.claude/rules/` és minden `AGENTS.md` fájl kimarad a kezdeti készletből. Az alkönyvtárakban lévő `CLAUDE.md` és `.claude/rules/` fájlok azonban később betöltődnek, amikor a Claude ott nyit meg egy fájlt. A mód a kezdeti készletet korlátozza, de nem biztosít teljes elszigetelést a projektfájloktól | Olyan szervezeteknek, amelyek szabályozni szeretnék, milyen utasításkészlettel indítson munkamenetet a Claude Code, függetlenül attól, hogy maga a projekt tartalmaz-e `CLAUDE.md` vagy `AGENTS.md` fájlt |
A módot a felület nélkül, a `settings.json` fájlon keresztül is kiválaszthatod:
```json
{
"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ó](https://ailoot.ai/blog/hu/agents-md-claude-md-one-instruction-file/) 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?
Fő tanulság
Az Anthropic dokumentációja szerint a Project instructions rész az alábbi okokból hiányozhat:
- A Claude Code verziója régebbi, mint a 2.1.277.
- A munkamenet nem kap funkciójelzőket az Anthropic szolgáltatásától — például Bedrock, más külső szolgáltató használatakor vagy kikapcsolt telemetria esetén.
- Ez az első munkamenet egy régebbi verzió telepítése vagy frissítése után. Ha csak ez az ok, a funkció a következő munkamenetben megjelenik. Maga az `AGENTS.md` csak akkor töltődik be, ha a kiválasztott mód feltételei teljesülnek.
- A beépített `agents-md` bővítmény le van tiltva a `/plugin` 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?
Fő tanulság
Megtarthatod a `CLAUDE.md` fájlban lévő `@AGENTS.md` importot és a szimbolikus hivatkozást: egyik módban sem töltődik be kétszer a fájl. Ha megtartod a `CLAUDE.md` fájlt, a szöveges „olvasd be az AGENTS.md fájlt” kérést importtal kell helyettesíteni. Fájl törlése előtt mentsd el az összes szükséges utasítást, és ellenőrizd a kiválasztott mód feltételeit. Ha közvetlen beolvasásra váltasz, távolíts el minden olyan `SessionStart` hookot, amely kézzel kiírta az `AGENTS.md` tartalmát; ellenkező esetben a fájl második példánya is bekerül a kontextusba. Ezután ellenőrizd a betöltést egy új munkamenetben; az ellenőrzés módja a verziótól és az akadályozó fájlok meglététől függ.
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?
Fő tanulság
A 2.1.280-as verziótól a Project instructions révén betöltött `AGENTS.md` megjelenik a `/memory` parancsban és a `/context` parancs Memory files listájában. A 2.1.277–2.1.279 verziókban nem jelenik meg ott, noha a parancsok működnek, és mutatják a betöltött `CLAUDE.md` fájlt és más memóriafájlokat. Ezekben a verziókban, ha nincs akadályozó fájl, ellenőrizd az `AGENTS.md loaded` sort a munkamenet indításakor. A Claude-tól az utasítások tartalmáról kérdezni csak gyenge ellenőrzés: a válaszból nem állapítható meg, hogy közvetlen beolvasás vagy `@` import történt, és a Claude a `SessionStart` hook által hozzáadott szövegre is támaszkodhat. Ezért ilyen kérdést csak új munkamenetben érdemes feltenni, miután eltávolítottad az ilyen hookot.
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](https://ailoot.ai/blog/hu/claude-md-template/). 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](https://ailoot.ai/blog/hu/claude-code-second-brain/) — 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.
### Források
- [Claude Code: a 2.1.277-es bejegyzést tartalmazó CHANGELOG.md-commit a GitHubon (2026. szeptember 18.)](https://github.com/anthropics/claude-code/commit/ca02e7deeb0707f558b0afd7e9e5d67a382e12b3)
- [Claude Code dokumentáció: Hogyan emlékszik a Claude a projektedre — AGENTS.md szakasz](https://code.claude.com/docs/en/memory)
[Ailoot útmutatók](https://ailoot.ai/docs/)
[Ugrás az Ailoot oldalára](https://ailoot.ai/)
## Kérdések és válaszok: A Claude Code mostantól beolvassa az AGENTS.md fájlt: mi változott a 2.1.277-ben
### Miért nem töltődik be az AGENTS.md, ha a fájl létezik?
Alapértelmezett módban a munkakönyvtárban vagy valamelyik szülőjében lévő CLAUDE.md, .claude/CLAUDE.md vagy CLAUDE.local.md blokkolja az AGENTS.md automatikus választását. A Claude Code-verziót, a funkció elérhetőségét és a /config Project instructions módját is nézd meg.
### Hogyan igazoljam a közvetlen betöltést egy kézi hook eltávolítása után?
Nyiss új munkamenetet, hogy a régi SessionStart-kimenet ne legyen jelen. A 2.1.280-as vagy újabb verzióban a /memory vagy a /context Memory files listáját vizsgáld; 2.1.277-2.1.279 alatt az indulási betöltési sor számít, ha nincsenek blokkoló CLAUDE.md-fájlok. Claude puszta átfogalmazása gyenge bizonyíték.
## Ailoot · A vállalat és projektportfóliója
Az Ailoot felhalmozott működési tapasztalatra, széles ügyfélkörre, stabil szolgáltatásra és folyamatos KPI-ellenőrzésre épít.
A vállalat és projektportfóliója: ügyfelek milliói; havi értékesítés milliárdos nagyságrendben.
Az Ailoot ezt a működési tapasztalatot használja az ügyfelek termékeiben, ágenseiben, alkalmazásaiban és automatizálásaiban elérhető AI-funkciók API-hozzáféréséhez.