# Egyetlen utasításfájl a Claude Code, a Codex és a Cursor számára 2026-ban
> Egyetlen hiteles forrás a Claude Code, a Codex és a Cursor számára 2026-ban: mikor olvassa be a Claude Code önállóan az AGENTS.md fájlt, az @AGENTS.md importálása a CLAUDE.md fájlba, a szimbolikus hivatkozás és az /init.
Source: https://ailoot.ai/blog/hu/agents-md-claude-md-one-instruction-file/
Canonical: https://ailoot.ai/blog/hu/agents-md-claude-md-one-instruction-file/
Language: hu
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-004
Revision: sha256-7c7b28c2962a08a2f48c0c5e6c933e30922485b48a9c6326ee922c9746edb59c
A szolgáltatással kapcsolatos információkért lásd az [Ailoot dokumentációját](https://ailoot.ai/docs/).
## Mi változik, ha együtt használod a Claude Code-ot, a Codexet és a Cursort?
Fő tanulság
2026-ban egy tipikus vibe coder beállítása nem egy, hanem 3–5 eszközből áll. A Claude Code a fő eszköz, a Codex a hosszú, önálló feladatokhoz, a Cursor pedig a gyors IDE-szerkesztésekhez. Mindegyiknek saját utasításfájlja van: `CLAUDE.md`, `AGENTS.md`, `.cursorrules`. Ha ezeket kézzel tartod szinkronban, ugyanazt a sort öt helyen szerkeszted, elfelejted frissíteni a Cursort, és egy hét múlva a Claude és a Codex ugyanarra a promptra eltérő eredményt ad.
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](https://ailoot.ai/blog/hu/claude-code-codex-together/) 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?
Fő tanulság
Igen, a 2026. szeptember 18-án kiadott 2.1.277-es verziótól, de csak akkor, ha a munkakönyvtárban vagy annak valamelyik szülőkönyvtárában nincs `CLAUDE.md`, `.claude/CLAUDE.md` vagy `CLAUDE.local.md`. Ha létezik `CLAUDE.md`, a Claude Code alapértelmezés szerint csak azt a fájlt olvassa be; az `AGENTS.md` fájlt a `CLAUDE.md` fájlban szereplő `@AGENTS.md` sorral vagy szimbolikus hivatkozással lehet hozzáadni. A viselkedés a `/config` Project instructions beállításánál módosítható. Szeptember előtt a Claude Code egyáltalán nem olvasta be az `AGENTS.md` fájlt, így az import volt az egyetlen megoldás.
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:
A Claude Code képes az AGENTS.md fájlt projektutasításként beolvasni, így a más ügynökökhöz már beállított adattár CLAUDE.md, import vagy konfiguráció nélkül is működik.
— Anthropic, https://code.claude.com/docs/en/memory#agents-md
Az, hogy pontosan mit olvas be a Claude Code, a projektben található fájloktól függ:
| Fájlok a projektben | Mit olvas be a Claude Code |
|----|----|
| `AGENTS.md`, és nincs `CLAUDE.md` vagy `CLAUDE.local.md` a munkakönyvtárban vagy annak szülőkönyvtárában | `AGENTS.md` |
| `AGENTS.md` és `CLAUDE.md` (vagy `CLAUDE.local.md`) a munkakönyvtárban vagy annak szülőkönyvtárában | Csak a `CLAUDE.md` fájlt |
| `CLAUDE.md` az `@AGENTS.md` sorral | `CLAUDE.md`, benne az importon keresztül az `AGENTS.md` fájllal |
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ó:
| Beállítás | Mit olvas be a Claude Code |
|----|----|
| `claude-md-or-agents-md` (alapértelmezett) | `CLAUDE.md`, vagy ha sem ez, sem `CLAUDE.local.md` nem létezik, akkor `AGENTS.md` |
| `claude-md-and-agents-md` | Mindkét fájl: minden könyvtárban először `CLAUDE.md`, majd `AGENTS.md` |
| `claude-md` | Csak a `CLAUDE.md` fájlt |
| `managed-only` | Csak a vállalati felügyelt `CLAUDE.md` fájlt és az automatikus memóriát |
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?
Fő tanulság
Import akkor kell, ha a projektben van `CLAUDE.md`: ha létezik ilyen fájl, a Claude Code alapértelmezés szerint nem olvassa be önállóan az `AGENTS.md` fájlt. A beállításhoz írd az `@AGENTS.md` sort a `CLAUDE.md` fájl tetejére. Amikor a Claude Code munkamenetet indít, az `AGENTS.md` tartalmát a sor helyére illeszti, és az eredményt egyetlen szövegként olvassa be. Az import alá felvehetsz egy „Claude Code” szakaszt a kizárólag Claude-ra vonatkozó szabályokkal. Az importok relatív és abszolút elérési utakkal is működnek, és legfeljebb négy szinten ágyazhatók egymásba.
Egy minimális, működő példa a hivatalos dokumentációból:
```markdown
@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:
A CLAUDE.md fájlok a @path/to/import szintaxissal további fájlokat importálhatnak. Az importált fájlok a munkamenet indulásakor kibontva, a rájuk hivatkozó CLAUDE.md fájllal együtt töltődnek be a kontextusba.
— Anthropic, https://code.claude.com/docs/en/memory
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?
Fő tanulság
Az Anthropic két megoldást kínál: import az `@AGENTS.md` használatával vagy szimbolikus hivatkozás a `ln -s AGENTS.md CLAUDE.md` paranccsal. A szimbolikus hivatkozás egyszerűbb—csupán egy alias, és nem igényel fájlmódosítást. Három hátránya van: Windowson rendszergazdai jogosultság kell hozzá, nem adhatsz Claude-specifikus szabályokat a `CLAUDE.md` fájlhoz, és a Git néha szemétként jeleníti meg a szimbolikus hivatkozást a diffben. Az import univerzális megoldás. Ha nincsenek kifejezetten Claude-ra vonatkozó szabályaid, a 2.1.277-es verziótól egyikre sincs szükség: a Claude Code önállóan beolvassa az `AGENTS.md` fájlt.
A dokumentáció így mutatja be a szimbolikus hivatkozás létrehozását:
```bash
ln -s AGENTS.md CLAUDE.md
```
Ezután rögtön őszinte figyelmeztetést ad a Windowsról:
Ha te vagy a repót klónozó bárki Windowst használ, alkalmazd az @AGENTS.md importot. A szimbolikus hivatkozás létrehozásához rendszergazdai jogosultság vagy Developer Mode szükséges, a core.symlinks engedélyezése nélkül futó Git pedig a commitolt hivatkozást egyszerű szöveges fájlként tölti le, így az utasítások helyett egyetlen CLAUDE.md sort kapsz.
— Anthropic, https://code.claude.com/docs/en/memory
Összehasonlító táblázat:
| Szempont | `@AGENTS.md` import | `ln -s` szimbolikus hivatkozás |
|----|----|----|
| **Működik Windowson rendszergazdai jogosultság nélkül** | igen | nem (Developer Mode szükséges) |
| **Adható hozzá csak Claude-ra vonatkozó szabály** | igen, az import után | nem, a fájl azonos |
| **Közönséges markdownként jelenik meg a Gitben** | igen | hivatkozásként (a `core.symlinks` beállítástól függ) |
| **Több fájl importálható** | igen, legfeljebb négy szinten keresztül | nem, egy az egyhez |
| **Gyorsítótárazás/érvénytelenítés a Claude Code-ban** | szabványos a CLAUDE.md esetén | működik, de a szimbolikus hivatkozások meta-buktatókat rejtenek |
| **Alapértelmezett választás** | mindenkinek megfelelő | csak akkor, ha nem számít a platformfüggetlen használat |
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](https://ailoot.ai/blog/hu/claude-code-safe-mode-recovery/) 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?
Fő tanulság
Mindegyik eszköz a saját fájlját olvassa be, néha többet is. A Claude Code a `CLAUDE.md` fájlt olvassa, és 2026 szeptembere óta az `AGENTS.md` fájlt is, ha nincs `CLAUDE.md` a projektben. A Codex CLI az `AGENTS.md` és az `AGENTS.override.md` fájlt olvassa. A Cursor a régebbi `.cursorrules` formátumot vagy az újabb `.cursor/rules/*.mdc` formátumot olvassa, és 2026 nyara óta az `AGENTS.md` fájlt is. A Copilot a `.github/copilot-instructions.md` vagy a `.github/instructions/*.instructions.md` fájlt olvassa. A Windsurf a régebbi `.windsurfrules` vagy az újabb `.windsurf/rules/` útvonalat olvassa. A Gemini CLI a `GEMINI.md` fájlt olvassa. Az Aider és a Cline már átvette az `AGENTS.md` használatát.
A hét fő eszköz áttekintése (az eszközök hivatalos dokumentációja alapján):
| Eszköz | Fő utasításfájl | Alternatívák | Beolvassa az AGENTS.md fájlt? |
|----|----|----|----|
| **Claude Code** | `CLAUDE.md` | `~/.claude/CLAUDE.md`, `./.claude/CLAUDE.md`, felügyelt szabályzat | igen, ha a projektben nincs `CLAUDE.md` (a 2.1.277-es verzió óta), egyébként importon keresztül |
| **Codex CLI** (OpenAI) | `AGENTS.md` | `AGENTS.override.md` | igen (natívan) |
| **Cursor** | `.cursor/rules/*.mdc` | `.cursorrules` (elavult) | igen |
| **GitHub Copilot** | `.github/copilot-instructions.md` | `.github/instructions/*.instructions.md` | bővítményeken keresztül |
| **Windsurf** | `.windsurf/rules/` | `.windsurfrules` (elavult) | igen |
| **Gemini CLI** | `GEMINI.md` | \- | nem |
| **Aider, Cline, opencode** | `AGENTS.md` | \- | igen (natívan) |
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?
Fő tanulság
A `/init` a repó meglévő tartalmából állítja elő a `CLAUDE.md` fájlt, és 20–30 perc kézi munkát takarít meg. Alapértelmezés szerint átveszi a Cursor szabályait (`.cursor/rules/`, `.cursorrules`) és a Copilot szabályait (`.github/copilot-instructions.md`), míg az `AGENTS.md`, a `.windsurfrules` és a `.clinerules` fájlokat `CLAUDE_CODE_NEW_INIT=1` módban olvassa be. Ugyanez a mód interaktív, többfázisú folyamatot indít: kérdéseket tesz fel, egy alügynökkel feltérképezi a kódot, majd írás előtt tervet javasol. 2026 szeptembere óta a `/init` hátránnyal jár az `AGENTS.md` fájlt tartalmazó projekteknél: az új `CLAUDE.md` letiltja az `AGENTS.md` közvetlen beolvasását, így a szabályok két fájlba kerülnek.
Az Anthropic így írja le a `/init` parancsot a dokumentációban:
A /init futtatása beolvassa a többi eszköz utasításfájljait, és áthelyezi a releváns részeket a létrehozott CLAUDE.md fájlba: a Cursor szabályait a .cursor/rules/ vagy a .cursorrules fájlból, a Copilot szabályait a .github/copilot-instructions.md fájlból, továbbá CLAUDE_CODE_NEW_INIT=1 esetén az AGENTS.md, a .devin/rules/, a .windsurf/rules/ vagy a .windsurfrules fájlból, valamint a .clinerules fájlból is.
— Anthropic, https://code.claude.com/docs/en/memory
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:
```bash
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](https://ailoot.ai/blog/hu/spec-kit-claude-code-spec-vezere-fejlesztes/) 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?
Fő tanulság
Azokat a szabályokat, amelyeket bármelyik AI-ügynök megért, tedd az `AGENTS.md` fájlba: mihez nem szabad nyúlni, hogyan kell elnevezni az ágakat, hogy a `.env` titkot tartalmaz, és mely parancsokat kell használni a teszteléshez. A Claude Code-ra jellemző szabályok kerüljenek a `CLAUDE.md` fájlba (az import alá): plan mode, skills, hooks, skillhivatkozások és a verzióhoz kötött modellnevek. A különbség egyszerű: ha egy szabály úgy kezdődik, hogy „A Claude tegye ezt”, akkor a `CLAUDE.md` fájlba való. Ha úgy kezdődik, hogy „Az eszköz tegye ezt”, akkor az `AGENTS.md` fájlba.
É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](https://ailoot.ai/blog/hu/claude-memory-claude-md-auto-memory/) 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?
Fő tanulság
Egy nagy projekthez nem elég egyetlen `AGENTS.md`—túl nagyra nő, és minden ügynök fölösleges anyagot hoz be a kontextusába. A megoldás egy `.claude/rules/` könyvtár, külön fájlokkal témánként, valamint útvonalalapú aktiváláshoz YAML frontmatter `paths:` mezőkkel. Például egy API-szabály csak akkor érvényes, ha a Claude a `src/api/` könyvtárban dolgozik. Ezzel sok helyet takarítasz meg a kontextusablakban. A Cursor megfelelője a `.cursor/rules/`, a Windsurfé pedig a `.windsurf/rules/`.
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:
```markdown
---
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):
| Szint | Hely | Cél |
|----|----|----|
| **Felügyelt szabályzat** | `/Library/Application Support/ClaudeCode/CLAUDE.md` (Mac), `/etc/claude-code/CLAUDE.md` (Linux) | Vállalati szabályok, IT/DevOps |
| **Felhasználó** | `~/.claude/CLAUDE.md` | Személyes preferenciák minden projekthez |
| **Projekt** | `./CLAUDE.md` vagy `./.claude/CLAUDE.md` | Projektcsapat szabályai |
| **Helyi** | `./CLAUDE.local.md` (a `.gitignore` fájlban) | Személyes preferenciák egy adott projekthez |
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?
Fő tanulság
Ha az `AGENTS.md` fájlt még 2025-ben állították össze a Codex vagy az Aider számára, és azóta nem szerkesztették, nyisd meg a projektet a Claude Code-ban, és kérd meg Claude-ot a fájl átszerkesztésére. Az AGENTS.md folyamatosan változó dokumentum; a Linux Foundation specifikációja frissül. A naprakészen tartás fő szabálya: minden szabálynak arra kell válaszolnia, hogy „Mit unok már folyton elismételni a Claude-nak/Codexnek?” Ha nem válaszol erre, archiváld.
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?
Fő tanulság
Az `@AGENTS.md` importálása nem teszi egyformává a különböző eszközök viselkedését. Mindegyiknek megvannak a sajátosságai: a Codex CLI nem ismeri a `.claude/rules/` könyvtárat és a hookokat. A Cursor saját automatikus kiegészítő motorral rendelkezik, amely szövegkiegészítés közben nem olvassa a CLAUDE.md fájlt. A Copilot a `.github/copilot-instructions.md` fájlt követi, és önmagában az AGENTS.md szabályai nem elegendők neki. Ez nem azt jelenti, hogy „egy fájl = egyféle viselkedés”, hanem azt, hogy „egy forrás tartalmazza az alapszabályokat, majd minden eszköz megkapja a saját kiegészítéseit”.
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](https://github.com/marketplace?type=apps&category=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.
### Források
- [Claude Code memóriadokumentáció - az AGENTS.md szakasz](https://code.claude.com/docs/en/memory#agents-md) - mikor olvassa be önállóan a Claude Code az AGENTS.md fájlt, a Project instructions beállításai, az importok és szimbolikus hivatkozások, valamint a `/init` működése.
- [Claude Code memóriadokumentáció - további fájlok importálása](https://code.claude.com/docs/en/memory#import-additional-files) - az `@path/to/file` szintaxis, a négyszintű mélység, valamint a relatív és abszolút elérési utak.
- [agents.md - Linux Foundation-szabvány](https://agents.md/) - az AGENTS.md hivatalos szabványa és az azt támogató eszközök listája.
- [Cursor Rules dokumentáció](https://docs.cursor.com/context/rules-for-ai) - mit olvas be a Cursor (`.cursor/rules/*.mdc`, AGENTS.md).
- [GitHub Copilot egyéni utasításai](https://docs.github.com/en/copilot/customizing-copilot/adding-custom-instructions-for-github-copilot) - a `.github/copilot-instructions.md` formátuma.
- [AGENTS.md specifikáció a Linux Foundation oldalán](https://aaif.io/projects/agents-md/) - folyamatosan változó specifikáció.
Egy teljes vibe coding összeállítás egy estére: **AI-klón + Második Agy + kontextustervezés**.
Ismerd meg az [Ailootot](https://ailoot.ai/).
## Kérdések és válaszok: Egyetlen utasításfájl a Claude Code, a Codex és a Cursor számára 2026-ban
### Mikor használjak importot symlink helyett?
Ha Claude-specifikus kiegészítés kell vagy a csapattársak Windowst használnak, a CLAUDE.md-ben @AGENTS.md importot használj. A symlink mindkét nevet azonos tartalomra irányítja, ezért külön Claude-rész nem fér bele.
### Hogyan ellenőrizzem a közös utasítások betöltését?
Futtasd a /memory parancsot, és nézd meg az utasításfájlokat. Ha konfigurációdban a CLAUDE.md vagy CLAUDE.local.md elnyomja az AGENTS.md közvetlen betöltését, adj importot vagy válaszd mindkettő betöltését, majd indíts friss munkamenetet.
## 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.