# A CLAUDE.md beállítása 2026-ban: sablon és 6 szabály > Használatra kész CLAUDE.md-sablon, 6 szabály a fájl karbantartásához, valamint egy aktív vállalkozásban használt fájl elemzése. Hivatalos Anthropic-idézetekkel. Source: https://ailoot.ai/blog/hu/claude-md-template/ Canonical: https://ailoot.ai/blog/hu/claude-md-template/ Language: hu Publisher: Ailoot (https://ailoot.ai/) Translation: guide-126 Revision: sha256-83379f50752ae7d66472ca71361db651153527e5bc8539b7fc786cf128a4c357
Fő tanulság A CLAUDE.md egy projekt gyökerében található szövegfájl, amelyet a Claude Code minden munkamenet kezdetén elolvas. Nélküle az ügynök minden alkalommal elölről kezdi: 5-10 percet töltesz azzal, hogy elmondod: „Szia, ezen a projekten dolgozom, ez a közönségem, és ilyen a stílusom.” Egy tömör kezdőfájl gyakran 100-200 sort céloz; ez felülvizsgálati irányelv, nem technikai plafon. A sablon 6 szakaszt tartalmaz (leírás, eszközök, struktúra, fájlútvonalak, szabályok és nyelv), és minden alkalommal frissül, amikor Claude hibázik. Ez a cikk egy használatra kész sablont, 6 szabályt, egy aktív vállalkozás munkafájljának elemzését és egy 12 pontos audit-ellenőrzőlistát tartalmaz.
Anyagok a vibe codingról: eszközök, esettanulmányok, hibák. [Ailoot útmutatók](https://ailoot.ai/docs/).
[Ailoot útmutatók](https://ailoot.ai/docs/)
## Miért van szükséged CLAUDE.md-re, és miért felejti el Claude nélküle a projektet?
Fő tanulság A Claude Code-ban minden új csevegés üres kontextussal indul. A CLAUDE.md az egyetlen fájl, amelyet Claude automatikusan betölt minden új munkamenetbe. Nélküle az ügynök úgy dolgozik, mint egy első munkanapját töltő gyakornok: semmit sem tud a vállalkozásodról, a stílusodról vagy a szabályaidról. Ezzel a fájllal úgy dolgozik, mint egy második éve ott dolgozó munkatárs.
Kedden megnyitod a Claude Code-ot, és elmagyarázod: „Ezen a projekten dolgozom, ezek az eszközök, ezt ne csináld.” Működik. Csütörtökre az a csevegés már véget ért, ezért mindent megismételsz. Szombaton újra; hétfőn még egyszer. Ilyen CLAUDE.md nélküli ügynökkel dolgozni: minden új ablak egy üres lappal induló gyakornok, akinek újra és újra ugyanazt kell elmondanod. Régebben minden munkamenet elején 5-10 percet töltöttem ezzel a bevezetővel. A promptok egyre hosszabbak lettek, mert minden kontextust kézzel kellett megadnom. Az eredmény mégis általános maradt: az ügynök nem ismerte a közönségemet, a gazdasági hátteremet vagy az elveimet.
Megjegyzés Ez nem a modell memóriájának problémája. Az architektúrából fakad. A Claude Code szándékosan tiszta kontextussal indul minden munkamenetben; különben összekeverednének az ugyanazon a számítógépen lévő különböző projektek. A CLAUDE.md az a mechanizmus, amellyel megmondhatod az ügynöknek, mit töltsön be.
Egy folyamatosan karbantartott CLAUDE.md-vel eltűnik a bevezető kör. Minden szabály, amelyet korábban minden csevegésben megismételtél, egyetlen fájlba kerül, és automatikusan megjelenik minden munkamenet elején. A prompt rövid lesz: „csináld meg az X-et”, ahelyett, hogy „az Y projekten dolgozom, a Z eszközöket használjuk, ne csináld az A-t vagy a B-t, és egyébként a C-re is emlékezz”. Ezzel megszűnnek az ismétlődő hibák. Minden ügynöki hiba ok arra, hogy egy sort adj a CLAUDE.md-hez. Egy hónap múlva már élő „projektalkotmányod” van, Claude pedig nem esik bele újra és újra ugyanazokba az ismerős csapdákba. Van egy harmadik réteg is: az ügynök többé nem légüres térben ír. A `CLAUDE.md` segítségével olyan mappákba irányítom Claude-ot, amelyekben háttér-információ található: hol keresse a közönséggel, az árazással és a márkával kapcsolatos adatokat. E nélkül az irányítás nélkül az ügynök „minőségi megoldásokat” ír anélkül, hogy ismerné a gazdasági hátteremet, ezért az eredmény elvont, sablonos és „pont olyan, mint mindenki másé”. ## Mi az a CLAUDE.md, és milyen sorrendben olvassa Claude?
Fő tanulság A CLAUDE.md Markdown-formátumú szövegfájl. A Claude Code egyszerre négy helyen keresi: rendszerszinten, felhasználói szinten, a projekt gyökerében és a helyi jegyzetek között. Mind a négy bekerül a kontextusba minden munkamenet kezdetén. A fájlnév megkülönbözteti a kis- és nagybetűket: mindig nagybetűkkel írd, hogy `CLAUDE.md`.
Az Anthropic így írja le a CLAUDE.md-t a hivatalos dokumentációjában:
A CLAUDE.md fájlok olyan Markdown-fájlok, amelyek állandó utasításokat adnak Claude-nak a projekthez, a személyes munkafolyamatodhoz vagy az egész szervezetedhez. Egyszerű szövegként írod őket, Claude pedig minden munkamenet kezdetén elolvassa.
— Anthropic, code.claude.com/docs/en/memory
A Claude Code az alábbi négy helyen keresi a CLAUDE.md-t, növekvő prioritási sorrendben: | Szint | Hely | Rendeltetés | |----|----|----| | **Szervezet** | `/Library/Application Support/ClaudeCode/CLAUDE.md` Macen, `/etc/claude-code/CLAUDE.md` Linuxon | A vállalati adminisztrátor által MDM-en keresztül a teljes csapatra telepített szabályok. Magánszemélyként nincs rá szükséged. | | **Felhasználó** | `~/.claude/CLAUDE.md` | Személyes szabályok, amelyek minden projektedre érvényesek. „Mindig a felhasználó által előnyben részesített nyelven válaszolj”, „ne használj gondolatjelet.” | | **Projekt** | `./CLAUDE.md` a projekt gyökerében vagy `./.claude/CLAUDE.md` | Egy adott projektre vonatkozó szabályok: eszközök, mappastruktúra, üzleti logika. Ezt a fájlt commitoljuk a gitbe. | | **Helyi** | `./CLAUDE.local.md` | Személyes jegyzetek ehhez a projekthez, amelyeket nem kell betenni a gitbe. Például ideiglenes kísérletek vagy olyan személyes preferenciák, amelyekre a csapatnak nincs szüksége. | Mind a négy fájl egyszerre töltődik be a kontextusba. Ha a szabályok ütköznek, az Anthropic dokumentációja nyíltan kimondja, hogy nem tudni, melyik élvez elsőbbséget; Claude akár véletlenszerűen is választhat közülük. Ezért egyszerűbb minden kritikus dolgot a projekt CLAUDE.md-jében tartani, és kerülni a duplikációkat.
Tipp A fájlnévben a kis- és nagybetűk szigorúan számítanak. Használd a nagybetűs `CLAUDE.md` nevet, így Claude beolvassa. A `claude.md` vagy `Claude.md` fájlt nem fogja beolvasni. Ugyanez érvényes a `CLAUDE.local.md` fájlra is. Ez tipikus hiba azoknál, akik először állítják be a Claude Code-ot: létrehozzák a fájlt, beírják az utasításokat, csodálkoznak, hogy miért nem működik, aztán kiderül, hogy a fájlnév kisbetűs.
Van egy technikai részlet, amelyről szinte senki nem ír, pedig sok furcsa viselkedést megmagyaráz.
A CLAUDE.md tartalma felhasználói üzenetként kerül elküldésre a rendsz prompt után, nem pedig annak részeként. Claude elolvassa és megpróbálja követni, de a szigorú betartás nem garantált.
— Anthropic, code.claude.com/docs/en/memory
Más szóval, a CLAUDE.md szigorú értelemben nem „rendszerprompt”. Ez az első felhasználói üzenet, amelyet Claude lát. A szabályai tehát erős javaslatok, nem törvények. Ha egy szabályt ki kell kényszeríteni, a lefedett eseményhez tesztelt hookot, a szélesebb hozzáférési határhoz pedig jogosultságokat vagy környezeti elkülönítést használj. A hook automatikus futása nem teszi teljessé az ellenőrzéseit. Alább elmagyarázom a `hooks` és a `CLAUDE.md` közötti határt. ## Hogyan írj meg 5 perc alatt egy minimális CLAUDE.md-t (használatra kész sablon)?
Fő tanulság Másold le a sablont, cseréld ki a szögletes zárójelek közötti mezőket, majd mentsd a projekt gyökerébe `CLAUDE.md` néven. Ez elég ahhoz, hogy Claude ne kezdjen minden munkamenetben mindent elölről. Később bővítheted a következő szabály szerint: „minden ügynöki hiba után adj hozzá egy sort”.
Az alábbi sablont több tucat projekten teszteltem. A fájl körülbelül 80-120 soros marad, az Anthropic azon ajánlását követve, hogy érdemes 200 sor alatt maradni. Ezzel a sablonnal adja az ügynök a legértelmesebb eredményeket. ```markdown # [PROJECT NAME] - project navigation This document is the project map. Read it at the start of every session to understand where things are and how to work with them. ## What this project is **[NAME]** - [one sentence: what it is and who it’s for]. [1-2 sentences: what problem it solves and how]. Details are in `business/INDEX.md`. ## Reading order at the start of every session 1. `about-me/INDEX.md` - who I am and how I think 2. `business/INDEX.md` - what we do (product, audience, economics) 3. `CLAUDE.md` (this file) - repo rules, tools, navigation 4. Task area: the relevant file from `business/`, `plans/`, `mastery/` or the feature folder in the code Principle: layer 1 (about me) comes before layer 2 (business) for a reason. First, **who** is thinking, then **about what**. ## Repository structure [NAME]/ ├── CLAUDE.md ← this file, navigation ├── about-me/ ← digital projection of you (how you think, what you value) │ └── INDEX.md ├── business/ ← the business’s second brain │ ├── INDEX.md │ ├── audience/ ← customer profile │ ├── products/ ← products, prices │ ├── goals/ ← goals, metrics │ └── economics/ ← unit economics, revenue ├── plans/ ← technical plans (one plan = one feature) ├── retrospectives/ ← reflections after each session └── (project code) ### Where to find things | What you need | Where to look | |---|---| | Why we’re building the project, and for whom | `business/INDEX.md` | | Target customer, pains, desires | `business/audience/` | | Product, plans, prices | `business/products/` | | Goals and metrics | `business/goals/` | | Economics | `business/economics/` | | Technical plans | `plans/` | ## Tools [INSERT TOOLS - for example: Next.js 14, TypeScript, Tailwind CSS, Prisma + PostgreSQL]. ## Repo rules 1. Never hardcode dynamic data (prices, dates, figures) - get everything from files in `business/` and the LIVE marker. 2. Don’t publish without my explicit command. 3. Before `git push`, run `npm run build` and check that it builds without errors or warnings. 4. Add files by name with `git add`. Never use `git add .` or `git add -A`. 5. Don’t read `.env` in full. To check a variable, use `grep "^VAR=" .env`. ## Big features = a plan in `plans/` Any task lasting more than an hour must be written up as a plan in the `plans/` folder: 1. Filename: `YYYY-MM-DD-feature-name.md`. 2. Divide the plan into phases. Mark each phase `[ ]` or `[x]`. 3. At the end of the plan, add a summary: whether it was fully implemented and what remains. ## End-of-feature cycle After each feature is complete, go through these 5 steps: 1. Find errors → prove them with an example → fix them. 2. What was missed (edge cases, input validation, error handling). 3. Is this a real problem in our project? Check `business/` and `plans/`. 4. Take a fresh look: reread the diff as if you’re seeing it for the first time. 5. Security review. Especially: personal data and third-party materials. ## End-of-session reflection In `retrospectives/YYYY-MM-DD_short-name.md`, record: 1. What the task was. 2. How it was solved. 3. Whether it was solved - yes / no / partially. 4. What could have been done better. 5. What was learned about the user or project. ## Language Always respond in the user’s preferred language. Use hyphens only, not em dashes. ``` Ahhoz, hogy Claude automatikusan kitöltse ezt a sablont a projektedhez, add neki ezt a promptot. Elolvassa a kontextust, és kitölti a szögletes zárójelben lévő mezőket:
Prompt: Töltsd ki a CLAUDE.md-t a projektemhez ``` Hozz létre egy CLAUDE.md fájlt a projekt gyökerében az alábbi sablon alapján: [ILLESZD BE IDE A TELJES FENTI SABLONT] A következőképpen járj el: Olvasd el az about-me/INDEX.md és a business/INDEX.md fájlokat, hogy megértsd a projekt kontextusát és engem, a szerzőt. A mappákban talált információk alapján töltsd ki a sablon összes szögletes zárójelben lévő mezőjét. Ha hiányzik valamilyen információ, tegyél fel nekem tisztázó kérdéseket egyesével, mindegyikhez 3-4 válaszlehetőséggel. Törekedj arra, hogy a létrejött CLAUDE.md 200 sor alatt maradjon. Ha hosszabb, vizsgáld meg az ismétléseket, és a részletes eljárásokat helyezd hivatkozott fájlokba. Őrizd meg a tervezés, a visszatekintés és a repo alapvető szabályait, majd teszteld őket jellemző feladatokon. Mutasd meg a végleges fájlt, és kérdezd meg, min kellene módosítani. Mindig a felhasználó által előnyben részesített nyelven válaszolj. ```
Ha még nincs `about-me/` és `business/` mappád, az sem gond. Claude tisztázó kérdéseket tesz fel, és a rendelkezésre álló információk alapján összeállít egy minimális CLAUDE.md-t. A mappákat később is létrehozhatod, amikor már tudod, mit tegyél beléjük. ## Melyik 6 szabály teszi élő dokumentummá a CLAUDE.md-t?
Fő tanulság Ez a 6 szabály több tucat projekt tapasztalatának összegzése. A CLAUDE.md-t „egy fájlból, amelyet létrehoztunk és elfelejtettünk” olyan működő dokumentummá alakítják, amelyet Claude minden munkamenetben megnéz.
### 1. szabály. Maradjon 200 sor alatt Az Anthropic hivatalos dokumentációja tömören fogalmaz:
Törekedj arra, hogy a CLAUDE.md 200 sor alatt maradjon. A hosszabb fájlok több kontextust használnak fel, és csökkentik az utasítások követésének megbízhatóságát.
— Anthropic, code.claude.com/docs/en/memory
A hosszú CLAUDE.md kétféleképpen dolgozik saját maga ellen. Először is tokeneket éget. Egy 800 soros utasításfájl minden ablakban betöltődik, és minden munkamenetben több ezer tokent használ fel a keretedből. Napi korlátos Pro-előfizetéssel ez érezhetően csökkenti az elérhető munkamenetek számát. Másodszor, a modell elkezdi figyelmen kívül hagyni a szabályokat. A dokumentáció a kontextusfelhasználás csökkentése és az utasításkövetés javítása érdekében 200 sor alatti méretet javasol. Nem állapít meg éles hibahatárt a 201. sornál. Mielőtt eldöntöd, mit helyezz máshová, vizsgáld meg a relevanciát, az ellentmondásokat, a betöltött tokenmennyiséget és a tényleges feladateredményeket.
Figyelmeztetés Ha már 300-500 sornál jársz, ne ess pánikba - oszd szét a tartalmat a mappák között. A részletes szabályokat, például a dizájnrendszerről szólókat, tedd a `business/assets/brand-guidelines.md` fájlba. A CLAUDE.md-ben elég egy soros hivatkozás: „UI-munka közben nézd meg a `business/assets/brand-guidelines.md` fájlt.” Az irányítási elv: a CLAUDE.md tartalomjegyzék, nem könyv.
### 2. szabály. Minden munkamenetet zárj visszatekintéssel Írd bele a CLAUDE.md-be: „Minden munkamenet végén jegyezd fel, mit csináltál és mit tanultál a `retrospectives/YYYY-MM-DD_*.md` fájlba.” Ha hozzáadod ezt a sort, Claude magától visszatekintéssel kezdi zárni a munkameneteket; nem kell külön kérned. Miért érdemes visszatekinteni: - Két hét múlva megnyithatsz egy régi visszatekintést, és felidézheted, miért azt az utat választottad. - Ha egy hónap múlva térsz vissza a projekthez, kéznél lesz a közelmúltbeli döntések térképe. - Ha csapatban dolgozol, egy munkatárs elolvashatja a visszatekintést, és hívás nélkül, 2 perc alatt megértheti az aktuális állapotot. ### 3. szabály. Minden befejezett feladat után készíts commitot Az én CLAUDE.md-m ezt írja: „Minden befejezett feladat után készíts git commitot értelmes üzenettel.” Claude magától elkezdi atomi commitokra bontani a munkát. Ezzel két dolgot nyersz. Először, ha valami elromlik, egyetlen műveletet tudsz visszavonni, nem pedig „mindent, amit ma csináltam”. Másodszor, a commitelőzmények munkanaplóvá válnak, amely megmutatja, mi és milyen sorrendben változott. ### 4. szabály. Mindig nézd meg a `business/` mappát Minden olyan feladatnál, amely ügyfeleket, termékeket vagy szöveget érint, az ügynök először nyissa meg a `business/INDEX.md` fájlt és az abban hivatkozott releváns fájlt. Az én CLAUDE.md-m ezt kifejezetten előírja: „UI- vagy szövegírási munka előtt nézd meg a `business/audience/avatar.md` és a `business/assets/brand-guidelines.md` fájlt.” E szabály nélkül Claude „egy minőségi weboldal általános stílusában” ír szöveget. A szabállyal a szöveg a te stílusodban, a te ügyfelednek készül, a tiltott szavaid nélkül. ### 5. szabály. Minden ügynöki hiba után adj hozzá egy szabályt Ez a legfontosabb szabály, amely életben tartja a CLAUDE.md-t. Néhány példa az én CLAUDE.md-mből, amelyeket konkrét hibák után vettem fel: - „Soha ne commitold mások WIP-fájljait a `git add .` használatával - a fájlokat név szerint vedd fel a staging területre.” - „A `main` ágra történő push előtt ellenőrizd a `git log origin/main..main --oneline` kimenetét - ha nem üres, ne pusholj.” - „Ne találj ki értékeket - a `.env` fájlból vagy a kódból vedd őket. Különösen az URL-eket, felhasználóneveket és tokeneket.” E sorok mindegyike egy konkrét incidens nyoma. Egyszer egy ügynök commitolta egy munkatársam befejezetlen branchét. Egyszer másvalaki nem pusholt commitjait is belefoglaltam. Egyszer pedig egy ügynök kitalált egy nem létező URL-t. Minden hibából szabály lesz, és ugyanazt az önmagunknak okozott sérülést nem szenvedjük el még egyszer. ### 6. szabály. A biztonsági szabályokat a `.claude/settings.json` fájlba tedd, ne a CLAUDE.md-be A CLAUDE.md-ben leírhatod, hogy „ne nyúlj a `.env` fájlhoz”, de ez csak kérés; Claude megszegheti, mert a CLAUDE.md felhasználói üzenetként töltődik be, nem törvényként. A kritikus biztonsági szabályokat a `.claude/settings.json` fájlban kezeld, ahol bizonyos parancsokat szigorúan letilthatsz. A tiltólista, amelyet minden új projekthez hozzáadok: - `rm -rf` (fájlok rekurzív törlése). - A teljes `.env` beolvasása (`Read .env`). - `export` és `curl` ugyanabban a parancsban (külső titokkiszivárogtatásra alkalmas minta). - `git push --force` kifejezett jóváhagyás nélkül.
Figyelmeztetés A különbség egyszerű: a CLAUDE.md szabálya tanács, amelyet az ügynök megszeghet. Az illeszkedő deny-szabály az alkalmazandó jogosultsági folyamatban blokkolja a lefedett műveletet. Ez nem bizonyít védelmet minden egyenértékű parancs, más eszköz vagy eltérő jogosultsági mód ellen. A kritikus biztonsági szabályokat a `settings.json` fájlban tartsd, minden mást pedig a CLAUDE.md-ben.
További útmutatókat az [Ailooton](https://ailoot.ai/docs/) találsz.
[Ailoot útmutatók](https://ailoot.ai/docs/)
## Hogyan épül fel a CLAUDE.md egy aktív vállalkozásnál (egy 280 soros fájl anatómiája)?
Fő tanulság Egy működő online szolgáltatásban használt CLAUDE.md-fájl felépítését elemzem. A fájl körülbelül 280 soros, és 11 szakaszból áll. Megmutatom, mit tartalmaznak az egyes részek és miért. A tényleges szöveget nem teszem közzé, mert működési részleteket tartalmaz. A keretrendszer azonban bármely vállalkozásra alkalmazható.
A legtöbb online CLAUDE.md-példa fejlesztőknek szóló technikai sablon: „Használj TypeScriptet”, „Ne írj 50 sornál hosszabb teszteket.” Egy vállalkozónak az ilyen CLAUDE.md használhatatlan - nem foglalkozik az üzleti oldallal. Alább a működő CLAUDE.md-m felépítése látható. Kivettem belőle a konkrét szabályokat és útvonalakat, mert belső működésemet tükrözik. A szakaszok szerkezete és logikája viszont bármely projektre alkalmazható: helyettesítsd be a saját körülményeidet, és kész a működő fájl. **1. Rövid projektleírás (15 sor).** Mit csinálunk, kiknek szól, milyen termékeket kínálunk. Nem a marketingwebhely összefoglalója, hanem az ügynöknek szóló rövid leírás, hogy megértse, „merre tartunk”. **2. Rólam (10 sor).** Hivatkozás az `about-me/` mappára - annak digitális leképezése, ahogyan gondolkodom. Hangnem, értékek, elvek, tiltott szavak. Ha Claude „a nevemben” ír szöveget, először ezt a mappát olvassa el, hogy a hangvétel egyezzen. **3. A repository felépítése (20 sor).** Megjegyzésekkel ellátott fa: hol van a kód, hol található az üzleti háttér, hol vannak a tervek és visszatekintések. E térkép nélkül Claude minden alkalommal vakon keresi a fájlokat. **4. „Hol találod?” táblázat (25 sor).** Útválasztás a „kérdés → fájl” alapján. Egy ingatlanközvetítő iroda például azt írhatja: „jelzáloghitel feltételei → `business/products/mortgage.md`”, illetve „közösségi bejegyzések hangneme → `business/assets/voice.md`”. Cseréld le a saját fájljaidra. Ez a táblázat a CLAUDE.md szíve. Nélküle az ügynök találgatja, melyik fájl tartalmazza a választ. Vele egyből a forráshoz jut. **5. A projekt alapelvei (40 sor, 10-15 elem).** Ez a szakasz lassan gyarapodik, és a legtöbb munkát igényli. Minden elem egy konkrét hiba nyoma. Egy online áruház szabályai például így szólhatnak: „soha ne hardcode-old az árakat és a szállítási időket”, „ne tegyél közzé terméket kifejezett utasítás nélkül”, „termékoldal közzététele előtt ellenőrizd a stílust a márkaglosszárium alapján”. Ez a rész a „projektalkotmány”. **6. Működési tervezés (20 sor).** Olyan táblázat, amely a „felhasználó megfogalmazása → művelet” párokat rendeli egymáshoz. Például: „Amikor azt mondom, hogy »tervezd meg a hetet«, nyisd meg az `ops/monthly.md` fájlt, és hozd létre a hét fájlját.” Így Claude olyan operációs asszisztenssé válik, amely érti a parancsok kontextusát. **7. Eszközök (5 sor).** Technológiák, röviden, sallang nélkül. **8. Közzététel (15 sor).** A módosítások éles környezetbe történő közzétételének lépésről lépésre követhető folyamata: milyen parancsokat, milyen sorrendben kell futtatni, és mit kell ellenőrizni. Korábban minden alkalommal elmagyaráztam. Most Claude már tudja. **9-12. Biztonság (35 sor).** Négy külön alrész: a `.env` használatának szabályai, hozzáférés az éles adatbázishoz, biztonságos parancsok demókhoz (képernyőfelvételek, közvetítések, képernyőképek, hogy a tokenek ne szivárogjanak ki véletlenül), valamint a titkok cseréjére vonatkozó szabályok. **13. A `plans/` mappa (10 sor).** A terv szabványa: fájlnév, fázisstruktúra és az összefoglaló blokk tartalma. **14. A `retrospectives/` mappa (5 sor).** A visszatekintés szabványa: sablon, fájlnév és elvárt tartalom. **15. Az éles adatbázis adatai (15 sor).** Szabály a „friss adatok” jelölésére: ha egy fájl szerint az adatoknak naprakésznek kell lenniük, az ügynök a forrásból kéri le őket a régi adatok használata helyett. Így elkerülhető, hogy Claude a tegnapi adatokat használja. **16. Nyelv (3 sor).** „Mindig a felhasználó által előnyben részesített nyelven válaszolj. Csak kötőjelet használj, gondolatjelet ne.” Összesen körülbelül 280 sor. Ez meghaladja a tömörségi célértéket, de nem teszi érvénytelenné a fájlt. Ebben a példában továbbra is hasznos maradt; megtartását a mért kontextusfelhasználás és jellemző feladatellenőrzések alapján kell eldönteni. A táblázatok nem automatikusan olcsóbbak tokenben, mint a folyószöveg.
Tipp Az egy év alatt kialakított struktúrám nem dogma. A keret a következő: leírás (1-2 szakasz), struktúra és útvonalak (2-3 szakasz), szabályok/alapelvek (1 nagy szakasz), a vállalkozásodra jellemző működési eljárások (2-3 szakasz), valamint apró részletek (nyelv, kapcsolatok). Töltsd fel a vállalkozásod saját részleteivel. A fő szabály: minden szakasz válaszoljon erre a kérdésre: „Hibázna Claude enélkül?” Ha nem, töröld.
## Mit csinál a `/init` parancs, és miért nem elég?
Fő tanulság A Claude Code `/init` parancsa automatikusan létrehoz egy alapvető CLAUDE.md-fájlt a projekt átvizsgálásával, majd felsorolja az eszközöket és a buildparancsokat. Jó kiindulópont, de üzleti háttér és alapelvek nélkül a fájl technikai és általános marad. Használd a `/init` parancsot első lépésként, majd egészítsd ki kézzel.
Az Anthropic így ismerteti a parancsot a dokumentációjában:
Futtasd az /init parancsot egy kezdő CLAUDE.md automatikus létrehozásához. Claude elemzi a kódodat, és létrehoz egy fájlt a buildparancsokkal, tesztelési utasításokkal és az észlelt projektkonvenciókkal.
— Anthropic, code.claude.com/docs/en/memory
Amiben a `/init` jól teljesít: - Felismeri az eszközöket a `package.json`, a `Cargo.toml` és a `pyproject.toml` fájlokból. - Felsorolja a build- és tesztparancsokat. - Átveszi a meglévő fájlok konvencióit (`.eslintrc`, `.prettierrc`). - Észreveszi a meglévő Cursor-szabályokat (`.cursorrules`, `.cursor/rules/`) és Copilot-szabályokat, majd beemeli a releváns részeket. A `CLAUDE_CODE_NEW_INIT=1` módban az `AGENTS.md`-t is felismeri. Amire a `/init` nem képes: - Nem tudja, ki az ügyfeled. - Nem veszi fel a szövegíráshoz tiltott szavaidat. - Nem hoz létre szabályokat az ügynöki hibákról (mert ilyen még nem történt). - Nem készít „hol találod?” táblázatot az üzleti struktúrádhoz. A helyes munkafolyamat tehát a következő: 1. ### Futtasd a /init parancsot a Claude Code-ban Kapsz egy 30-50 soros kezdő CLAUDE.md-t eszközökkel és parancsokkal. Ez a technikai alap. 2. ### Egészítsd ki a cikk sablonjával Használd „A minimális CLAUDE.md 5 perc alatt” című szakaszt. Adj hozzá navigációs, útvonalválasztási és alapelveket tartalmazó szakaszokat. 3. ### Töltsd ki a szögletes zárójelben lévő mezőket Add Claude-nak a következő promptot: „olvasd el a projektemet, és töltsd ki a sablont”. Ha még nem létezik a `business/` és az `about-me/` mappa, Claude tisztázó kérdéseket tesz fel. 4. ### Végezz stressztesztet Mondd Claude-nak: „Olvasd el a CLAUDE.md-met, és keress 10 kétértelműséget, amely miatt ügynökként félreérthetnél valamit.” Kapsz egy javítási listát. 5. ### Ezután használd a fájlt Minden ügynöki hiba után adj hozzá egy sort. Egy hónap múlva már a vállalkozásodra szabott, folyamatosan karbantartott CLAUDE.md-d lesz. Prompt a negyedik lépéshez:
Prompt: CLAUDE.md stressztesztje ``` Van egy CLAUDE.md fájlom. Holnap ez alapján fogok fejleszteni egy funkciót. A feladatod a fájl stressztesztelése. Keress 10 lehetséges hibaforrást: hol kétértelmű a CLAUDE.md, és hol érthetnéd félre ügynökként hol vannak hiányosságok, amelyek miatt ki kellene találnod dolgokat hol mondanak ellent egymásnak a szabályok hol becsülöm túl, hogy mennyi fér bele egy napba hol becsülöm alá a szükséges munkát (ez még rosszabb) Ne fogd vissza magad. Légy kíméletlenül kritikus. Most szeretném megtalálni ezeket a problémákat, nem éles használat közben. A végén adj konkrét módosítási listát: mit és hogyan kell megváltoztatni, hogy ezek a problémák ne forduljanak elő. ```
## CLAUDE.md vs AGENTS.md vs MEMORY.md: ki mit olvas 2026-ban?
Fő tanulság Gyakran összekevernek három hasonló fájlt. A CLAUDE.md saját kezűleg írt projektutasításokat tartalmaz, amelyeket a Claude Code minden munkamenetben elolvas. Az AGENTS.md a többi ügynök (Codex, Cursor, Copilot) univerzális szabványa, és 2026 szeptembere óta a Claude Code is beolvassa, ha a projektben nincs CLAUDE.md. A MEMORY.md automatikus jegyzeteket tartalmaz, amelyeket Claude saját magának ír a szokásaidról. Mindhárom létezhet egyszerre, konfliktus nélkül.
| Fájl | Ki írja? | Ki olvassa? | Mikor töltődik be? | |----|----|----|----| | **CLAUDE.md** | Te, kézzel | Claude Code (natívan) | Minden munkamenet kezdetén | | **AGENTS.md** | Te, kézzel | Codex CLI, Cursor, GitHub Copilot CLI, Gemini CLI, valamint a 2.1.277-es verziótól a Claude Code, ha a projektben nincs CLAUDE.md | Minden munkamenet kezdetén | | **MEMORY.md** | Maga a Claude Code | Claude Code (natívan) | Minden munkamenet kezdetén, az első 200 sor (vagy 25 KB, amelyik kevesebb) | A kezdőket leginkább az zavarja össze, hogy **olvassa-e a Claude Code az `AGENTS.md`-t?** 2026 szeptembere előtt a válasz „nem” volt: az Anthropic dokumentációja azt javasolta, hogy hozz létre egy CLAUDE.md-t, amely importálja az AGENTS.md-t. A 2.1.277-es verzió óta (kiadva 2026. szeptember 18-án) a Claude Code önállóan is beolvassa az AGENTS.md-t, de csak akkor, ha a munkamappában vagy valamelyik szülőmappájában nincs CLAUDE.md, `.claude/CLAUDE.md` vagy `CLAUDE.local.md`.

A Claude Code projektutasításként képes beolvasni az AGENTS.md-t, így egy más ügynökökhöz már beállított repository a CLAUDE.md, importálás vagy konfigurálás nélkül is működik.

— Anthropic, https://code.claude.com/docs/en/memory#agents-md
Ha a projektben van CLAUDE.md, a Claude Code alapértelmezés szerint csak azt olvassa be, az AGENTS.md-t kihagyja. Ezt a `/config` beállításai között, a Project instructions résznél módosíthatod: például a `claude-md-and-agents-md` beállítással mindkét fájlt beolvassa. Egy másik megoldás bármelyik verzióban működik: adj importhivatkozást a CLAUDE.md-hez: ```markdown @AGENTS.md ## Claude Code További szabályok a Claude Code számára, amelyekre más ügynököknek nincs szükségük. ``` A `@filename` szintaxis egy másik fájl importálására szolgál. Claude beolvassa, és a CLAUDE.md-vel együtt betölti a kontextusba. Az import miatt a fájlt nem olvassa be kétszer, akkor sem, ha a Claude Code önállóan is képes az AGENTS.md beolvasására. **Mikor van szükséged AGENTS.md-re?** Ha a Claude Code-dal párhuzamosan Codex CLI-t, Cursort vagy Copilotot is használsz, hozz létre egy AGENTS.md-t, mint egyetlen hiteles forrást, írd be a CLAUDE.md-be az `@AGENTS.md` hivatkozást, majd egészítsd ki a Claude-ra vonatkozó speciális szabályokkal. Ha nincsenek ilyen szabályok, nem kell CLAUDE.md-t létrehoznod: a 2.1.277-es verziótól a Claude Code önállóan beolvassa az AGENTS.md-t. Ha csak Claude Code-ot használsz, nincs szükséged AGENTS.md-re; elég egyetlen CLAUDE.md. Az összes lehetőség lépésenkénti bemutatását lásd az [AGENTS.md és CLAUDE.md együttes használatáról szóló útmutatóban](https://ailoot.ai/blog/hu/agents-md-claude-md-one-instruction-file/). **Mi az a MEMORY.md?** Egy nemrég bevezetett frissítés óta a Claude Code automatikusan jegyzeteket készít rólad a `~/.claude/projects//memory/MEMORY.md` fájlba. Ilyenek például a beszélgetési szokások („a felhasználó a rövid válaszokat kedveli”), a visszatérő kérések („ne használj emojit a kódban”) és a viselkedésre vonatkozó megfigyelések („macOS-en dolgozik, zsh-t használ”). Ez különálló memóriarendszer, nem CLAUDE.md. Nem kézzel írod; Claude készíti a beszélgetéseitek alapján. Ha a MEMORY.md olyasmit tartalmaz, aminek szabállyá kell válnia, tedd át a CLAUDE.md-be. Ha valami fölösleges vagy hibás van benne, kézzel törölheted; szövegfájlról van szó.
Megjegyzés Ha látni szeretnéd, mi töltődik be a munkamenet kezdetén, írd be a `/memory` parancsot a Claude Code-ba. Megmutatja a CLAUDE.md, a MEMORY.md és az egyéb betöltött fájlok tartalmát. Ez hasznos, ha Claude furcsán viselkedik: nyisd meg a `/memory` nézetet, és keresd meg az esetleg problémát okozó szabályt.
## Mekkora CLAUDE.md hasznos, és hogyan vizsgálj felül egy hosszú fájlt?
Fő tanulság A hosszabb utasításfájl több kontextust használ, és megnehezítheti a releváns szabályok követését, különösen ismétlések vagy ellentmondások esetén. Az Anthropic 200 sor alatti méretet javasol. Ez nem technikai plafon, és nem általános előrejelzés arról, hány szabályt fog követni az ügynök.
Minden Claude Code-ablakban több réteg töltődik be a kontextusba: az Anthropic rendszerpromptja (becslések szerint több tízezer token), a CLAUDE.md, a `@`-tal importált fájlok, a MEMORY.md, az aktuális csevegés előzményei és a Claude által megnyitott fájlok tartalma. Mindeznek bele kell férnie a modell kontextusába (200K token a Sonnet, 1M az Opus esetében). Minél nagyobb a CLAUDE.md, annál kevesebb hely marad az aktuális munkára. Egy 1,000 soros fájl körülbelül 8,000 token, és minden munkamenetben újra betöltődik. Pro-előfizetéssel (tapasztalatom szerint naponta körülbelül 10-12 „nehéz” prompttal) ez negyedével csökkenti a kapacitásodat. A költség csak az egyik szempont. Az utasításkövetés romolhat, ha az utasítások hosszúak, irrelevánsak vagy ellentmondásosak; nincs általánosan érvényes szám a megbízhatóan követett utasításokra. Tesztelj néhány jellemző feladatot a kritikus szabályokkal, rögzítsd a hibákat, és egy célzott szerkesztés után hasonlítsd össze a viselkedést.
A túlzsúfolt CLAUDE.md-fájlok miatt Claude figyelmen kívül hagyja a valódi utasításaidat.
— Anthropic, code.claude.com/docs/en/best-practices
Íme a méretre vonatkozó ökölszabály: - **80-120 sor** - kényelmes kezdőtartomány egy tömör projekttérképhez, nem garantált utasításkövetési pontszám. - **150-200 sor** - hasznos jelzés a relevancia átnézésére és a részletes eljárások hivatkozott fájlokba helyezésére. - **200-300 sor** - vizsgáld meg a tokenmennyiséget, az ismétléseket és a feladateredményeket; a fenti 280 soros üzleti példa még jól működhet. - **400+ sor** - nyomós ok egy célzott felülvizsgálatra, nem bizonyíték a használhatatlanságra. Az alapvető korlátokat őrizd meg, és a részleteket csak a hivatkozások és szabályok működésének ellenőrzése után helyezd máshová. A sorszám önmagában nem bizonyít sikert vagy kudarcot. Szerkesztés után ugyanazokat a jellemző feladatokat ismételd meg, és a fontos szabályokat ellenőrizd kitalált megfelelési százalékok helyett.
Figyelmeztetés Ha túl nagyra nőtt a CLAUDE.md-d, ne kézzel refaktoráld. Add ezt a promptot Claude-nak: „Olvasd el a CLAUDE.md-t, és értékeld minden sorát ezzel a kérdéssel: »Ha ezt a sort törölnénk, hibázna az ügynök?« Készíts listát azokról a sorokról, amelyek veszteség nélkül törölhetők, és indokold meg.” Eltávolítja azt, ami objektíven nem működik.
Az Anthropic közvetlen tesztet ad a dokumentációjában:
Minden sornál kérdezd meg: »Ha ezt eltávolítom, Claude elkezd hibázni?« Ha nem, töröld.
— Anthropic, code.claude.com/docs/en/best-practices
Alkalmazd ezt minden sorra. Ha a válasz az, hogy „így is jól csinálná”, töröld a sort. A CLAUDE.md nem dokumentáció, döntéstörténet vagy filozófia tárolására való. Csak azokat a szabályokat tartsd benne, amelyek segítenek az ügynöknek elkerülni a hibákat. ## Melyik 7 hiba teszi használhatatlanná a CLAUDE.md-t?
Fő tanulság Ez az a hét gyakori hiba, amelyet rendszeresen látok mások CLAUDE.md-fájljaiban. Mindegyik ok a fájl módszeres rendbetételére. Többségük ugyanannak a problémának a változata: a CLAUDE.md-t univerzális „projekt-dokumentummá” próbálják alakítani ahelyett, hogy az ügynök munkaeszközeként tartanák meg.
### 1. hiba. „Legyél jó mérnök” A leggyakoribb hiba. Az emberek általános kívánságokat írnak a CLAUDE.md-be: „írj tiszta kódot”, „alkalmazd a bevált gyakorlatokat”, „gondolkodj vezető mérnökként”. Ezek a szavak nem jelentenek semmit. Claude általános értelemben már most is „tiszta kódot” ír. Ezek a sorok helyet foglalnak a kontextusban, de nem befolyásolják a döntéseket. A „írj tiszta kódot” helyett írd ezt: „használj 2 szóköznyi behúzást”, „ne használj `any`-t TypeScriptben”, vagy „a függvények legfeljebb 30 sorosak lehetnek”. Konkrét és ellenőrizhető szabályok. ### 2. hiba. Olyan dolgok megkettőzése, amelyeket Claude már tud A programozási nyelvek szokásos konvencióinak leírásai („a JavaScriptben a függvények első osztályú állampolgárok”, „a TypeScript statikus típusosságot használ”). Magyarázatok arról, hogyan működik az npm, a git vagy a docker. Claude mindezt megtanulta a betanítása során. A CLAUDE.md-ben való megismétlésük nem ad hozzá semmit; csak csökkenti a kontextusod számára rendelkezésre álló helyet. ### 3. hiba. Hosszú, lépésenkénti utasítások a CLAUDE.md-ben Hosszú utasítások arról, „hogyan kell telepíteni a projektet”, „hogyan kell adatbázis-migrációt írni” vagy „hogyan kell új komponenst beállítani”. Több tucat lépésről lépésre leírt sor. Ez nem hosszú, részletes útmutatók helye, hanem az egysoros szabályoké. A részletes utasításokat tedd a `skills/` mappába (ez egy külön Claude Code-mechanizmus, amely igény szerint töltődik be) vagy a `docs/` mappába. A CLAUDE.md-ben elég egy egysoros hivatkozás: „Új migráció létrehozásakor nyisd meg a `docs/migrations.md` fájlt.” ### 4. hiba. Olyan szabályok, amelyeket már automatikus kódelemző ellenőriz „Használj pontosvesszőt”, „ne hagyj használaton kívüli importot”, „ne használj `var`-t.” Az ESLint, a Prettier és a Biome mindegyiket felismeri - ezek linterek, vagyis automatikus kódellenőrző eszközök. A linter determinisztikus: lefut, megtalálja a hibát, és kijavítja. A CLAUDE.md szabálya valószínűségi; az ügynök megfeledkezhet róla. Fölösleges megismételni - egyszerűbb beállítani a lintert. ### 5. hiba. Titkok a CLAUDE.md-ben Láttam már tesztfiók-jelszavakat, sandbox API-tokeneket és hitelesítést igénylő adminfelületekre mutató hivatkozásokat. Mindez olyan fájlban volt, amelyet commitoltak a gitbe, és betöltöttek az Anthropic modelljének kontextusába. Soha ne tedd ezt. A titkok a `.gitignore` által kizárt `.env` fájlba valók. A CLAUDE.md legfeljebb ennyit írjon elő: „Ne olvasd be teljes egészében a `.env` fájlt; egy adott változóhoz használj `grep`-et.” ### 6. hiba. Több mint 500 soros gyűjtőfájl, amelyet hat hónapja nem tisztítottak meg A CLAUDE.md egyre csak nő, megkettőzi a `docs/` tartalmának felét, több ponton ellentmond önmagának, és már senki nem emlékszik, mit tartalmaz. Az ügynök elkezdi figyelmen kívül hagyni a szabályok nagy részét. A csapat azt panaszolja, hogy „Claude nem követi az utasításokat”, és még több szabályt ad hozzá, ezzel tovább rontva a helyzeten. Az elhanyagolt CLAUDE.md jelei: több mint 300 sor, különböző szakaszokban ismétlődő szabályok, már nem létező fájlokra mutató elavult hivatkozások, valamint olyan „történeti” jegyzetek, mint „2024-ben így döntöttünk, aztán meggondoltuk magunkat”. A megoldás: kéthetente kérd meg Claude-ot, hogy az Anthropic tesztje alapján vizsgálja át: „Ha ezt a sort törölnénk, hibázna az ügynök?” Törölj mindent, amelyre a válasz „nem”. ### 7. hiba. Létrehozták a CLAUDE.md-t, aztán elfelejtették Ez az előző hiba ellentéte. A fájlt egyszer, két hónapja állították össze, és azóta hozzá sem nyúltak. Közben megváltoztak az eszközök, új mappák jöttek létre, és új ügynöki hibák merültek fel. A CLAUDE.md ezekről semmit sem tud, mert senki nem frissítette. Árulkodó jel, ha minden munkamenetben ugyanazt az utasítást ismétled: „Ne csináld az X-et”, „ne nyúlj az Y-hoz”, „ne felejtsd el a Z-t.” Ha már több mint kétszer elmondtad, akkor ennek a szabálynak a CLAUDE.md-ben a helye, nem a fejedben.
[Ailoot útmutatók](https://ailoot.ai/docs/)
## Hogyan tanítható önállóan a CLAUDE.md egy „munkamenet végi frissítés” szabállyal?
Fő tanulság Az a fő módszer, amellyel a CLAUDE.md-t dokumentumból élő eszközzé alakítottam, egy szabály hozzáadása volt: „Minden munkamenet végén ellenőrizd, tanultál-e valami újat a felhasználóról vagy a vele való munkáról, ami nincs benne a CLAUDE.md-ben, és adj hozzá egy sort.” Két hónap alatt a fájl külön folyamat nélkül kezdett személyre szabott szabályokat gyűjteni.
A CLAUDE.md-mben van egy rövid szakasz: ```markdown ## Self-learning At the end of every session, check: - Have I learned anything new about the user or how to work with them? - Did I break any rule that should now be recorded? If so, create or update a file in `about-me/feedback/` in this format: Rule (one-line rule) → Why (why it was added) → How to apply (when it applies). I don’t write the rules by hand - I say, “not like that, because this is how,” and you put it into a file. ``` Miután ez a szakasz bekerült a CLAUDE.md-be, Claude minden munkamenet végén elkezdte megkérdezni: „Volt valami új, amit érdemes feljegyezni?” Ha igen, javasolt egy szabálytervezetet, én pontosítottam, és létrejött egy fájl. Két hónapnyi ilyen munka után több mint két tucat fájlom van az `about-me/feedback/` mappában - konkrét hibákból levont szabályokkal. Minden fájl egyetlen oldalnyi anyag a Szabály → Miért → Hogyan formátumban. A mappa a „második memóriámmá” vált, amely a személyes preferenciáimat és tabukat rögzíti. A hibák nem ismétlődnek, mert szabállyá válnak, a szabályok pedig gyűlnek és erősítik egymást. Hat hónap után Claude jobban ismeri a projektemet, mint amennyire egy hónapos szünet után én emlékeznék rá. ## Hogyan adj hozzá jogi, marketing- és működési szabályokat a CLAUDE.md-hez?
Fő tanulság A CLAUDE.md technikai útmutatása csak a kép egyik fele. A másik fele az üzleti szabályoké: jogszabályi követelmények miatt tiltott megfogalmazások, külső márkaszövegek formázása és a csapat heti munkarendje. Ha a CLAUDE.md mindkét oldalt lefedi, Claude nemcsak programozó, hanem szerkesztő és operációs asszisztens is lesz.
A legtöbb csapatnál a CLAUDE.md tisztán technikai dokumentum: eszközök, buildparancsok, kódolási konvenciók. Ez hasznos, de az értékének csak egyharmada. Ha egy vállalkozó tartja karban a CLAUDE.md-t, érdemes üzleti részekkel kiegészíteni. Három a legfontosabb: ### Jogi szabályok (szabályozott piacokra) Ha szabályozott iparágban teszel közzé szöveget (pénzügy, egészségügy, gyógyszerreklám, gyermektermékek), a tiltott szavaknak jogi jelentőségük van, és kifejezett szabályként kell szerepelniük a CLAUDE.md-ben. Ne valakinek a fejében, ne egy szerkesztő képernyőképén, hanem olyan fájlban, amelyet az ügynök minden munkamenetben lát. Példa egy banki engedéllyel nem rendelkező fintechprojekthez: Szerkesztői megjegyzés: Az alábbi példa egy adott projektre vonatkozó belső szabály formátumát mutatja be. Nem jelent általános engedélyt a felsorolt kifejezések használatára: az elfogadhatóság az alkalmazandó jogtól és a vállalat státuszától függ. > 🚨 KRITIKUS - a pénzügyi megfogalmazások használata tilos. Ügyfeleknek szóló anyagokban ne használd ezeket: „betét”, „garantált hozam” vagy „befektetési termék”. Helyettük használd ezeket: „megtakarítási számla”, „várható hozam” és „változó kamatozású termék”. Ennek oka a projekt pénzügyi szolgáltatások reklámozására vonatkozó jogi követelménye. Ez a CLAUDE.md-blokk egyszerű dolgot tesz: minden alkalommal, amikor arra kéred Claude-ot, hogy ügyfeleknek szóló szöveget írjon, az ügynök összeveti azt ezekkel a tiltásokkal. A szabály nélkül minden harmadik kampányban megjelennek a tiltott szavak. A szabállyal el is felejted, hogy léteznek. Ugyanez a megközelítés működik az alábbiaknál: - Egészségügyi projektek (ne állítsd, hogy valami „kezel” vagy „meggyógyít”). - Gyógyszerreklám (ne állítsd, hogy valami „a leghatékonyabb”; kötelező figyelmeztetések). - Bármely szabályozott iparág, amelynek saját reklámozási szabályai vannak. ### Marketingstílus és szövegformátum Ha rendszeresen teszel közzé szövegeket (közösségi média, hírlevelek, weboldalak), érdemes egy bekezdésben dokumentálni a formátumot a CLAUDE.md-ben. Íme egy példa arra, mit írhat egy üzenetküldő csatornát kezelő influenszer vagy ügynökség: > Csatornaposztok írásakor nézd meg a `style/posts.md` fájlt. Használd a csatornán engedélyezett formázási jelölőket, és kerüld a „veszélyes” speciális karaktereket. A végére tegyél olyan CTA-t, amelynek UTM-címkéje ezt a konvenciót követi: `utm_source=&utm_medium=&utm_campaign=`. Korábban Claude „egy marketingweboldal általános stílusában” írt posztokat. Most követi a formátumodat, használja az UTM-jeidet, és nem árulja el, hogy a szöveget AI írta. ### Működési szokások Indítótáblázatok. Ha egy adott kifejezést mondasz, az ügynök tudja, mely fájlokat kell megnyitnia, és mit kell tennie. Íme egy heti tervezést végző csapat példája: > „Tervezd meg a hetet” → nyisd meg az `ops/monthly.md` fájlt, hozd létre a `YYYY-WNN.md` fájlt ugyanabban a mappában, és rendezd az `ops/backlog.md` feladatait a megfelelő napokhoz. „Mi van a backlogban?” → olvasd el az `ops/backlog.md` fájlt, és jelenítsd meg listaként. „Zárd le a hetet” → töltsd ki az aktuális heti fájl „Heti összefoglaló” szakaszát. Az ilyen táblázatokkal Claude a „kódot író segítőből” olyan „operátorrá” válik, aki ismeri a vállalkozásod rutinját. Minden hétfőn azt mondom, „tervezzük meg a hetet”, Claude pedig megnyitja a megfelelő fájlokat, elolvassa a havi célokat, és javaslatot tesz a feladatok felosztására.
Megjegyzés Az üzletspecifikus útmutatás akkor hasznos a CLAUDE.md-ben, ha már van `business/` mappád, amely valódi információt tartalmaz a közönségedről, termékeidről és céljaidról. Ha még nincs ilyen, először hozd létre a `business/` mappát, majd hivatkozz rá a CLAUDE.md-ben. Különben nem létező helyekre mutatnak majd az utasításaid.
## Hogyan ellenőrizd 5 perc alatt a CLAUDE.md-det egy 12 pontos listával?
Fő tanulság Ellenőrizd a jelenlegi CLAUDE.md-det ezzel a listával. Minden pont 30 másodpercet vesz igénybe. Ha legalább ötször válaszolsz „nem”-mel, a fájl rendbetételre szorul.
1. **Méret.** Tömör a fájl, és a körülbelül 200 sort felülvizsgálati célértéknek tekinted, nem megfelelt/nem felelt meg plafonnak? 2. **Név.** Pontosan `CLAUDE.md` a neve, nagybetűkkel, nem `claude.md`? 3. **Hely.** A projekt gyökerében vagy a `./.claude/CLAUDE.md` helyen van? 4. **Projektleírás.** Az első 5 sorból világos, mi a projekt és kinek szól? 5. **Eszközök.** A technológiák kifejezetten, sallang nélkül szerepelnek? 6. **Struktúra.** Van a repositoryról magyarázatokkal ellátott diagram? 7. **Útvonalválasztás.** Van „kérdés → fájl” táblázat, amely megmutatja, hol találhatók a válaszok? 8. **Alapelvek.** Van olyan szabályokat tartalmazó szakasz, amelyek „soha” és „mindig” szavakkal kezdődnek? 9. **Konkrétság.** Minden szabály ellenőrizhető? („Használj 2 szóközt”, nem „írj szépen”.) 10. **Önfrissítés.** Van szabály arra, hogy „a munkamenet végén ellenőrizd, mit kell hozzáadni”? 11. **Visszatekintés.** Van szabály a „munkamenet összefoglalójának rögzítésére a `retrospectives/` mappában”? 12. **Biztonság.** A kritikus tiltások (`.env`, `rm -rf`) a `.claude/settings.json` fájlban is szerepelnek? Ha ötnél több „nem” válaszod van, nyisd meg a Claude-ot, és add neki ezt a promptot:
Prompt: A CLAUDE.md auditálása az ellenőrzőlista alapján ``` Olvasd el a CLAUDE.md fájlomat, és hasonlítsd össze az alábbi ellenőrzőlistával. Minden pontra válaszolj így: igen / nem / részben, és írd le pontosan, mit kell javítani. Ellenőrzőlista: A feladathoz elég tömör; 200 sor körül vizsgáld felül, de ne kezeld kemény plafonként A projekt leírása az első 5 sorban szerepel Az eszközök kifejezetten fel vannak sorolva A repository struktúrájának diagramja szerepel benne A „kérdés → fájl” táblázat szerepel benne Szabályokat tartalmazó alapelvek szakasz szerepel benne Minden szabály konkrét és ellenőrizhető A „frissítsd a munkamenet végén” szabály szerepel benne A „tekints vissza a munkamenet végén” szabály szerepel benne A kritikus tiltások szerepelnek a .claude/settings.json fájlban Nincs több szakaszban megismételve ugyanaz a szabály Nincsenek már nem létező fájlokra mutató hivatkozások Az audit után adj listát azokról a konkrét módosításokról, amelyek élővé teszik a fájlt. ```
## Mit használj a CLAUDE.md után: Plan Mode-ot, Skillst vagy alügynököket?
Fő tanulság A CLAUDE.md az alap. Ha már működik, jöhetnek a következő szintek: Plan Mode (először terveztess Claude-dal, aztán cselekedj), Skills (helyezd át a ritkán szükséges tudást a CLAUDE.md-ből külön fájlokba) és alügynökök (elkülönített feladatok saját kontextusban).
A CLAUDE.md az alap. Ha már működik, hozzáadhatod a Claude Code három egymást erősítő mechanizmusát. **Plan Mode.** Olyan mód, amelyben Claude először változtatási tervet készít, megvárja a jóváhagyásodat, és csak utána kezd dolgozni. A Shift+Tab billentyűvel vagy a `/plan` paranccsal kapcsolhatod be. A vibe coding fő fájdalmára ad választ: „Megkértem Claude-ot, hogy javítson ki egy dolgot, erre átírta a projekt felét.” Plan Mode-ban ez nem történik meg - látod a tervet, mielőtt az ügynök bármilyen fájlhoz nyúlna. **Skills.** Különálló `.md` fájlok a `.claude/skills/` mappában, amelyek egy adott feladattípushoz tartozó tudást tartalmaznak. Például az „adatbázis-migráció írása” skill egy konkrét eljárást, sablont és példákat tartalmaz. Ez a tudás azért nincs a CLAUDE.md-ben, mert túl terjedelmes. Amikor azonban Claude olyan feladattal találkozik, mint „írj migrációt”, betölti a megfelelő skillt, és követi. **Alügynökök.** Ha egy feladat sok kontextust igényel (például egy nagy funkció áttekintése), Claude külön alügynököt indíthat, saját, tiszta kontextussal. Az alügynök elvégzi a munkát, majd visszaadja az eredményt anélkül, hogy zsúfolttá tenné a fő csevegés kontextusát. Mindhárom mechanizmus belépési pontként használja a CLAUDE.md-t: a munka kezdetén beolvassák, hogy megértsék a projekt hátterét. Ezért működnek rosszul ezek a funkciók akkor is, ha nincs naprakészen tartott CLAUDE.md. Előbb az alap, utána a ráépülő rétegek. **Következő lépés.** Hozz létre egy `CLAUDE.md` fájlt a projekt gyökerében, másold bele a cikk elején található sablont, majd a segédprompt segítségével töltsd ki a szögletes zárójelben lévő mezőket. Ezután használd a fájlt: minden ügynöki hibát alakíts egy új sornyi szabállyá. Két-három hét múlva a CLAUDE.md többé nem „egy dokumentum, amelyet megírtunk, aztán elfelejtettünk”, hanem olyan fájl lesz, amelyet Claude tényleg minden munkamenetben elolvas. Ha teljes keretrendszert szeretnél építeni a `CLAUDE.md` köré - `business/` mappával a Second Brainhez, `about-me/` mappával a digitális önképhez, alapvető skillekkel és beállított Plan Mode-dal -, használd a cikk lépéseit és példáit. [Ailoot útmutatók](https://ailoot.ai/docs/).
### Források - [Anthropic - Claude Code-memória](https://code.claude.com/docs/en/memory) - hivatalos dokumentáció a CLAUDE.md-ről, a MEMORY.md-ről és a betöltési hierarchiáról - [Anthropic - Bevált gyakorlatok](https://code.claude.com/docs/en/best-practices) - szabályok a hatékony CLAUDE.md írásához és a „hibázna Claude, ha ezt eltávolítanánk?” teszt - [Anthropic támogatás - Adj kontextust Claude-nak](https://support.claude.com/en/articles/14553240-give-claude-context-claude-md-and-better-prompts) - útmutató a kontextussal való munkához - [Ailoot útmutatók](https://ailoot.ai/docs/) - dokumentáció.
[Tovább az Ailoothoz](https://ailoot.ai/).
[Tovább az Ailoothoz](https://ailoot.ai/)
[Tovább az Ailoothoz](https://ailoot.ai/)
## Kérdések és válaszok: A CLAUDE.md beállítása 2026-ban: sablon és 6 szabály ### Érvénytelenné válik a CLAUDE.md fájl 200 sor után? Nem. Az ajánlás a tömörség célértéke, nem feldolgozási plafon vagy garantált hibahatár. Vizsgáld meg az ismétléseket, ellentmondásokat és a betöltött kontextust, majd jellemző feladatokon teszteld a fontos szabályokat. A cikk 280 soros példáját is ugyanígy kell értékelni. ### Mit érdemes kivenni egy növekvő CLAUDE.md-ből? A részletes eljárásokat, hosszú referenciaanyagokat és döntési előzményeket helyezd a megfelelő dokumentumokba vagy skillekbe. A belépőfájlban maradjanak tömör projekttények, alapvető korlátok és egyértelmű hivatkozások. A szerkesztés után ismételj meg valós feladatokat, hogy ellenőrizd az útvonalválasztást és a kritikus szabályokat. ## 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.