Concluzii cheie
- Native în terminal, nu un chatbot: Claude Code rulează direct pe fișierele tale locale, indexează întreaga structură a proiectului și operează printr-un sistem de permisiuni unde aprobi fiecare modificare de fișier și execuție de comandă.
- Plan Mode pentru sarcini complexe: Spune-i lui Claude să își planifice abordarea înainte de a face modificări -- acesta analizează problema, conturează pașii, își arată raționamentul și așteaptă aprobarea ta înainte de execuție.
- Sonnet pentru 80%, Opus pentru 20%: Folosește Sonnet 4.6 pentru sarcinile de zi cu zi (rapid, cost-effective); treci la Opus 4.6 pentru refactorizări complexe multi-fișier, decizii de arhitectură sau Agent Teams.
- CLAUDE.md sporește consecvența: Creează un fișier CLAUDE.md specific proiectului cu convenții de codare, preferințe pentru stiva tehnologică și cerințe de testare pe care Claude le citește automat la fiecare sesiune.
Tutorial Claude Code pentru începători: Ghid complet de inițiere
Claude Code este asistentul de codare AI care trăiește în terminalul tău.
Creat de Anthropic, acesta se conectează direct la baza ta de cod, înțelege structura proiectului tău și scrie cod real pe mașina ta — totul prin intermediul conversației în limbaj natural. De la disponibilitatea sa generală în May 2025, Claude Code a devenit unul dintre cele mai utilizate instrumente de dezvoltare AI, contribuind la atingerea de către Anthropic a peste $1 billion în venituri anualizate până în November 2025.
Acest tutorial te duce de la zero la productiv. Nu este necesară experiență anterioară cu instrumente AI.
Cuprins
- Ce este Claude Code?
- Cerințe prealabile și instalare
- Prima ta sesiune
- Referință comenzi esențiale
- Plan Mode: Gândește înainte de a coda
- Configurarea CLAUDE.md
- Exemple de fluxuri de lucru din lumea reală
- Alegerea între Sonnet 4.6 și Opus 4.6
- Sfaturi pentru a profita la maximum de Claude Code
Ce este Claude Code?
Claude Code este asistentul de codare AI native în terminal al Anthropic. Spre deosebire de chatbot-urile bazate pe browser sau extensiile IDE, acesta rulează direct în terminalul tău și operează pe fișierele tale locale.
Iată ce îl face diferit:
- Conștientizare profundă a bazei de cod — Claude indexează întregul proiect și înțelege cum relaționează fișierele între ele
- Raționament interactiv — își arată procesul de gândire și îți cere input-ul în punctele de decizie
- Execuție locală — editează fișiere și rulează comenzi pe mașina ta, nu într-un sandbox la distanță
- Sistem de permisiuni — fiecare modificare de fișier și execuție de comandă necesită aprobarea ta
Claude Code este alimentat de Claude Opus 4.6 și Claude Sonnet 4.6, cele mai capabile modele Anthropic. Acesta suportă o fereastră de context standard de 200K, cu o versiune beta de 1M tokens disponibilă pe Opus 4.6.
"Claude Code nu este un chatbot. Este un agent de codare care comunică prin intermediul conversației."
Cerințe prealabile și instalare
De ce ai nevoie
Înainte de instalare, asigură-te că ai:
- Un abonament Claude — Claude Pro ($20/month) minim
- O aplicație de terminal — Terminal.app (macOS), terminalul tău Linux preferat sau Windows Terminal
- Un OS acceptat — macOS, Linux sau Windows 11
- Node.js — necesar pentru metoda de instalare npm
Pasul 1: Instalează Claude Code
Deschide terminalul și rulează:
npm install -g @anthropic-ai/claude-code
Alternativ, poți instala prin scriptul oficial:
curl -fsSL https://claude.ai/install.sh | sh
Pasul 2: Verifică instalarea
claude --version
Ar trebui să vezi numărul versiunii curente afișat. Dacă primești o eroare "command not found", asigură-te că directorul bin al Node.js este în PATH-ul tău.
Pasul 3: Navighează către proiectul tău
Claude Code funcționează cel mai bine când este lansat din rădăcina proiectului tău:
cd ~/projects/my-app
claude
Asta este tot. Claude îți va scana proiectul și ești gata de plecare.
Prima ta sesiune
Când lansezi claude pentru prima dată într-un proiect, iată ce se întâmplă:
- Claude indexează fișierele și structura proiectului tău
- Deschide un prompt interactiv unde tastezi în limbaj natural
- Pui întrebări sau dai instrucțiuni, iar Claude răspunde cu cod, editări sau explicații
O primă interacțiune simplă
Încearcă să începi cu ceva de genul acesta:
> What does this project do? Summarize the tech stack and folder structure.
Claude va scana fișierele și îți va oferi o defalcare structurată a proiectului tău — framework-urile, punctele de intrare, modulele cheie.
Continuă cu o sarcină reală:
> Add input validation to the signup form. Email should be validated and password needs at least 8 characters.
Claude va:
- Găsi componenta de formular relevantă
- Îți va arăta planul pentru modificări
- Îți va cere permisiunea înainte de a modifica orice fișier
- Va aplica editările și va confirma ce a fost schimbat
Rămâi sub control pe tot parcursul procesului. Nimic nu se întâmplă fără aprobarea ta.
Referință comenzi esențiale
Acestea sunt comenzile pe care le vei folosi cel mai des într-o sesiune Claude Code:
| Comandă | Ce face |
|---|---|
claude | Pornește o nouă sesiune Claude Code |
/help | Afișează toate comenzile disponibile |
/plan | Intră în Plan Mode — Claude planifică înainte de a executa |
/clear | Șterge contextul conversației și începe de la zero |
/cost | Afișează utilizarea de tokens și costurile estimate pentru sesiune |
/compact | Comprimă conversația pentru a economisi spațiu în fereastra de context |
Nu este nevoie să memorezi comenzile slash pentru a fi productiv. De cele mai multe ori, pur și simplu tastezi cererea în limbaj natural și Claude își dă seama de restul.
Plan Mode: Gândește înainte de a coda
Plan Mode este una dintre cele mai importante caracteristici ale Claude Code, în special pentru începători.
Când intri în Plan Mode cu /plan, Claude își schimbă comportamentul:
- Analizează problema — citește fișierele relevante, urmărește dependențele, identifică zonele afectate
- Conturează un plan pas cu pas — ce va schimba, în ce ordine și de ce
- Își arată raționamentul — vezi cum gândește Claude problema
- Așteaptă aprobarea ta — nimic nu este executat până când nu spui "start"
Când să folosești Plan Mode
- Refactorizare complexă — redenumirea unui modul care este importat în zeci de fișiere
- Funcționalități multi-fișier — adăugarea unui nou endpoint API care atinge rute, controllere, modele și teste
- Baze de cod necunoscute — când vrei să înțelegi impactul înainte de a face modificări
- Învățare — citirea raționamentului lui Claude te ajută să îți înțelegi mai bine propria bază de cod
Exemplu: Plan Mode în acțiune
> /plan
> Refactor the authentication module to use JWT tokens instead of session cookies.
Claude va răspunde cu ceva de genul:
Here is my plan:
- Update
auth/middleware.jsto verify JWT tokens instead of checking session store- Modify
auth/login.jsto generate and return a JWT on successful login- Update
auth/logout.jsto handle token invalidation- Adjust the API client in
frontend/src/api.jsto send tokens in the Authorization header- Update 3 test files to use JWT-based authentication fixtures
Shall I proceed?
Revizuiești, pui întrebări, ajustezi planul dacă este necesar și apoi aprobi.
Configurarea CLAUDE.md
CLAUDE.md este un fișier special pe care Claude îl citește automat la începutul fiecărei sesiuni. Gândește-te la el ca la un fișier de configurare pentru modul în care Claude ar trebui să se comporte în proiectul tău.
Creează-ți CLAUDE.md
Plasează-l în rădăcina proiectului tău:
# Project: My SaaS App
## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL with Prisma ORM
## Coding Conventions
- Use functional components with hooks (no class components)
- All functions must have TypeScript return types
- Use named exports, not default exports
- Write tests for all new utility functions
## Testing
- Run tests with: npm run test
- Use Vitest for unit tests
- Test files go in __tests__ directories next to source files
## Git
- Conventional commits: feat(), fix(), refactor()
- Always create a new branch for features
De ce contează CLAUDE.md
Fără CLAUDE.md, Claude face presupuneri rezonabile despre convențiile tale. Cu acesta, Claude îți urmează standardele exacte de la primul prompt. Acest lucru este deosebit de valoros în echipe unde consecvența contează.
Exemple de fluxuri de lucru din lumea reală
Depanarea unei probleme de producție
> Users are reporting that the dashboard takes 15 seconds to load.
> Check the API calls on the dashboard page and identify any performance bottlenecks.
Claude va urmări componenta de dashboard, va găsi apelurile API, va verifica interogările N+1 sau indexurile lipsă și va sugera soluții specifice.
Adăugarea unei funcționalități noi
> Add a dark mode toggle to the app. It should persist the user's preference
> in localStorage and apply on page load without a flash of unstyled content.
Claude va identifica unde să adauge componenta de comutare, va configura contextul temei, va adăuga logica localStorage și va gestiona corect randarea inițială.
Refactorizarea codului vechi
> /plan
> This file uses callback-based async patterns. Refactor it to use async/await
> while keeping the same external API.
Claude planifică refactorizarea, arată ce funcții se schimbă și confirmă că nimic nu se strică extern înainte de a continua.
Integrarea Git
Claude Code funcționează direct cu Git. Îi poți cere să:
> Create a new branch called feat/dark-mode, commit the changes we just made,
> and open a pull request with a description of what was changed.
Claude va crea branch-ul, va adăuga fișierele în stage, va scrie un mesaj de commit și va folosi GitHub CLI pentru a deschide un PR — totul în cadrul sesiunii tale de terminal.
Alegerea între Sonnet 4.6 și Opus 4.6
Claude Code îți oferă acces la două modele. Alegerea celui potrivit îți economisește timp și bani.
| Sonnet 4.6 | Opus 4.6 | |
|---|---|---|
| Viteză | Rapid | Mai lent |
| Cost (API) | $3 / $15 per 1M tokens | $15 / $75 per 1M tokens |
| Cel mai bun pentru | Majoritatea sarcinilor de codare zilnice | Arhitectură complexă, refactorizare multi-fișier |
| Fereastră de context | 200K tokens | 200K standard, 1M beta |
| Agent Teams | Indisponibil | Disponibil (doar Opus) |
Regula 80/20
Folosește Sonnet 4.6 pentru aproximativ 80% din munca ta: scrierea de funcții, repararea bug-urilor, adăugarea de funcționalități, scrierea de teste, explicarea codului. Este rapid, ieftin și mai mult decât capabil.
Treci la Opus 4.6 pentru cele mai dificile 20%: refactorizări la scară largă în multe fișiere, decizii complexe de arhitectură, Agent Teams pentru lucru în paralel sau când ai nevoie de fereastra de context de 1M tokens pentru analiza unei baze de cod mari.
Sfaturi pentru a profita la maximum de Claude Code
1. Începe fiecare proiect cu context. Înainte de a trece la sarcini, cere-i lui Claude să rezume ce face proiectul. Acest lucru îl ajută pe Claude să construiască un model mental precis și rezultă într-un cod mai bun de la primul prompt.
> What does this project do? Walk me through the architecture.
2. Folosește Plan Mode pentru orice este complex.
Dacă o sarcină atinge mai mult de două fișiere, folosește /plan. Costul inițial al planificării te scutește de modificări incorecte care sunt mai greu de anulat.
3. Fii specific în cererile tale.
În loc de "fă codul mai bun", încearcă "refactorizează funcția processPayment pentru a gestiona taxele Stripe eșuate și reîncearcă de până la 3 ori cu exponential backoff."
4. Folosește /compact când atingi limitele de context.
Sesiunile lungi acumulează context. Când Claude începe să piardă șirul conversațiilor anterioare, rulează /compact pentru a comprima istoricul și a elibera spațiu.
5. Creează și menține fișierul tău CLAUDE.md.
Acesta este singurul lucru cu cel mai mare impact pe care îl poți face. Un CLAUDE.md bun elimină corecțiile repetitive și îl menține pe Claude aliniat cu standardele echipei tale.
6. Revizuiește diferențele (diffs) înainte de a aproba. Sistemul de permisiuni al Claude există cu un motiv. Citește modificările propuse, în special pentru baze de cod necunoscute. Claude este puternic, dar nu infailibil.
7. Folosește integrarea Git pentru fluxuri de lucru curate. Lasă-l pe Claude să se ocupe de părțile mecanice ale Git — ramificare, comitere, scrierea descrierilor de PR — astfel încât să te poți concentra pe revizuirea modificărilor efective ale codului.
8. Înlanțuiește sarcinile într-o singură sesiune. Claude reține contextul într-o sesiune. După construirea unei funcționalități, continuă imediat cu "acum scrie teste pentru ceea ce tocmai am adăugat" — Claude cunoaște deja codul.
Ce urmează?
Acum ai tot ce îți trebuie pentru a începe să folosești Claude Code în mod productiv. Curba de învățare este scurtă: majoritatea dezvoltatorilor își găsesc ritmul în primele câteva sesiuni.
Pe măsură ce te simți confortabil, explorează aceste capacități mai avansate:
- Agent Teams — lansează mai multe instanțe Claude pentru lucru în paralel pe proiecte mari (doar Opus 4.6)
- Fereastră de context de 1M tokens — analizează baze de cod masive într-o singură sesiune (Opus 4.6 beta)
- Comenzi slash personalizate — automatizează fluxurile de lucru repetitive cu comenzi specifice proiectului
- Integrare CI/CD — rulează Claude Code ca parte a fluxului tău de construcție și revizuire
