CLAUDE.md

haladóelterjedt

Egyszerű szövegfájl, amelyben leírod a Claude Code agentnek a projekted szabályait és tudnivalóit, és amelyet az agent minden munkamenet elején elolvas.

Érthetően

Képzeld el, hogy új kolléga érkezik a céghez, és az első napon kap egy házirendet: hol vannak a dolgok, mit hogyan szokás csinálni, mit tilos. A CLAUDE.md ugyanez egy AI-agentnek. Nem program, hanem hétköznapi nyelven írt jegyzet, amelyet a projekt mappájába teszel.

Azért van rá szükség, mert az agent a korábbi beszélgetéseket alapból nem viszi tovább: minden munkamenetet lényegében tiszta lappal kezd. A fájl nélkül újra és újra el kellene magyaráznod, hogy például magyarul írjon, hova mentse az eredményt, vagy milyen parancsokkal lehet a programot tesztelni.

Abban más, mint egy sima kérés a csevegőablakban, hogy tartós: egyszer írod meg, és onnantól minden alkalommal érvényes. Ha a fájlt a csapat közös tárolójában tartjátok, mindenki agentje ugyanazokat a szabályokat kapja meg.

Hogyan működik

Létrehozol egy CLAUDE.md nevű fájlt a projekt gyökérmappájában. Megírhatod kézzel, vagy az /init paranccsal az agent maga is készít egy vázlatot, miután átnézte a projektet.
Beleírod, amit az agentnek tudnia kell: a mappaszerkezetet, a gyakori parancsokat, a stílusszabályokat és a tilalmakat.
Amikor elindítod az agentet, az automatikusan betölti a fájl tartalmát a kontextusába, vagyis abba a szövegbe, amelyet a munka közben „fejben tart”.
Több szint is létezhet egyszerre: egy személyes fájl, amely minden projektedre érvényes, egy a projekthez, cégeknél egy központilag kiadott is, valamint külön fájlok az egyes almappákhoz. Az agent a felsőbb szinteket induláskor együtt tölti be, az almappák fájljait pedig akkor, amikor az adott almappában dolgozik.
A fájlt idővel karbantartod: ha az agent ismételten elront valamit, beírsz egy új szabályt, a feleslegessé vált sorokat pedig kihúzod.

Példa a mindennapokból

Egy kis webáruház fejlesztője beleírja a CLAUDE.md-be, hogy az árakat mindig forintban, áfával együtt kell megjeleníteni, és hogy az éles adatbázishoz tilos hozzányúlni. Ettől kezdve az agent a feladatoknál általában ehhez tartja magát, anélkül hogy újra kérni kellene tőle; az éles adatbázist ugyanakkor érdemes jogosultságokkal is védeni.

Kit érint

fejlesztőEzzel tudod az agentet a saját projekted szokásaihoz igazítani, és megspórolod az ismétlődő magyarázkodást. → Kód

vállalkozó, vezetőA fájlban rögzített szabályok egységesebbé teszik, hogyan dolgoznak az agentek a csapat minden tagjánál.

munkavállalóHa nem programozási feladatra, például dokumentumok vagy adatok rendezésére használsz agentet, ugyanígy megadhatod neki a munkahelyi elvárásokat. → Munka és HR

Gyakori félreértés

TévhitAmit a CLAUDE.md-be írsz, azt az agent mindig, kivétel nélkül betartja.

ValójábanA fájl útmutatás, nem műszaki zár: az agent nagy eséllyel követi, de hosszú vagy ellentmondásos szabályoknál hibázhat. Amit tényleg meg kell akadályozni, azt jogosultságokkal és engedélybeállításokkal kell korlátozni.

Korlátok és kockázatok

A túl hosszú fájl ront az eredményen, mert a fontos szabályok elvesznek a sok szöveg között, és a betöltése minden alkalommal a kontextus egy részét foglalja el.
Jelszót, hozzáférési kulcsot vagy más titkot ne írj bele, mert a fájl jellemzően a projekttel együtt megosztásra kerül.
Ha idegen projektet töltesz le, a benne lévő CLAUDE.md is utasításokat ad az agentednek, ezért érdemes elolvasnod, mielőtt dolgoztatsz vele.
Az elavult szabály rosszabb, mint a hiányzó: ha a projekt változik, a fájlt is frissítened kell.

Hasonló, de nem ugyanaz

AGENTS.md – Az AGENTS.md ugyanerre a célra szolgáló, gyártófüggetlen nyílt formátum, amelyet többféle kódoló agent olvas, míg a CLAUDE.md a Claude Code saját fájlja.
Rendszerprompt – A rendszerpromptot az alkalmazás készítője állítja be a háttérben, a CLAUDE.md-t viszont te írod és szerkeszted a saját projektedben.
README – A README embereknek mutatja be a projektet, a CLAUDE.md az agentnek szóló munkautasítás.

Kapcsolódó fogalmak

Tágabb

Kontextusmérnökség, AI-agent, Agentmemória

Szűkebb

–

Rokon

AGENTS.md, Rendszerprompt, Claude Code, Kontextusablak, Agent skill

Röviden a története

A CLAUDE.md az Anthropic Claude Code nevű kódoló agentjével jelent meg, amelyet a cég 2025 februárjában mutatott be. Hasonló projektszintű utasításfájlok más eszközökben is léteztek már előtte vagy vele párhuzamosan (például a Cursor szabályfájljai), 2025 nyarán pedig megjelent a gyártófüggetlen AGENTS.md formátum is.

Hol tart most

2026 végén a Claude Code-ot használó fejlesztők körében alapeszköznek számít, és sok nyílt forráskódú projekt mappájában megtalálható. A fejlesztői körön kívül még kevéssé ismert, és mellette egyre több eszköz a közös AGENTS.md formátumot is támogatja.

Állapot: 2026. november

Más nevei

CLAUDE.md · claude.md · Claude.md fájl · Claude-memóriafájl · projektmemória · agent utasításfájl · Claude Code memory file

Források

A szócikk gépi szerkesztéssel készült és gépi szakmai lektoráláson ment át; a „hírekben” rész az Agent Age sztorijaiból automatikusan frissül.