Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md este un fișier de configurare markdown plasat în rădăcina proiectului care oferă Claude Code instrucțiuni persistente, specifice proiectului. Îi spune agentului despre convențiile de programare, arhitectură, comenzile comune și regulile — acționând ca o formă de memorie pe termen lung care se aplică fiecărei sesiuni din acel proiect.

Cum funcționează CLAUDE.md

Când Claude Code pornește o sesiune, citește automat fișierul CLAUDE.md din rădăcina proiectului (și orice fișiere CLAUDE.md din directoarele părinte sau subdirectoare). Conținutul devine parte din contextul de sistem al agentului, astfel încât acesta urmează instrucțiunile tale fără a fi necesar să fie reamintite la fiecare sesiune. Aceasta face ca agentul să se comporte în mod consistent cu convențiile echipei tale.

Ce să incluzi în CLAUDE.md

  • +Prezentare generală a arhitecturii proiectului și locațiile cheie ale fișierelor
  • +Convenții de cod (denumiri, formatare, tipare de folosit sau de evitat)
  • +Comenzi comune pentru testare, construire și deployment
  • +Reguli precum "scrie întotdeauna teste pentru funcțiile noi" sau "nu modifica niciodată direct modulul de autentificare"
  • +Detalii despre stiva tehnologică de care agentul ar trebui să fie conștient
markdown
# CLAUDE.md

## Proiect
Aplicație Next.js 14 cu App Router, TypeScript, Tailwind CSS.

## Comenzi
- `npm run dev` — pornire server de dezvoltare
- `npm test` — rulare teste Jest
- `npm run lint` — verificare ESLint

## Convenții
- Folosește componente server în mod implicit
- Componentele client merg în `components/client/`
- Toate rutele API trebuie să valideze inputul cu Zod
- Scrie teste pentru fiecare funcție utilitară nouă

## NU
- Modifica fișierele din `lib/core/` fără aprobare explicită
- Folosi tipul `any` în TypeScript
- Adăuga dependențe noi fără justificare

Menține CLAUDE.md concis. Agentul îl citește la fiecare sesiune, deci include doar informații relevante pentru mai multe sarcini. Mută detaliile specifice sarcinii în prompturile tale.

Unde ar trebui să plasez fișierul CLAUDE.md?+
Plasează-l în rădăcina directorului proiectului tău. Claude Code suportă și fișiere CLAUDE.md în subdirectoare pentru instrucțiuni specifice modulului și în directoarele părinte pentru regulile la nivel de organizație. Toate fișierele aplicabile sunt îmbinate împreună.
Funcționează CLAUDE.md cu alte instrumente AI?+
CLAUDE.md este specific Claude Code. Totuși, unele alte instrumente au adoptat concepte similare. Cursor folosește .cursorrules, iar alți agenți pot citi fișiere de configurare personalizate. Conceptul instrucțiunilor AI la nivel de proiect devine un tipar comun.
Cât de lung ar trebui să fie CLAUDE.md?+
Menține-l sub 500 de linii. Concentrează-te pe cele mai importante convenții și reguli. Agentul poate citi oricând fișiere individuale pentru detalii — CLAUDE.md ar trebui să ofere contextul de nivel înalt care se aplică tuturor sarcinilor.

Related terms

Programare AgenticăClaude CodeIngineria Prompturilor pentru Cod

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS