Ce face CLAUDE.md (fișier de ghidare)
CLAUDE.md este echivalentul unui fișier README scris special pentru asistenții AI de programare. Este citit automat la fiecare lansare a lui Claude Code în acel director.
Aici definești: comenzile standard de build și test, stilul de formatare, convențiile de denumire, regulile de arhitectură (ce librării sunt permise sau interzise) și capcanele cunoscute ale codebase-ului.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
# Build & Test |
Secțiunea care descrie exact cum se compilează codul și cum se rulează testele unitare. |
# Code Style |
Reguli de stil (ex. ‘preferă funcții pure’, ‘folosește diacritice în mesaje’, ‘fără variabile any’). |
# Architecture |
Harta la nivel înalt a modulelor și fluxul de date din aplicație. |
Exemple practice de terminal
Exemplul 1: Exemplu complet de fișier CLAUDE.md pentru un proiect real
Formatul markdown clar și concis recomandat de Anthropic.
# CLAUDE.md
## Comenzi de lucru
- Compilare: `npm run build`
- Teste: `npm test`
- Test singular: `npm test -- path/to/test.ts`
- Verificare tipuri: `npx tsc --noEmit`
## Convenții de cod
- Folosește exclusiv TypeScript în mod strict.
- Toate textele utilizator sunt în limba română cu diacritice (ș, ț, ă, î, â).
- Nu include console.log în codul de producție.
- Nu modifica direct migrațiile SQL deja aplicate; creează o migrație nouă.Ieșire în terminal
Fișierul este încărcat automat în context la fiecare pornire a comenzii `claude`.Greșeli frecvente și bune practici
- Scrii un
CLAUDE.mdde sute de paragrafe inutile cu tutoriale generale; fișierul trebuie să fie scurt, pragmatic și axat strict pe comenzile și regulile unice ale proiectului tău.