Tutorial Claude Code în română, pas cu pas

Actualizat pe 7 octombrie 2026

Acest tutorial te duce de la zero la primul proiect făcut cu Claude Code: îl instalezi, te conectezi, pornești prima conversație, înveți cum să-i ceri lucruri și construiești o pagină simplă. Nu trebuie să știi programare; ai nevoie de un calculator, de un abonament Claude plătit și de cam o oră.

Tutorialul adună, într-un singur loc, ideile din primele două module ale cursului „Claude Code pentru începători”. Comenzile sunt cele din documentația oficială Claude Code, verificate la 7 octombrie 2026.

Ce este Claude Code, într-o propoziție?

Claude Code este un agent cu inteligență artificială care lucrează pe calculatorul tău: citește fișierele proiectului, le modifică, rulează comenzi și verifică rezultatul, doar cu permisiunea ta.

Diferența față de un chat: nu primești doar un răspuns pe care îl copiezi tu, ci un ajutor care face treaba în dosarul tău. Gândește-te la un meșter priceput pe care îl chemi acasă: îi spui ce vrei, el se uită, își face un plan și lucrează, dar te întreabă înainte să dea o gaură în perete. Pe larg, în ghidul ce este Claude Code.

De ce ai nevoie înainte să începi?

  • Un calculator cu macOS 13 sau mai nou, Windows 10 (versiunea 1809) sau mai nou, ori Linux.
  • Un abonament Claude plătit: Pro, Max, Team sau Enterprise. Cel mai ieftin, Pro, costă 20 $ pe lună, plus taxe, sau 17 $ pe lună la plata anuală (claude.com/pricing, verificat la 7 octombrie 2026). Planul gratuit nu include Claude Code. Detalii în cât costă Claude Code.
  • Conexiune la internet și cam o oră liberă pentru tot tutorialul.

Nu-ți trebuie alte programe instalate dinainte.

Pasul 1. Cum deschizi terminalul?

Terminalul este o fereastră în care scrii comenzi ca text, în loc să dai click pe butoane. Nu strici nimic doar deschizându-l.

  • Pe Mac: apasă Cmd + Space, scrie „Terminal” și apasă Enter.
  • Pe Windows: apasă tasta Windows, scrie „PowerShell” și dă click pe „Windows PowerShell”.

Vei vedea un rând scurt care se termină cu %, $ sau > și un cursor care clipește. Acela e rândul de comandă: locul unde terminalul așteaptă să scrii. O comandă înseamnă un rând de text plus Enter. Când reapare rândul de comandă, înseamnă „gata, aștept următoarea”.

Trei sfaturi pentru început:

  • copiază comenzile exact; un spațiu lipsă schimbă totul;
  • dacă vezi mult text care curge, e normal: așteaptă;
  • rândurile care încep cu # din exemple sunt doar explicații.

Mai multe în lecția ce este terminalul și cum îl deschizi.

Pasul 2. Cum instalezi Claude Code?

Scrii o singură comandă, potrivită calculatorului tău, și apeși Enter.

Pe Mac sau Linux:

curl -fsSL https://claude.ai/install.sh | bash

Pe Windows (PowerShell):

irm https://claude.ai/install.ps1 | iex

Comanda descarcă programul de instalare de pe site-ul oficial și îl pornește. Când se termină, închide terminalul, deschide unul nou și verifică:

claude --version
claude doctor

Dacă vezi un număr de versiune, e instalat. claude doctor face un control complet și îți spune dacă ceva nu e în regulă. Dacă apare „command not found”, închide terminalul și deschide unul nou. Erorile frecvente și soluțiile lor sunt în ghidul cum instalezi Claude Code pe Mac și pe Windows.

Pasul 3. Cum te conectezi la cont?

Scrii claude și apeși Enter. Prima dată se deschide browserul, iar tu te loghezi cu contul de pe claude.ai. După asta, rămâi conectat; nu te mai loghezi la fiecare pornire.

Dacă vrei să schimbi contul, scrii /login în Claude. Pe lângă abonament, te poți conecta și cu un cont Claude Console, unde plătești după consum. Pentru început, abonamentul e mai simplu.

Pasul 4. Cum pornești prima conversație?

Un proiect e pur și simplu un dosar cu fișiere. Faci un dosar nou și pornești Claude în el:

mkdir primul-proiect
cd primul-proiect
claude

mkdir face dosarul, cd intră în el, iar claude pornește Claude Code acolo. Vezi un ecran de bun venit și un loc unde scrii. În exemplele de mai jos, semnul > arată unde scrii tu; nu-l copia.

Prima ta cerere poate fi foarte simplă:

> Salut! Spune-mi pe scurt ce poți face pentru mine în dosarul ăsta.

Claude îți răspunde în română. Într-un dosar cu fișiere, le citește singur și îți explică ce sunt. Nu modifică nimic fără să te întrebe.

Pasul 5. Ce taste și comenzi îți trebuie de la început?

Puține. Acestea ajung pentru primele săptămâni:

Tastă sau comandă Ce face
Enter Trimite mesajul
Esc Îl oprește pe Claude din ce face
Shift+Tab Schimbă modul de lucru (de exemplu, modul „plan”, în care doar propune)
@fișier Îi arată un anumit fișier
/clear Golește conversația și începi curat
/help Lista de comenzi
/init Creează fișierul CLAUDE.md, memoria proiectului

Comenzile care încep cu / se numesc comenzi slash și le scrii în Claude, nu în terminalul obișnuit. Lista completă și explicată e în lecția care sunt comenzile slash principale.

Un cuvânt pe care îl vei auzi des: contextul. E tot ce „ține minte” Claude în conversația curentă: mesajele, fișierele citite, rezultatele comenzilor. Ca o masă de lucru: dacă e prea aglomerată, lucrează mai prost. De aceea, la o sarcină nouă, scrii /clear. Vezi și context în glosar.

Pasul 6. Cum arată un mesaj bun pentru Claude?

Mesajul pe care i-l scrii se numește prompt. Claude e foarte priceput, dar vede proiectul tău pentru prima dată și nu ține minte conversațiile de ieri. Un prompt bun are patru părți:

[Ce să facă] + [Unde] + [Ce să nu atingă] + [Cum se verifică]

Comparația, pe un exemplu cu site-ul unei cafenele:

Prost (Claude trebuie să ghicească aproape tot):

> repară butonul

Bine:

> Pe telefon, butonul „Rezervă” nu face nimic când îl apeși.
  Ar trebui să deschidă WhatsApp. Uită-te în index.html, la secțiunea de rezervări.
  Nu schimba culorile și textele. Verifică: spune-mi ce link are butonul acum
  și ce link are după reparație.

Al doilea spune ce se întâmplă, unde să caute, ce să lase în pace și cum îți arată că a reușit. Pe larg, în lecția cum arată un mesaj bun.

Pasul 7. Ce trucuri te ajută să lucrezi mai bine?

  • Cere-i să te întrebe el. Când nu știi ce să-i spui, scrie: „înainte să începi, pune-mi întrebările de care ai nevoie, câte una pe rând”. Așa află de la tine ce-i trebuie, în loc să inventeze.
  • Arată-i fișiere cu @. De exemplu: „fă pagina @meniu.html în același stil ca @index.html”.
  • Dă exemple și poze. Poți trage o captură de ecran în terminal; Claude o citește.
  • Cere planul întâi. „Stop, arată-mi mai întâi planul” e mai bine decât să corectezi apoi zece fișiere.
  • O conversație, o sarcină. La sarcină nouă, /clear.
  • Oprește-l devreme. Dacă o ia pe un drum greșit, apasă Esc și reformulează.

Toate, cu exemple pe care le încerci într-un terminal de exercițiu, în lecția ce trucuri te ajută.

Pasul 8. Cum faci primul proiect: o pagină pentru o cafenea?

Acum le pui pe toate cap la cap. În dosarul primul-proiect, cu Claude pornit, scrie:

> Vreau să construiesc site-ul de o singură pagină al unei cafenele.
  Înainte să începi, pune-mi întrebările de care ai nevoie, câte una pe rând.
  Nu scrie niciun fișier până nu-ți spun „începe”.

Răspunde scurt la întrebări (nume, program, meniu, telefon). Unde nu știi, scrie „alege tu”. Apoi:

> Începe. Un singur fișier, index.html, fără biblioteci.
  Trebuie să arate bine pe telefon. Butonul de rezervare deschide WhatsApp.

Claude îți arată fișierul și îți cere voie. Aprobi. Apoi îi ceri „deschide-mi index.html în browser”, te uiți ca un client și ceri corecturi una câte una. La final, îi ceri să verifice singur: „linkul de WhatsApp are formatul corect? Se citește bine pe telefon?”.

Ai făcut primul proiect. Ca să-l pui pe internet și să primești un link pe care îl trimiți oricui, urmează pașii din ghidul cum faci un site cu AI sau din laboratorul 0 al cursului.

Ce greșeli fac cei mai mulți începători?

Greșeala Ce faci în loc
„Fă totul bine” Spune clar când e gata și cum se verifică
O singură conversație de trei ore pentru cinci sarcini /clear între sarcini
Corectezi a cincea oară aceeași greșeală /clear și un mesaj nou, mai bun, cu ce ai învățat
Accepți totul fără să te uiți Verifică mai ales ce ajunge la clienți: prețuri, program, telefon
Lucrezi direct în documentele importante Începe într-un dosar de test

Ce urmează după acest tutorial?

După primele două module, următorul pas firesc este CLAUDE.md, fișierul în care scrii regulile proiectului ca să nu le repeți. Apoi permisiunile (ce are voie Claude să facă singur), o metodă de lucru pas cu pas și unelte mai avansate. Toate sunt în cursul complet, iar cuvintele noi le găsești în glosar.

Întrebări frecvente

Cât durează să învăț Claude Code?

Primii pași, de la instalare la prima pagină, îți iau cam o oră. Ca să lucrezi sigur pe tine, exersează câteva seri, pe proiecte mici.

Pot învăța Claude Code fără abonament?

Poți citi tutorialul și lecțiile gratuite. Ca să lucrezi efectiv cu el, îți trebuie un abonament Claude plătit sau un cont Claude Console cu credit.

Trebuie să știu engleză?

Nu. Îi scrii în română și îți răspunde în română. Comenzile sunt puține și le înveți repede.

Merge și de pe telefon?

Lecțiile cursului se pot face de pe telefon. Claude Code îl folosești pe telefon din aplicația Claude sau pe web, la claude.ai/code; instalarea din acest tutorial e pentru calculator.

Fă tutorialul ca un curs, cu exerciții

Cursul „Claude Code pentru începători” are aceleași idei, în lecții de 1–2 minute, cu quiz, carduri de repetat și un terminal de exercițiu în care încerci comenzile fără riscuri. Primele două module și laboratorul 0 sunt gratuite, fără card.

Începe prima lecție, gratuit