Ce este CLAUDE.md și ce scrii în el
CLAUDE.md este un fișier text cu instrucțiuni despre proiectul tău, pe care Claude Code îl citește singur la începutul fiecărei conversații. Acolo scrii o dată ce trebuie să știe mereu (comenzile importante, stilul, ce e interzis), ca să nu le repeți în fiecare zi.
De ce ai nevoie de el
Claude nu ține minte conversațiile de ieri. Fără CLAUDE.md, a doua zi te întreabă din nou lucruri pe care i le-ai spus deja, sau le ghicește. Cu CLAUDE.md, le știe din prima.
Seamănă cu o fișă lipită pe frigider pentru cineva care îți ține casa cât ești plecat: „florile se udă marțea, câinele nu primește ciocolată”. Persoana e capabilă, dar nu poate ghici regulile casei tale. Iar fișa trebuie să fie scurtă: nimeni nu citește 30 de pagini.
Ce scrii în el
- Comenzile cu care se pornește și se verifică proiectul.
- Cum e organizat proiectul, în câteva rânduri.
- Stilul: reguli pe care nu le prinde nicio unealtă automată.
- Interdicțiile: ce nu are voie să atingă.
Ce nu scrii: lucruri evidente din fișiere, explicații lungi, istoria proiectului. Fiecare rând se citește la fiecare pornire, deci un fișier lung costă și îl încurcă.
Unde stă
În dosarul proiectului, ca CLAUDE.md. Mai poți avea unul personal, pentru toate proiectele tale (~/.claude/CLAUDE.md), și unul doar pentru tine în proiect (CLAUDE.local.md), pe care nu-l văd colegii. Toate se adună.
Cum îl creezi în 10 secunde
În Claude Code scrii:
/init
Claude se uită prin proiect și scrie singur o primă variantă de CLAUDE.md. Ca să adaugi o regulă, i-o spui direct: „adaugă în CLAUDE.md regula: răspunde-mi mereu în română”. El o scrie în fișier.
Un exemplu scurt
# Site-ul cafenelei
- Pagina e un singur fișier: index.html. Fără biblioteci.
- Textele sunt în română, cu diacritice.
- Nu schimba numărul de telefon și adresa fără să mă întrebi.
- După fiecare modificare, deschide pagina și verifică pe lățime de telefon.
Învață-l pas cu pas
CLAUDE.md este modulul 02 din cursul „Claude Code pentru începători”: unde poate sta fișierul, cum îl ții scurt, un exemplu complet și un laborator în care îl scrii pentru proiectul tău. Primele două module ale cursului sunt gratuite.