A CLAUDE.md fájl – Projekt memória Claude-nak
Ez a lecke a CLAUDE.md fájl fogalmát és használatát mutatja be: azt a speciális markdown fájlt, amely „memóriaként” működik a Claude számára, és minden egyes új session elején automatikusan beolvasásra kerül. Megismered, miért van szükség erre a megoldásra, mi kerüljön bele, hogyan hozd létre, és mi a különbség a projekt szintű és a felhasználói szintű CLAUDE.md fájl között.
A probléma: elvesző kontextus
Az első működő verzió elkészült – dizájnban és alapfunkcionalitásban jól néz ki, de van egy láthatatlan probléma, amelyről már korábban is esett szó.
Minden, amit eddig csináltunk, egyetlen beszélgetésen belül zajlott le. Az elején megadtuk a tervet, Claude megépítette pár kérdés után, majd hozzákapcsoltuk az API kulcsot – ennyi volt az egész session. Ha ezt a sessiont letörölnénk, a beszélgetés elveszne. Ez most talán a legkisebb baj, mert a kódból minden kiderül.
A valódi probléma azonban az, hogy:
- Ha hosszú ideig dolgozol egy rendszeren, a kontextus egyre nehezebben kezelhető.
- Sok üzenet után muszáj lesz kontextust törölni, ami azt jelenti, hogy elvesznek fontos összefüggések.
- Bármennyire is jól próbálod menedzselni a különböző kontextus fájlokat, nincs egy központi „agy”, amely tudná, miről is szól igazából a projekt.
Mi az a CLAUDE.md fájl?
A CLAUDE.md egy markdown fájl, amelyet a projekt mappájába helyezel el, és amelyet Claude minden egyes session elején automatikusan elolvas – még mielőtt egyetlen szót is írnál neki.
Ez a fájl úgy működik, mint egy system prompt: a te üzeneteid előtt olvassa el Claude, hogy megértse, miről szól az egész projekt. Ez a fájl adja meg Claude-nak a projekt szintű memóriát a különböző sessionök között.
Ha Claude elolvassa ezt a fájlt, attól kezdve úgy viselkedik, mintha már megbeszéltük volna mindazt, amit a fájl tartalmaz.
Mi kerülhet a CLAUDE.md fájlba?
- Konvenciók – hogyan szeretnéd, hogy Claude viselkedjen. Például:
– A márka hangja, hogy a te nyelveden írjon. – Hogyan dizájnoljon bizonyos dolgokat.
- Szabályok – mit csináljon mindig, és mit ne csináljon soha.
- Antiminták – konkrétan mi az, amit egyáltalán ne csináljon.
- Stabil alapszabályok – olyan alapvető dolgok, amelyeket minden új session elején tudnia kell, hogy egyértelmű legyen a számára.
Ezek tényleg határozott, szilárd szabályok, amelyeket menet közben hozol meg – apró, de fontos döntések.
A CLAUDE.md fájl dinamikus természete
A gyakorlatban akár egy napon belül többször is frissítheted ezt a fájlt. Ritka az, hogy előre pontosan tudod, mit akarsz építeni.
Ami ebben a projektben eddig történt, az semmi ahhoz képest, ahogy a valóságban működni fog. Ha például:
- új funkciókat szeretnél bevinni,
- folyamatosan teszteled és nézed, mi tetszik és mi nem,
- összegyűjtöd, milyen plusz funkciókat tennél bele,
…az mind hosszabbá teszi a beszélgetést. Ahogy a beszélgetés hosszabbodik:
- lehet, hogy szövegeket kell frissíteni,
- lehet, hogy más márkahanget kell alkalmazni.
Ez a fájl tehát folyamatosan változik a legtöbb projektnél.
A CLAUDE.md azért létezik, mert minden beszélgetés elején beolvassa Claude, és ezáltal megérti a kontextus fontosabb elemeit. Így nem kell végignézni az összes fájlt – ami rengeteg olvasási tokent jelentene –, de ez nem azt jelenti, hogy tele kell rakni adattal.
A CLAUDE.md fájlt viszonylag röviden kell megírni. Ha túl hosszú, Claude összekeveredik tőle, és nem akarjuk, hogy túl sokat olvasson.
Hogyan hozd létre a CLAUDE.md fájlt?
Sok megoldást lehet látni különböző szakértőktől, és sokféleképpen lehet tesztelni, de a leghatékonyabb módszer az, hogy Claude saját magának készíti el a CLAUDE.md fájlt.
A létrehozás módja
Egyszerűen írd be Claude-nak:
„Készítsd el a CLAUDE.md fájlt.”
Ennyi. Claude összerakja a saját CLAUDE.md fájlját, amelyet egy új sessionben majd be fog olvasni. Azért jobb, ha ő csinálja, mert ő tudja, hogyan kell jól szerkeszteni – például a tech stack technikai elemeit (mint a Tailwind) sokkal pontosabban le tudja írni, mint ahogy te próbálnád körülírni.
A parancs
Ugyanezt elérheted a paranccsal is. Ha beírod, hogy , megjelenik az „Initialize a new CLAUDE.md file with code-based documentation” opció. Ez pontosan ugyanaz, mint a „Készítsd el a CLAUDE.md fájlt” utasítás – nem muszáj a hosszabb változatot használni.
A létrehozott fájl tartalma – egy példán keresztül
A fájl egy sima, formázott szövegszerkesztő fájl (markdown). Érdemes szövegszerkesztőben megnyitni és átnézni.
Mit tartalmaz a generált fájl?
A példában szereplő habit-követő alkalmazás CLAUDE.md fájlja a következőket tartalmazza:
- Útmutatás arról, hogy ez a fájl mire való, amikor Claude ebben a repóban dolgozik.
- Parancsok – a projekt futtatásához, ellenőrzéséhez, type checkhez szükséges parancsok.
- Környezeti változók – az fájl olvasásának szabályai.
- Architektúra leírása – a projekt felépítése.
- Tech stack – Next.js 15, Supabase, Vercel (telepítendő, mert az még nem volt elvégezve).
- Adatmodell – a habit adatmodell és a strict számítás működése.
- History/URL state kezelése.
- Design system – hogyan néz ki a felület.
- Migrációk és projektkontextus – egy felhasználós, privát szokáskövető, magyar nyelvű UI.
- Platformkorlátok – nincs mobilapp.
A fájl kb. 100 soros, ami teljesen megfelelő – ez egy egyszerű, jól kezelhető CLAUDE.md fájl.
Ha egy új sessiont indítanál (mert kitörölted a régit, vagy menteni szeretnéd a haladást), az új sessionben Claude először ezt a fájlt olvasná el, és csak utána a te üzenetedet. Mivel a fájl nem hosszú, ez kb. egy másodperc alatt megvan.
Kétféle CLAUDE.md fájl
Két főbb CLAUDE.md fájl típus létezik:
1. Projekt szintű CLAUDE.md
- A projekt mappájában helyezkedik el.
- Az adott projektre vonatkozó szabályokat, konvenciókat tartalmazza.
- Minden session elején automatikusan beolvasódik, amikor abban a mappában dolgozol.
2. Felhasználói (user) szintű CLAUDE.md
- A számítógépedre vonatkozik, nem egy konkrét projektre.
- Mac-en a rejtett fájlok között található: a Command+Shift+. billentyűkombinációval hozhatók elő a rejtett fájlok. Windows-on érdemes utánanézni, hogyan lehet a rejtett fájlokat megjeleníteni.
- A Claude mappájában helyezkedik el, és az összes projektre és sessionre érvényes.
Mit érdemes a felhasználói szintű fájlba rakni?
Azokat a szabályokat, amelyeket minden projektnél alkalmazni szeretnél:
- Mindig tegező szöveget használjon.
- Magyar szövegnél használjon ékezeteket.
- A saját márkahang szabályait alkalmazza.
- Ne használjon AI-nál felismerhető, sablonosnak ható szövegrészeket.
- Ne használjon hosszú kötőjeleket.
- Megadhatod, hogy ki vagy, milyen vállalkozáson keresztül dolgozol.
- Megadhatod a munkamódszeredet (pl. használjon kérdéseket, inkább interjúszerűen közelítsen, ne magyarázzon túl sokat).
- Technikai adatok: milyen operációs rendszert használsz, milyen eszközök vannak telepítve (pl. Homebrew, Node.js), GitHub felhasználónév, e-mail cím.
Egy valós példa a felhasználói CLAUDE.md tartalmára
- A felhasználó magyarul kommunikál, Claude is magyarul válaszoljon – kivéve a kód és a szabályos technikai terminusokat, azokat hagyja angolul.
- Dokumentációt magyarul készítsen, kivéve ha kifejezetten angolul kérik.
- A hang közvetlen és tegező, lazább megnyilvánulásokat használ – ezt tükrözze Claude is, de ne legyen sem túl formális, sem túl pajtáskodó.
- Mac OS-en Homebrew telepítve van.
- Node.js futtatja a projekteket.
- GitHub felhasználónév és e-mail cím megadva.
- Munkamódszer: használjon „Ask Questions” megközelítést, delegáljon, inkább interjúszerűen közelítsen.
Hierarchia és szabályütközések
Ha a felhasználói szintű és a projekt szintű CLAUDE.md fájl szabályai ellentmondanak egymásnak, mindig a közelebbi nyer – azaz a projekt szintű felülírja a felhasználói szintűt.
Ez nem ütközés, hanem hierarchia: van, amikor a globális szabályokat felül akarjuk írni egy adott projektnél. Ezt tudatosan kell kezelni.
A CLAUDE.md fájl karbantartása
Session lezárásakor
Amikor le szeretnél zárni egy sessiont, érdemes beírni:
„Mentsd el a jelenlegi session tanultakat, és frissítsd a CLAUDE.md fájlt.”
Ezzel frissen tarthatod a projekted kontextusát.
Rendszeres átnézés
Érdemes időnként átolvasni a CLAUDE.md fájlt, mert előfordulhat, hogy Claude olyan dolgot is beleír, ami nem fontos, és emiatt rossz irányba tereli a munkát.
Valós példa: egy szövegírási projektnél Claude beleírta a fájlba, hogy „nagyon rövid szövegeket használjon” – de e-maileknél ez nem volt megfelelő, és minden mondat túl rövid lett, elveszett a személyes márkahangi stílus.
Érdemes néha szólni Claude-nak: „Nézzük már át a CLAUDE.md fájlt – lehet-e valamit frissíteni rajta?” Ez segít okosan karbantartani a fájlt.
A CLAUDE.md fájl az egyik legfontosabb eszköz a hatékony Claude-alapú munkához. Minden egyes projektednek lesz egy ilyen fájlja, és ha jól tartod karban – sem túl röviden, sem túl hosszan –, akkor Claude minden új sessionben pontosan tudni fogja, miről szól a projekt, hogyan szeretsz dolgozni, és milyen szabályok szerint kell eljárnia. A projekt szintű és a felhasználói szintű fájl együtt alkotja azt a „memóriát”, amely a különböző sessionök között is megőrzi a kontextust.