Claude Code: ce este și cum îl folosești (ghid practic în română)

Claude Code este unealta pe care o folosim cel mai des la Poligon pentru a construi software. Pentru că nu am găsit un ghid bun în română, l-am scris pe acesta: ce este, cum începi și ce am învățat folosindu-l pe proiecte reale.

Claude Code se schimbă repede. Detaliile de mai jos sunt corecte la data publicării; pentru instalare și opțiuni, verifică întotdeauna documentația oficială Anthropic.

Ce este Claude Code

Claude Code este un agent AI de programare. Diferența față de un chat cu AI este că nu copiezi cod înainte și înapoi: agentul lucrează direct în proiectul tău.

Concret, Claude Code poate:

• să citească și să caute în tot codul proiectului,
• să editeze fișiere și să creeze fișiere noi,
• să ruleze comenzi: build, teste, git, scripturi,
• să verifice ce a făcut: rulează testele, citește erorile și corectează.

Rulează în terminal, dar și în editoare precum VS Code și JetBrains, în aplicația desktop și pe web. Modelul (Claude) decide pasul următor; Claude Code este „harness-ul” din jurul lui, adică uneltele, contextul și permisiunile. Am explicat conceptul pe larg, în engleză, în What is an agent harness?

Primii pași

1. Instalează-l urmând instrucțiunile din documentația oficială (există un installer nativ și varianta prin npm).
2. Intră în folderul proiectului în terminal.
3. Pornește-l scriind claude. La prima rulare te autentifici cu contul Claude sau cu o cheie API.
4. Descrie sarcina în limbaj natural. De exemplu: „Explică-mi cum e organizat proiectul ăsta” sau „Adaugă validare pe formularul de contact și rulează build-ul”.

Primul lucru pe care îl recomandăm într-un proiect nou: rulează /init. Claude Code analizează codul și propune un fișier CLAUDE.md.

CLAUDE.md: ce trebuie să știe mereu

CLAUDE.md este un fișier Markdown din rădăcina proiectului, încărcat la începutul fiecărei sesiuni. Acolo pui lucrurile pe care agentul le-ar greși altfel:

# Note proiect
- Site Astro 5, static, publicat pe Firebase Hosting.
- `npm run dev` pentru dezvoltare, `npm run build` pentru verificare.
- Paginile în română sunt sub /ro și se scriu separat, nu se traduc.
- Nu inventăm cifre sau nume de clienți în texte.

Ține-l scurt. Fiecare rând consumă context în fiecare sesiune. Ce contează doar pentru un anumit tip de sarcină merge într-un skill.

Moduri de lucru și permisiuni

Claude Code cere voie înainte de acțiunile cu risc, cum ar fi editarea fișierelor sau rularea comenzilor. Poți alege cât de mult îi permiți:

• modul implicit: cere aprobare pentru editări și comenzi;
• acceptarea automată a editărilor, când ai încredere în sarcină;
• plan mode: agentul doar citește și propune un plan, fără să modifice nimic. Foarte util la sarcini mari, înainte să începi.

Modurile se schimbă rapid din tastatură (Shift+Tab). Regula noastră: plan mode pentru orice depășește câteva fișiere, apoi execuție pe un branch separat.

Cum îl extinzi: skills, hooks, subagenți, MCP

Aici Claude Code devine cu adevărat util pentru o echipă.

Mecanism	Ce este	Folosește-l pentru
Skill	Un folder cu SKILL.md în .claude/skills/	Proceduri folosite ocazional: release, migrații, checklist de review
Hook	O comandă rulată automat la un eveniment	Reguli care trebuie respectate mereu: formatare, blocarea comenzilor periculoase
Subagent	Un agent separat, cu context propriu, în .claude/agents/	Sarcini laterale: căutare în cod, review, cercetare
Server MCP	Un program care expune unelte către agent	Conectarea la sisteme externe: baze de date, ticketing, ERP

Pe scurt: cunoștințele merg în CLAUDE.md sau în skills, regulile obligatorii în hooks, sarcinile zgomotoase în subagenți, iar sistemele externe vin prin MCP.

Am scris un ghid detaliat, cu exemple de cod, în engleză: Claude Code skills, hooks and subagents. Pentru conectarea la un ERP prin MCP, vezi How to build an MCP server for your ERP.

Ce am învățat folosindu-l pe proiecte reale

Sarcinile mici bat sarcinile mari. „Construiește tot modulul de facturare” produce mult cod greu de verificat. „Adaugă câmpul X, validarea Y și un test pentru cazul Z” produce cod pe care îl poți revizui în cinci minute.

Verificarea e partea ta. Agentul scrie repede, dar responsabilitatea rămâne la om. Cere-i să ruleze build-ul și testele, apoi citește diff-ul înainte de commit.

Contextul contează mai mult decât promptul. Un CLAUDE.md bun și câteva skills bine descrise fac mai mult decât orice formulare „magică” a cererii.

Pune regulile importante în hooks, nu în instrucțiuni. Dacă ceva nu trebuie să se întâmple niciodată, cum ar fi un force-push pe main, blochează-l cu un hook. Instrucțiunile pot fi ignorate, hook-urile nu.

Lucrează pe branch-uri. Agentul poate greși. Un branch separat face orice greșeală ușor de anulat.

Claude Code, Cursor sau Codex?

Întrebarea apare des. Toate trei sunt agenți de programare buni, iar diferențele țin mai ales de stilul de lucru:

• Claude Code pornește din terminal, se integrează în editoare și se extinde foarte bine prin skills, hooks, subagenți și MCP.
• Cursor este un editor de cod cu AI integrat, comod dacă vrei totul într-o singură interfață.
• Codex este agentul de programare de la OpenAI, cu variante pentru terminal și cloud.

Sfatul nostru: alege unul, folosește-l două săptămâni pe un proiect real și investește în context (CLAUDE.md, skills). Diferența dintre o echipă care obține rezultate și una care nu ține mai mult de cum folosește unealta decât de unealta aleasă.

De la programare la operațiuni

Aceleași principii folosim și când construim agenți AI pentru echipele operaționale: unelte înguste, permisiuni minime, aprobare umană pentru deciziile importante și un istoric clar al fiecărei acțiuni. Dacă vreți să vedeți cum arată asta pentru o firmă, citiți Agenți AI pentru firme.