CLAUDE.md: állandó szabály a Claude Code-nak

A CLAUDE.md a projekt tartós, szerkeszthető utasításfájlja. A Claude Code a munkamappában található fájlt induláskor betölti, így nem kell minden állandó szabályt újra leírnod. A rendszerutasításról szóló leckében megismert logika jelenik meg fájlban: te írod, verziózható, a csapat is látja.

Hogyan működik a CLAUDE.md?

Egy új munkamenet nem kapja meg automatikusan az előző beszélgetés teljes szövegét. A CLAUDE.md tartós keretet ad; emellett a bekapcsolt automatikus memória külön jegyzeteket is megőrizhet a korábbi munkából. A kettő nem ugyanaz: az állandó, közösen karbantartott szabályokat továbbra is a CLAUDE.md fájlban rögzítsd.

Három szinten élhet:

• Projektszint: a mappa gyökerében lévő CLAUDE.md (vagy .claude/CLAUDE.md). Ez az adott projektre vonatkozik, és ha verziókezelésben van, a csapat közösen használja.
• Személyes szint: a saját gépeden a ~/.claude/CLAUDE.md minden projektedre érvényes. Ide a saját preferenciáid valók (például: magyarul válaszolj, tegeződve).
• Almappaszint: nagyobb projektben egy-egy almappának is lehet saját fájlja, ami akkor töltődik be, amikor ott dolgozol.

Két hasznos parancs: az /init segít elkészíteni a kiinduló CLAUDE.md fájlt, a /memory pedig megmutatja a betöltött utasításfájlokat és az automatikus memória beállítását. Tartós szabályhoz kérd külön: „Ezt a szabályt add hozzá a projekt CLAUDE.md fájljához”, majd nézd át a módosítást. A működést az Anthropic memóriadokumentációja részletezi.

Egy fontos korlát, amit kimondunk: a CLAUDE.md kontextus, nem kényszer. A Claude nagyon nagy arányban követi, de nem technikai tiltás. Amit tényleg meg akarsz tiltani (például egy mappa törlését), azt nem instrukcióval, hanem jogosultsággal és beállítással kell lezárni. Erről a haladó leckében lesz szó.

Gyakorlati feladat

A Claude Code alapok leckében létrehoztál egy dokumentumfeldolgozó munkamappát. Most kap egy CLAUDE.md-t, amitől minden későbbi munkamenet úgy indul, hogy a rendszer már tudja: mi ez a mappa, mik a szabályok, hogyan dolgozzon.

Mit írj bele?

Az elv: azt írd le, amit egy új munkatársnak is elmondanál az első napon, és amit különben minden munkamenetben újra el kellene magyaráznod. Öt blokk:

1. Mi ez a projekt vagy mappa. Két mondat. Mit tartalmaz, mire használod.

2. Szerkezet. Hol mi van: melyik almappában mik a fájlok, hova kerüljön a kimenet.

3. Stílus- és nyelvi szabályok. Magyarul dolgozzon-e, tegezés vagy magázás, tiltott fordulatok, formázási elvárások.

4. Munkavégzési szabályok. A „mit ne” blokk: mit ne töröljön, mit ne írjon felül, mikor kérdezzen.

5. Visszatérő feladatok. Ha van 2-3 feladat, amit rendszeresen kérsz, írd le a menetüket, és onnantól elég annyit mondanod: „csináld a heti összefoglalót”.

A kész példa

Ezt másold a mappád gyökerébe CLAUDE.md néven, és írd át a saját helyzetedre:

„# Erről a mappáról

Ez a [Cégnév] ajánlatarchívuma és feldolgozó munkamappája. A cél: a régi ajánlatokból kereshető, összesíthető tudás.

# Szerkezet

• bejovo/: ide kerülnek a feldolgozatlan dokumentumok
• feldolgozott/: a már feldolgozott eredetik
• kimenet/: minden általad készített fájl ide kerül

# Nyelv és stílus

• Mindig magyarul dolgozz.
• Összefoglalókban tömör, tényszerű stílus, felsorolással.
• A pénzösszegeket mindig forintban, ezres tagolással add meg.

# Szabályok

• Eredeti fájlt soha nem írsz felül és nem törölsz. Minden kimenet új fájlként kerüljön a kimenet/ mappába.
• Ha egy dokumentumból hiányzik adat (ügyfél, összeg, dátum), az összesítőben jelöld »hiányzik« értékkel, ne becsüld meg.
• Ha egy feladat 10-nél több fájlt érintene, előbb írd le a tervet, és várd meg a jóváhagyásomat.

# Visszatérő feladatok

• »Heti összesítő«: a bejovo/ mappa új fájljaiból táblázat a kimenet/ mappába (fájlnév, ügyfél, összeg, dátum, egymondatos lényeg), utána az eredetik átmozgatása a feldolgozott/ mappába.”

Ez a fájl rövidebb, mint egy A4-es oldal. Ennyi kell, nem több.

Miért éri meg?

Megszűnik az ismételgetés. A leggyakoribb időnyelő az AI-munkában nem a rossz válasz, hanem az újramagyarázás. A CLAUDE.md csökkenti ezt az ismétlődő munkát; a szabályok követését továbbra is ellenőrizd.

Kiszámítható kimenet. A formátum- és stílusszabályok miatt a tizedik összefoglaló is ugyanúgy néz ki, mint az első. Rendszert kapsz, nem alkalmi eredményeket.

Átadható. Ha egy kolléga vagy egy külsős veszi át a mappát, a CLAUDE.md-ből percek alatt érti a kereteket. Ugyanez a fájl neki is dolgozik.

Hogyan tartsd karban?

• A kétszeri ismétlés szabálya. Ha kétszer kijavítottad ugyanazt, az nem hiba, hanem hiányzó szabály. Írd bele.
• Rövidre vágva. A fájl minden munkamenetben helyet foglal a kontextusban. A tömör, konkrét szabályt követi a legjobban a rendszer, a hosszú esszében elveszik a lényeg. Ha nő az anyag, a részleteket tedd külön dokumentumba, és a CLAUDE.md csak hivatkozzon rá.
• Havi ránézés. Változott az árazás, a mappaszerkezet, a folyamat? A fájl kövesse.

Gyakori kérdések

Mi a különbség a rendszerutasítás és a CLAUDE.md között?

A szerepük ugyanaz: állandó keret. A rendszerutasítás egy beállítási mező a chateszközökben és az API-ban, a CLAUDE.md pedig a Claude Code fájlalapú megoldása ugyanerre. Aki az egyiket jól írja, a másikat is tudja.

Több CLAUDE.md is lehet?

Igen: személyes, projekt- és almappaszinten, és ezek együtt töltődnek be. Kis projektnél egy fájl a gyökérben bőven elég.

Mi van, ha nincs?

A Claude Code enélkül is működik, és más betöltött utasításokat vagy automatikus memóriát is használhat. A projekt közösen karbantartott, állandó szabályai viszont hiányoznak, ezért ezeket külön meg kell adnod.

Tehetek bele érzékeny adatot?

Jelszót, API-kulcsot, banki adatot soha. A fájl sima szöveg, és ha a mappa megosztott vagy verziókezelt, más is látja. Ilyesmi beállításokba és titokkezelőbe való, nem ide.

Innen folytasd

A CLAUDE.md rögzíti az állandó kereteket. A következő leckében a munkamódszert fejleszted tovább: tervet készíttetsz, elkülöníted a nagy részfeladatokat, újra felhasználható eljárásokat hozol létre, és technikai korlátokat állítasz be.

Ha ezt a saját cégedben szeretnéd bevezetni, nézd meg a szolgáltatásokat, vagy kérj egy ingyenes AI-konzultációt.