CLAUDE.md (fișier de ghidare) în Claude Code CLI

CLAUDE.md (plasat în rădăcina proiectului)

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.md de 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.

Comenzi înrudite

• slash-init
• slash-review
• claude