Egyetlen utasításfájl a Claude Code, a Codex és a Cursor számára 2026-ban

A szolgáltatással kapcsolatos információkért lásd az Ailoot dokumentációját.

Mi változik, ha együtt használod a Claude Code-ot, a Codexet és a Cursort?#

A leírt példában a Claude Code a fő eszköz, a Codexet és a Cursort pedig konkrét feladatokra használják. Az én CLAUDE.md fájlom körülbelül 250 sor utasítást tartalmaz: mit és milyen sorrendben kell elolvasni, mihez nem szabad nyúlni, mely parancsokat kell használni a telepítéshez, és mik a commit formázási szabályai. Amikor először kipróbáltam a Codex CLI-t a projekten, nem ismerte a szabályokat: lefuttatta a git push --force parancsot, belenyúlt a .env fájlba, és gondatlanul átnevezett fájlokat.

Először kézzel átmásoltam a CLAUDE.md fájlt AGENTS.md néven. Két héttel később rájöttem, hogy a projektben már négy változatban szerepel ugyanaz az utasítás: a CLAUDE.md, az AGENTS.md, a .cursorrules és a .windsurf/rules/ fájlban. Mindegyik kissé eltért a többitől. Ez nem a Claude vagy a Cursor problémája; ez minden több hiteles forrást használó rendszer alapvető csapdája. A problémát részletesebben a többügynökös munkáról szóló útmutatóban tárgyalom.

2026 júniusában az Anthropic Claude Code memóriadokumentációja egy megoldást javasolt: egy közös fájl és egy import. 2026 szeptembere óta a Claude Code önállóan is beolvassa az AGENTS.md fájlt, ha a projektben nincs CLAUDE.md; importálni akkor kell, ha kifejezetten a Claude-ra vonatkozó szabályaid vannak. Alább elmagyarázom, mikor elég egyetlen AGENTS.md, hogyan állítsd be az importot, és hogyan válaszd külön a közös és a Claude-specifikus szabályokat.

Beolvassa önállóan a Claude Code az AGENTS.md fájlt?#

2026 szeptembere előtt a válasz „nem” volt. Az #6235-ös issue, amely az AGENTS.md támogatását kérte, 2025 augusztusa óta volt nyitva, és 2026. augusztus 17-én zárták le. A memóriadokumentáció mindvégig ugyanazt a megoldást javasolta: hozz létre egy CLAUDE.md fájlt, és importként illeszd be az AGENTS.md fájlt. A 2.1.277-es verziótól kezdve a dokumentáció már mást ír:

Az, hogy pontosan mit olvas be a Claude Code, a projektben található fájloktól függ:

Ennél az ellenőrzésnél a munkakönyvtárban és annak bármelyik szülőkönyvtárában található CLAUDE.md, .claude/CLAUDE.md és CLAUDE.local.md is számít. A személyes ~/.claude/CLAUDE.md, a vállalati felügyelt fájl és a .claude/rules/ szabályai nem számítanak: ezeket az AGENTS.md mellett tölti be.

Ha nincs CLAUDE.md, a Claude Code induláskor beolvassa a munkakönyvtárban és annak szülőkönyvtáraiban található összes AGENTS.md és .claude/AGENTS.md fájlt, az almappában található AGENTS.md fájlt pedig akkor veszi fel, amikor abban az almappában lévő fájlt nyit meg. Az AGENTS.md fájlban szereplő @path importok is működnek. A Claude Code nem olvassa be az AGENTS.local.md és az AGENTS.override.md fájlt, illetve az .agents/ könyvtár tartalmát.

A bökkenő: a személyes CLAUDE.local.md is számít. Ha azért hozol létre ilyet, hogy a még nem commitolt szabályaidat tárold, a Claude Code csendben abbahagyja az AGENTS.md beolvasását. Az alábbi beállítás erre a megoldás.

A viselkedés a /config Project instructions beállításánál módosítható:

Ha meg akarod tartani a CLAUDE.local.md fájlt anélkül, hogy elveszítenéd az AGENTS.md fájlt, válaszd a claude-md-and-agents-md beállítást. Nem lesz dupla beolvasás: ha az AGENTS.md fájl már szerepel az @AGENTS.md soron vagy szimbolikus hivatkozáson keresztül, a Claude Code a beállítástól függetlenül nem tölti be másodszor.

A /memory paranccsal ellenőrizheted, hogy a rendszer felismerte-e a fájlt: a 2.1.280-as verziótól az AGENTS.md elérési útja megjelenik a listában. A 2.1.277-es verzió előtti kiadásokban és azokban a munkamenetekben, amelyekben a beépített agents-md bővítmény le van tiltva, a Claude Code csak a CLAUDE.md fájlt olvassa be, és a /config alatt nem jelenik meg a Project instructions elem. A 2.1.281-es verzió előtt az Amazon Bedrockon keresztül indított munkamenetek és a telemetria letiltása mellett futó munkamenetek is így működtek. Egy régebbi verzióról való frissítés utáni első munkamenetben előfordulhat, hogy az AGENTS.md sem töltődik be; a következő munkamenettől működik.

Mit jelent ez az egyfájlos beállításnál? Ha nincsenek kifejezetten Claude-ra vonatkozó szabályaid, kihagyhatod a CLAUDE.md fájlt: az AGENTS.md elég, a Claude Code, a Codex és a Cursor is beolvassa. Ha vannak ilyen szabályaid (plan mode a kockázatos könyvtárakhoz, skills, hooks), szükséged lesz a CLAUDE.md fájlra, és a Claude Code többé nem olvassa be önállóan az AGENTS.md fájlt. Ilyenkor illeszd be az AGENTS.md fájlt a CLAUDE.md fájlba az @AGENTS.md sorral; ez a beállítás ugyanúgy működik, mint szeptember előtt. Régebbi Claude Code-verziók esetén is hasznos. Alább részletesen bemutatom.

Hogyan importálhatod az @AGENTS.md fájlt a CLAUDE.md fájlba?#

Egy minimális, működő példa a hivatalos dokumentációból:

@AGENTS.md

## Claude Code

Use plan mode for changes under `src/billing/`.

Ez történik: az első sor, az @AGENTS.md, egy importdirektíva. Amikor a Claude Code a munkamenet kezdetén feldolgozza a CLAUDE.md fájlt, megtalálja az importot, és a helyére illeszti az AGENTS.md teljes tartalmát. Utána következik a ## Claude Code cím: ez egyszerű markdown, de „Claude-specifikus kiegészítések” szakaszként működik. Alatta egy kizárólag a Claude Code-ra vonatkozó szabály áll: használj plan mode-ot a billing könyvtárban végzett módosításokhoz. A Codex CLI és a Cursor egyáltalán nem nyitja meg ezt a fájlt; a sima AGENTS.md fájlt használják.

Idézet a dokumentációból az importok működéséről:

Néhány gyakorlati részlet:

• Relatív és abszolút elérési utak. Az @AGENTS.md az importot tartalmazó fájlhoz képest relatív. Az @/Users/me/shared/rules.md és az @~/.claude/personal.md abszolút elérési út. Az @~/.claude/personal.md fájlt olyan személyes preferenciákhoz használom, amelyeket nem akarok a repóba tenni.
• Négyszintű mélység. Az AGENTS.md importálhatja az @docs/coding-style.md fájlt, a coding-style.md pedig egy másik fájlt, legfeljebb négy szinten keresztül. Ez bármilyen valós struktúrához elég.
• A backtickek blokkolják az importot. Ha a szövegben ez szerepel: `@README`, az csupán a név említése, nem import. Ez akkor hasznos, ha az importok működését akarod elmagyarázni az olvasóknak anélkül, hogy ténylegesen elindítanád az importot.
• Jóváhagyás a projekten kívüli fájlokhoz. Ha az import a munkakönyvtáron kívülre mutat, például az @~/.claude/personal.md fájlra, a Claude Code első alkalommal egy párbeszédablakban felsorolja ezeket a fájlokat. Ha elutasítod, a külső importok letiltva maradnak, és a párbeszédablak többé nem jelenik meg. A projekt gyökerében lévő @AGENTS.md nem vált ki ilyen párbeszédablakot. Ez megvéd attól, hogy véletlenül egy nem kapcsolódó fájl töltődjön be a kontextusba.

Miután átálltam erre a beállításra a leírt projektben, a CLAUDE.md fájlom 250 sorról 60 sorra csökkent: @AGENTS.md, plusz öt-hét, kizárólag a Claude Code-ra vonatkozó szabály (plan mode a kockázatos könyvtárakhoz, mihez nem szabad nyúlni az adminisztrációs területen, és hogyan kell megfogalmazni a commitokat). Minden közös szabály az AGENTS.md fájlban található, amelyet a Codex és a Cursor olvas be.

Mikor érdemes szimbolikus hivatkozást, és mikor importot választani?#

A dokumentáció így mutatja be a szimbolikus hivatkozás létrehozását:

ln -s AGENTS.md CLAUDE.md

Ezután rögtön őszinte figyelmeztetést ad a Windowsról:

Összehasonlító táblázat:

A leírt projektben importokat használok. Ennek okai:

1. Vegyes a csapat. Macet használok; a példában a csapat nagyjából fele-fele arányban dolgozik Windowson és Macen. Ha szimbolikus hivatkozás kerül a repóba, a Developer Mode nélküli Windows-felhasználók sima szöveges fájlként kapják meg, benne az egyetlen AGENTS.md sorral. Ez furcsa hibákat okoz: néha működnek a szabályok, néha nem, és nem világos, miért.
2. Claude-specifikus szabályokra van szükségem. Az @AGENTS.md alatt a CLAUDE.md fájlom egy „Claude Code” szakaszt tartalmaz a következő szabályokkal: használj --effort high értéket az architekturális feladatokhoz, futtasd a npm run build parancsot a git push előtt, és ne hívd meg kézzel a /api/v1/deploy végpontot. A Codex nem érti ezeket a parancsokat.
3. Könnyebb hibát keresni. Ha valami elromlik, megnyitom a CLAUDE.md fájlt, és látom az importot meg a felülírásaimat. A szimbolikus hivatkozáson nincs „ez ide lett hozzáadva” jelzés. A Claude Code beállításainak hibakereséséről bővebben a safe mode útmutatóban olvashatsz.

Ha nincsenek Claude-specifikus szabályaid, a 2.1.277-es verziótól nincs szükség szimbolikus hivatkozásra: töröld a CLAUDE.md fájlt, és a Claude Code önállóan beolvassa az AGENTS.md fájlt. Csak akkor tartsd meg a szimbolikus hivatkozást, ha a csapat valamelyik tagja 2.1.277-nél régebbi verziót használ, és nem tud frissíteni. Ha vannak Claude-specifikus szabályaid, tízből kilenc esetben kényelmesebb az import.

Mit olvas be a Codex, a Cursor, a Copilot, a Windsurf és a Gemini CLI?#

A hét fő eszköz áttekintése (az eszközök hivatalos dokumentációja alapján):

Mi következik ebből? Ha egy repóban van AGENTS.md (és szükség esetén egy importot tartalmazó CLAUDE.md a Claude-specifikus szabályokhoz), a hét eszközből öt automatikusan friss utasításokat kap. A Cursor és a Windsurf saját natív fájlokkal rendelkezik, így maradhatnak a jelenlegi beállítások (AGENTS.md fájlt is olvassák), vagy hozzáadható egy @AGENTS.md import—de a szintaxisuk eltér, és nem mindig támogatott.

A legegyszerűbb stratégia egy új projekthez:

1. Tedd az összes közös szabályt az AGENTS.md fájlba—a szabályok 95%-ának ott a helye.
2. Hozz létre CLAUDE.md fájlt, ha csak a Claude-ra vonatkozó szabályokra van szükséged: az első sor legyen @AGENTS.md, majd alatta adj hozzá egy szakaszt a Claude-specifikus szabályokkal. Ha nincsenek ilyen szabályok, nincs szükség CLAUDE.md fájlra; a Claude Code a 2.1.277-es verzió óta önállóan beolvassa az AGENTS.md fájlt.
3. Tartsd meg a .cursor/rules/ könyvtárat a Cursor számára azokra a ritka esetekre, amikor valami Cursor-specifikusra van szükség (például a @Codebase és @Docs parancsokra).
4. A Windsurf esetében tedd ugyanezt: felejtsd el a régi .windsurfrules fájlt; az új .windsurf/rules/ könyvtárat csak akkor használd, ha a saját szintaxisához szükséges mintákra van szükség.

Ezzel a megközelítéssel a munka 20%-ával az előnyök 80%-át kapod meg. Tapasztalatom szerint az „Antigravity” vegyes csapatában a fájlok rendbetételekor kettőnél több hiteles forrás (közös és Claude-specifikus) fenntartása már körülményes. Ha valaki a csapatból szabályt ad a .cursorrules fájlhoz, de elfelejti frissíteni az AGENTS.md fájlt, egy hét múlva a Cursor és a Codex már ellentmond egymásnak.

Hogyan veszi figyelembe a /init a már létező AGENTS.md fájlt a Claude Code-ban?#

Az Anthropic így írja le a /init parancsot a dokumentációban:

Mit jelent ez a gyakorlatban? A leírt repóban volt egy .cursorrules fájl abból az időből, amikor kipróbáltam a Cursort (körülbelül 80 sor), valamint egy kézzel összeállított AGENTS.md (120 sor). Amikor lefuttattam a claude /init parancsot, mindkét fájlt felhasználta, kiszűrte a hasonló szabályok ismétlődését, és egy perc alatt összeállított egy áttekinthető CLAUDE.md fájlt. Utána ellenőriztem, és kisebb módosításokat végeztem—eltávolítottam az elavult elemeket, és címsorokkal tagolt szerkezetet adtam neki. Ez gyorsabb volt, mint nulláról újraírni.

Az interaktív módot, amelyben a /init az AGENTS.md fájlt is beolvassa, egy környezeti változóval lehet bekapcsolni:

CLAUDE_CODE_NEW_INIT=1 claude

Miután elindul a /init, a Claude pontosító kérdések sorát teszi fel: mely elemeket kell konfigurálni (CLAUDE.md, skills, hooks), milyen technológiai stackkel dolgozik a projekt, és mely parancsokat kell használni a teszteléshez. Ezután egy alügynök feltérképezi a kódbázist—elolvassa a package.json, a README.md és a konfigurációs fájlok tartalmát—, majd kiegészíti a hiányzó részeket. Végül egy javaslatot mutat, amelyet mentés előtt szerkeszthetsz. A projekt indításakor történő Claude Code-konfigurálásról bővebben a külön útmutatóban olvashatsz.

Most pedig a hátrány. Ha a projektben már van egy aktív AGENTS.md, a /init mellé létrehoz egy CLAUDE.md fájlt, amely az abban lévő szabályok másolatát tartalmazza. Ettől kezdve a Claude Code alapértelmezés szerint csak a CLAUDE.md fájlt olvassa, így ismét két hiteles forrásod lesz: te frissíted az AGENTS.md fájlt, a Claude pedig továbbra is a régi másolat alapján dolgozik. A /import parancs hasonlót csinál: egyszeri másolatként hozzáfűzi az AGENTS.md tartalmát a CLAUDE.md fájlhoz. Ha egyetlen forrást akarsz fenntartani, a /init után tedd az @AGENTS.md importot a CLAUDE.md első sorába, és törölj belőle mindent, ami megismétli az AGENTS.md tartalmát.

A /init megfelelő kiindulópont egy új projekthez, vagy olyanhoz, amelyet a Cursorról vagy a Copilotról helyezel át. Nem kell az interneten keresgélned „a legjobb CLAUDE.md-sablont”—az Anthropic már figyelembe veszi a repó tartalmát. Ha a projektben már van aktív AGENTS.md, és nincsenek Claude-specifikus szabályok, nincs szükség a /init parancsra: a Claude Code önállóan beolvassa az AGENTS.md fájlt.

Hogyan válaszd külön a közös és a Claude-specifikus utasításokat?#

Én ezt az elvet követve választom szét őket. A közös szabályok, amelyek az AGENTS.md fájlba kerülnek:

• Mihez nem szabad nyúlni a kódban. A .env, node_modules, prisma/migrations mappákhoz (csak a prisma migrate paranccsal), a .next/ és a .git/ könyvtárhoz.
• Az elemek elnevezése. Ágak: feat/, fix/, chore/ előtagok. Commitok: feat:, fix:, docs: előtag és egy rövid leírás. A komponensfájlok elnevezése kebab-case legyen.
• Teszt- és lintparancsok. npm run build, npm run lint, npm test. Melyik parancsot kell lefuttatni a git push előtt.
• Architekturális alapelvek. Mi kerüljön a src/lib/ és a src/components/ könyvtárba, hol legyen az üzleti logika, és hol a felhasználói felület.
• Biztonság. Soha ne commitolj titkokat. Az éles adatbázist csak a prod-psql segítségével érd el. Éles rendszerhez SSH-n csak a prod aliason keresztül csatlakozz, ne a root@IP címen.

A Claude-specifikus szabályok, amelyek a CLAUDE.md fájlba kerülnek (az @AGENTS.md alá):

• Plan mode. Használj plan mode-ot a kockázatos könyvtárakban végzett módosításokhoz (például src/billing/).
• Erőfeszítési szint. Architektúrafeladatokhoz használj --effort high, a szokásos munkához pedig medium értéket.
• Skills. Melyik helyzetben melyik AI-ügynököt és skillt kell futtatni. Például: „útmutató készítésekor futtasd a build-masterskaya-guide skillt”.
• Claude-memória. Mi kerüljön az automatikus memóriába, és mi a CLAUDE.local.md fájlba. A Claude memóriájáról bővebben a Memória és CLAUDE.md című útmutatóban olvashatsz.
• Hooks. Ha a .claude/settings.json fájlban hookok vannak beállítva, írd le a CLAUDE.md fájlban, mit csinálnak (a Codex és a Cursor nem tud róluk, és nincs is rá szükségük).
• Skills és parancsok. Az általam gyakran használt slash parancsok listája (/init, /cd, /memory, /plan).

A határ nem mindig egyértelmű. Például a „soha ne futtasd a git push --force parancsot a main ágra” egyértelműen közös szabály, ezért az AGENTS.md fájlba való. A „hot ágra történő git push előtt először használj plan mode-ot” viszont Claude Code-specifikus, így a CLAUDE.md fájlba kerül. A próba a következő: „Ha holnap eltávolítanám a Claude Code-ot, és csak a Codex maradna, továbbra is érvényes lenne ez a szabály?” Ha igen, kerüljön az AGENTS.md fájlba. Ha nem, kerüljön a CLAUDE.md fájlba.

Mi kerüljön az AGENTS.md, és mi a CLAUDE.md vagy a .claude/rules fájlba?#

Ha a szabályok száma meghaladja a 200 sort, ideje szétbontani őket. Az Anthropic dokumentációja fájlonként körülbelül 200 soros célt javasol, mert a hosszú CLAUDE.md fájlok esetén csendben romlik a szabálykövetés: úgy tűnik, a Claude beolvassa őket, de ritkábban tartja be az utasításokat.

Egy nagy projekthez bevált struktúra nálam:

my-project/
├── AGENTS.md                    # 100-150 lines, shared
├── CLAUDE.md                    # 30-50 lines: @AGENTS.md + Claude-only
└── .claude/
    ├── CLAUDE.md                # alternative to root file, same file
    └── rules/
        ├── api.md               # with paths: ['src/api/**']
        ├── components.md        # with paths: ['src/components/**']
        ├── testing.md           # without paths, always active
        └── security.md          # without paths, always active

A .claude/rules/ könyvtár minden fájljához tartozhat frontmatter:

---
paths:
  - "src/api/**/*.ts"
---

# API rules
- Every endpoint validates input with zod
- Errors use the standard `{error, code}` format
- OpenAPI comments are required

A Claude csak akkor tölti be ezeket a szabályokat, ha az adott mintára illeszkedő fájlokon dolgozik. Ha a src/components/Button.tsx fájlt módosítja, az API-szabályok nem kerülnek be a kontextusba. Így a kontextusablakot csak a releváns dolgokra használja fel. A .claude/rules/ könyvtár CLAUDE.md nélkül is működik: ha a projektben csak AGENTS.md van, a szabályai azzal együtt töltődnek be, és nem tiltják le az AGENTS.md közvetlen beolvasását.

A Cursor és a Windsurf ugyanezt a megközelítést támogatja a .cursor/rules/ és a .windsurf/rules/ könyvtárakon keresztül. Az AGENTS.md szabvány hivatkozhat ezekre a könyvtárakra, de az eszközök közötti szintaxis még nem teljesen stabil. Biztonságosabb a közös szabályokat az AGENTS.md fájlban tartani, a csak egyes útvonalakra vonatkozókat pedig megkettőzni a .claude/rules/ és a .cursor/rules/ könyvtárban—ezek ritka kivételek, nem a szabályok zöme.

A CLAUDE.md hasznos helyei (a legszélesebb hatókörtől a legszűkebbig):

A ~/.claude/CLAUDE.md fájl például tartalmazhat két szabályt: „válaszolj a felhasználó által előnyben részesített nyelven” és „az Ailoot nevét pontosan így írd”. Ezek minden projektre vonatkoznak, ezért nem kell mindegyik repóban megismételni őket.

A négy szint közül csak a projektszintű CLAUDE.md és a CLAUDE.local.md tiltja le az AGENTS.md közvetlen beolvasását. A személyes ~/.claude/CLAUDE.md és a felügyelt szabályzat nem akadályozza ezt; a Claude Code az AGENTS.md fájllal együtt olvassa be őket.

Mit tegyél, ha a projekted AGENTS.md fájlja már elavult?#

A leírt projektben volt egy 2025 májusából származó AGENTS.md fájlom—180 sor, sok elavult elemmel (olyan Anthropic API-végpontokat említett, amelyek azóta megváltoztak; már nem létező claude --tools szintaxissal hozott példákat; és az elavult struktúrájú ~/.claude/projects/ könyvtárra vonatkozó szabályokat tartalmazott).

Ezt a tervet használtam a frissítéséhez:

1. Nézd át a claude paranccsal, plan mode-ban. Megnyitom a repót, lefuttatom a claude --safe-mode parancsot, és ezt kérem: “Olvasd át újra az AGENTS.md fájlt, és javasold az elavult vagy ismétlődő elemek listáját. Ne szerkeszd; csak sorold fel őket.” Két perc alatt kaptam egy 23 elemből álló listát, amelyet át kellett nézni.
2. Távolítsd el a nyilvánvalóan elavult elemeket. A 23 elem közül 9 egyértelműen elavult volt—parancsszintaxis, végpontok és kapcsolónevek. Töröltem ezeket a sorokat.
3. Vond össze az ismétléseket. További 6 elem ugyanazt ismételte eltérő megfogalmazásban („ne használj force-push-t”, „soha ne használd a --force kapcsolót”, „kerüld a git push -f parancsot”). Egyetlen sorba vontam össze őket.
4. Vegyél fel új elemeket. Hozzáadtam azokat a dolgokat, amelyeket az elmúlt hónapban rendszeresen rosszul csinált a Claude/Codex, az „egy sor minden hibamintához” szabályt követve. Ez 8 új elemet eredményezett.
5. Kérj meg egy alügynököt a végső ellenőrzésre. Megkértem Claude-ot, hogy keresse meg az ellentmondásokat, a kétértelműségeket és az ismétléseket. Három olyan megfogalmazást talált, amelyen lehetett pontosítani. Javítottam őket.

Egy óra elteltével az AGENTS.md 110 soros, naprakész lett, és minden sorát személyesen ismertem. Könnyű volt belőle egy 30 soros CLAUDE.md fájlt összeállítani. A Codex is észrevehetően körültekintőbben kezelte a teszteket ezután—arra gyanakszom, hogy néhány „furcsa” döntése olyan elavult szabályokból eredt, amelyeket jóhiszeműen követett.

A folyamatosan karbantartott AGENTS.md fő alapelvei:

• Minden szabály egy visszatérő hibára válaszoljon. Ha egy hónap alatt egyszer sem jutott eszembe egy szabály, nincs értelme megtartani.
• A szabályokat parancsként írd meg, ne elméletként. A „Használj két szóközt” szabály. A „Legyen rendezett a kódstílus” nem az.
• A konkrétum jobb az általánosságnál. A „Futtasd a npm run build parancsot a git push előtt” szabály. A „Teszteld a módosításaidat” nem az.

Mi az, ami biztosan NEM működik ezzel a beállítással?#

Néhány dolog, amit hat hónap alatt, ezzel a beállítással dolgozva, nehezen tanultam meg:

1. A Cursor automatikus kiegészítése nem használja az AGENTS.md fájlt. Amikor a Cursor egy sor kiegészítését javasolja a szerkesztőben, nem olvassa valós időben az AGENTS.md fájlt—külön gyors motor dolgozik a háttérben. Az AGENTS.md szabályai csak akkor számítanak, amikor chatkérést küldesz a Cursoron belül. Ez azt jelenti, hogy az AGENTS.md fájlban megadott „ne használj var-t, használj const-ot” szabály nem befolyásolja az automatikus kiegészítést; ezt az ESLint vagy a TypeScript konfigurációján keresztül kell beállítanod.

2. Az AGENTS.md fájlban megadott Claude Code-hookok nem működnek a Codexszel. Ha a .claude/settings.json fájlban van egy adott művelet letiltására beállított PreToolUse hook, ez az információ csak Claude számára hasznos. A Codex nem ismeri a hookokat; számára ez úgy hangzik, hogy „az eszköz döntse el maga”. Érdemes az AGENTS.md fájlba írni, hogy „ne tedd meg az X-et”, az import alatti CLAUDE.md fájlba pedig azt, hogy „van egy hook, amely fizikailag blokkolja az X-et”.

3. Copilot és .github/copilot-instructions.md. A GitHub Copilot a saját fájlját olvassa, és továbbra sem olvassa túl jól az AGENTS.md fájlt. Ha a csapatod aktívan használja a Copilotot, vagy adj hozzá egy külön .github/copilot-instructions.md fájlt a szabályok rövidített változatával, vagy használj olyan Copilot Extensions bővítményt, amely ismeri az AGENTS.md fájlt. Ez gyorsan változik, így három-hat hónap múlva már más lehet a helyzet.

4. A Git nem a CLAUDE.md módosításaként követi a szimbolikus hivatkozást. Ha lefuttatod az ln -s AGENTS.md CLAUDE.md parancsot, majd egy héttel később frissíted az AGENTS.md fájlt, a Git csak az AGENTS.md fájl diffjét mutatja. Ez normális, de a PR-t ellenőrző kolléga nem biztos, hogy észreveszi: a CLAUDE.md is frissült a szimbolikus hivatkozáson keresztül. A megoldás: írd bele kifejezetten a PR leírásába: „frissítettük az AGENTS.md fájlt; a Claude Code ugyanazt a fájlt látja a szimbolikus hivatkozáson keresztül”.

5. A mélyen egymásba ágyazott importokat nehéz hibakeresni. Ha az AGENTS.md importálja az @docs/coding-style.md fájlt, az pedig az @docs/typescript.md fájlt, és egyes szabályok ütköznek, nehéz megtalálni a hibát. Az importokat egy szintre korlátozom (CLAUDE.md → AGENTS.md), és nem ágyazom őket mélyebbre. Az Anthropic egy InstructionsLoaded hookot biztosít a betöltött fájlok naplózására—ez hasznos a réteges beállítások hibakereséséhez. Megjegyzés: a hook aktiválódik az importtal vagy szimbolikus hivatkozással beillesztett AGENTS.md fájlnál, annál viszont nem, amelyet a Claude Code önállóan olvasott be.

Egy teljes vibe coding összeállítás egy estére: AI-klón + Második Agy + kontextustervezés.

Ismerd meg az Ailootot.