Concluzii cheie
- Două metode de instalare: Folosește instalerul nativ (
curl -fsSL https://claude.ai/install.sh | bash) pentru o configurare fără dependențe, sau npm (npm install -g @anthropic-ai/claude-code) dacă ai nevoie de fixarea versiunii. - Cerințele de sistem sunt minime: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+), sau Windows 10+ cu WSL. Cel puțin 4GB RAM. Nu este necesar un GPU.
- Cont necesar: Ai nevoie de un cont Claude Pro, Max, Teams, Enterprise, sau Console (API). Planul gratuit Claude.ai nu include acces la Claude Code.
- Configurarea durează mai puțin de cinci minute: Instalează, autentifică-te în browser și începe să folosești Claude Code în orice director de proiect imediat.
Cum să instalezi Claude Code: Ghid complet de configurare (2026)
Claude Code este asistentul de codare AI de la Anthropic care rulează direct în terminalul tău. Acesta citește baza de cod, scrie cod, rulează comenzi și gestionează editări complexe de fișiere multiple -- totul dintr-o singură CLI.
Spre deosebire de instrumentele de chat AI bazate pe browser, Claude Code operează în interiorul mediului tău real de dezvoltare. Acesta vede structura fișierelor tale, înțelege contextul proiectului și face modificări în fișiere reale pe mașina ta.
Acest ghid te va conduce prin fiecare pas al instalării Claude Code în 2026, de la verificarea cerințelor prealabile până la rularea primei tale sesiuni de codare asistată de AI. Indiferent dacă ești pe macOS, Linux, sau Windows, vei avea Claude Code funcțional în mai puțin de cinci minute.
De ce ai nevoie (Lista de cerințe prealabile)
Înainte de a instala Claude Code, confirmă că ai următoarele:
- Sistem de operare: macOS 13.0 (Ventura) sau mai recent, Ubuntu 20.04+ sau Debian 10+, sau Windows 10 (versiunea 1809+) cu WSL
- RAM: Cel puțin 4GB (8GB recomandați pentru baze de cod mai mari)
- Conexiune la internet: Claude Code se conectează la cloud-ul API al Anthropic, deci o conexiune activă este necesară
- Cont Anthropic: Un cont Claude Pro ($20/lună), Claude Max ($100-200/lună), Teams, Enterprise, sau Console (API)
- Terminal: Bash, Zsh, sau PowerShell
- Node.js 18+ (necesar doar pentru metoda de instalare prin npm)
Nu ai nevoie de un GPU. Toată procesarea AI are loc pe serverele Anthropic. Mașina ta trebuie doar să ruleze clientul CLI și să trimită cereri prin rețea.
Pasul 1: Instalează Node.js (Dacă nu îl ai deja)
Dacă intenționezi să folosești metoda de instalare prin npm, ai nevoie de Node.js 18 sau o versiune superioară. Dacă ai deja Node.js instalat, verifică versiunea:
node --version
Dacă rezultatul afișează v18.0.0 sau mai mult, treci la Pasul 2. Dacă nu, instalează sau actualizează Node.js folosind nvm (Node Version Manager), care este abordarea recomandată deoarece evită problemele de permisiuni și îți permite să schimbi ușor între versiunile Node.
Instalează nvm pe macOS sau Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Închide și redeschide terminalul, apoi instalează Node.js:
nvm install 22
nvm use 22
node --version
Ar trebui să vezi un număr de versiune care începe cu v22. Node.js 22 este versiunea curentă LTS și funcționează perfect cu Claude Code.
Instalează Node.js pe Windows (în interiorul WSL):
Mai întâi, asigură-te că WSL este instalat (vezi secțiunea Windows de mai jos). Apoi deschide terminalul WSL și rulează aceleași comenzi nvm de mai sus.
Pasul 2: Instalează Claude Code
Ai două opțiuni pentru instalarea Claude Code. Instalerul nativ este acum metoda recomandată, dar npm rămâne pe deplin acceptat.
Opțiunea A: Instalerul nativ (Recomandat)
Instalerul nativ necesită zero dependențe -- fără Node.js, fără npm. Se actualizează automat în fundal și este metoda principală pe care Anthropic o testează și o susține.
macOS și Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, ca Administrator):
irm https://claude.ai/install.ps1 | iex
Instalerul descarcă binarul Claude Code, îl plasează în PATH-ul tău și configurează actualizările automate. Întregul proces durează mai puțin de un minut.
Opțiunea B: Instalare prin npm
Dacă preferi npm -- de exemplu, pentru a fixa o anumită versiune sau pentru că npm este standard în fluxul tău de lucru -- rulează:
npm install -g @anthropic-ai/claude-code
Important: Nu folosi sudo cu npm install. Dacă primești erori de permisiuni, soluția corectă este să folosești nvm (care instalează Node.js în directorul tău home) în loc să rulezi npm ca root.
Verifică instalarea
Indiferent de metoda aleasă, verifică dacă Claude Code este instalat:
claude --version
Ar trebui să vezi un număr de versiune. De asemenea, poți rula diagnosticul integrat:
claude doctor
Această comandă verifică mediul tău și raportează orice probleme de configurare.
Pasul 3: Autentificarea
Claude Code necesită autentificare înainte de a-l putea folosi. Rulează:
claude
Prima dată când rulezi această comandă, Claude Code deschide browserul tău web implicit și îți cere să te conectezi la contul tău Anthropic. Urmează instrucțiunile pentru a autoriza CLI.
Opțiuni de autentificare
Login bazat pe browser (implicit): Cel mai bun pentru mașinile personale. Claude Code deschide o fereastră de browser, te conectezi, iar CLI primește automat un token de autentificare. Aceasta funcționează cu conturile Claude Pro, Max, Teams și Enterprise.
Cheie API (pentru CI/CD și automatizare): Dacă rulezi Claude Code într-un mediu headless sau într-un pipeline CI/CD, setează cheia API ca variabilă de mediu:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Poți genera o cheie API din Anthropic Console. Utilizarea API este facturată per tokens la tarifele publicate de Anthropic.
Abonament vs. facturare API: Cu un abonament Pro sau Max, utilizarea ta Claude Code este inclusă în planul lunar (sub rezerva limitelor de utilizare). Cu o cheie API din Console, plătești per token. Alege în funcție de volumul tău de utilizare -- abonamentele sunt mai simple pentru utilizarea regulată, în timp ce facturarea API îți oferă mai mult control pentru volume de lucru variabile sau automatizate.
Pasul 4: Primul tău proiect
Acum că Claude Code este instalat și autentificat, încearcă-l pe un proiect real.
Navighează în orice director de proiect:
cd ~/my-project
Pornește Claude Code:
claude
Acum ești într-o sesiune interactivă. Claude Code a citit structura proiectului tău și este gata să te ajute. Încearcă să îi dai o sarcină:
> Explain the architecture of this project
Claude Code va scana fișierele tale, va identifica stiva tehnologică și îți va oferi un rezumat al modului în care este organizat proiectul.
Încearcă ceva mai practic:
> Add input validation to the user registration form
Claude Code va identifica fișierele relevante, va propune modificări și îți va cere confirmarea înainte de a modifica ceva. Tu revizuiești fiecare modificare într-o vizualizare diff și o accepți sau o respingi.
Pentru o sarcină punctuală fără a intra în modul interactiv, folosește flag-ul -p:
claude -p "Write unit tests for the auth module"
Aceasta rulează sarcina, afișează rezultatul și iese -- util pentru scripturi și întrebări rapide.
Pasul 5: Configurare esențială
Claude Code funcționează direct cu setări implicite rezonabile, dar poți personaliza comportamentul său pentru fluxul tău de lucru.
Selecția modelului
Claude Code folosește implicit cel mai recent model Claude. Pentru a specifica un model diferit:
claude config set model claude-opus-4-6
Sau pentru o singură sesiune:
claude --model claude-sonnet-4-20250514
Permisiuni
Claude Code cere confirmare înainte de a efectua acțiuni potențial distructive, cum ar fi scrierea fișierelor sau rularea comenzilor shell. Poți configura acest comportament:
claude config set permissions.auto-accept-edits true
Setări la nivel de proiect
Creează un fișier .claude/settings.json în rădăcina proiectului tău pentru a defini configurația partajată cu echipa:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Acest fișier ar trebui să fie adăugat în controlul versiunii, astfel încât întreaga ta echipă să partajeze același comportament Claude Code.
Pentru suprascrieri personale care nu ar trebui adăugate în controlul versiunii, folosește în schimb .claude/settings.local.json.
Configurarea serverului MCP
Claude Code acceptă servere Model Context Protocol (MCP) pentru a-și extinde capacitățile. Configurează-le în .mcp.json la rădăcina proiectului tău:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Instalarea în diferite medii
macOS
Instalerul nativ este cea mai simplă cale pe macOS. Sunt acceptate atât mașinile Apple Silicon (M1/M2/M3/M4), cât și cele Intel:
curl -fsSL https://claude.ai/install.sh | bash
Alternativ, Claude Code este disponibil prin Homebrew:
brew install --cask claude-code
Linux
Funcționează pe Ubuntu 20.04+, Debian 10+ și majoritatea distribuțiilor moderne:
curl -fsSL https://claude.ai/install.sh | bash
Dacă ești pe o distribuție mai veche, folosește metoda npm cu nvm pentru a evita problemele de dependențe la nivel de sistem.
Windows (WSL)
Claude Code pe Windows necesită fie WSL, fie Git for Windows. WSL este abordarea recomandată:
- Deschide PowerShell ca Administrator și instalează WSL:
wsl --install
-
Repornește computerul când ți se solicită.
-
Deschide terminalul WSL (Ubuntu în mod implicit) și instalează Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Alternativ, poți folosi instalerul nativ de Windows direct în PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
Pentru mediile containerizate, adaugă Claude Code în Dockerfile-ul tău:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
Pentru pipeline-urile CI/CD, transmite cheia API la rulare în loc să o incluzi în imagine:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
Pipeline-uri CI/CD
Modul headless al Claude Code (flag-ul -p) este conceput pentru automatizare. Iată un exemplu de GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Flag-ul --output-format json returnează o ieșire structurată pe care pașii următori o pot analiza.
Actualizarea Claude Code
Instaler nativ
Dacă ai instalat Claude Code cu instalerul nativ, actualizările au loc automat în fundal. Nu este necesară nicio acțiune. Poți configura canalul de actualizare:
claude config set update-channel stable
Pentru a verifica versiunea curentă:
claude --version
npm
Dacă ai instalat prin npm, actualizează manual:
npm update -g @anthropic-ai/claude-code
Sau instalează o anumită versiune:
npm install -g @anthropic-ai/claude-code@latest
Integrare IDE
Deși Claude Code este un instrument axat pe terminal, acesta se integrează direct cu IDE-uri populare pentru o experiență mai vizuală.
Extensia VS Code
Extensia VS Code oferă o interfață grafică nativă pentru Claude Code în interiorul editorului tău. Aceasta include un panou de chat, undo bazat pe puncte de control, referințe de fișiere cu mențiuni @ și capacitatea de a rula mai multe conversații în tab-uri paralele.
Pentru instalare, deschide VS Code și caută „Claude Code” în panoul de extensii, sau rulează:
code --install-extension anthropic.claude-code
Odată instalată, poți deschide panoul Claude Code din bara laterală și poți interacționa cu acesta la fel ca în versiunea de terminal, dar cu beneficiul suplimentar de a vedea diff-urile fișierelor redate în vizualizatorul diff nativ al VS Code.
Plugin JetBrains
Pentru IntelliJ IDEA, PyCharm, WebStorm, GoLand și alte IDE-uri JetBrains, instalează pluginul Claude Code din JetBrains Marketplace:
- Deschide IDE-ul JetBrains
- Mergi la Settings, apoi la Plugins, apoi la Marketplace
- Caută „Claude Code”
- Click pe Install și repornește IDE-ul
Pluginul JetBrains rulează CLI Claude Code în terminalul integrat al IDE-ului tău și deschide modificările propuse în vizualizatorul diff al IDE-ului. Momentan este în versiune beta, dar complet funcțional pentru utilizarea zilnică.
Depanare
„command not found: claude”
Binarul Claude Code nu este în PATH-ul tău. Dacă ai folosit instalerul nativ, încearcă să deschizi o nouă fereastră de terminal. Dacă asta nu funcționează, rulează din nou scriptul de instalare. Pentru instalările npm, asigură-te că directorul tău global npm bin este în PATH:
npm config get prefix
Adaugă subdirectorul bin al acelei căi la variabila PATH a shell-ului tău.
„Node.js version too old”
Claude Code necesită Node.js 18+. Verifică-ți versiunea cu node --version. Dacă este sub 18, instalează o versiune mai nouă folosind nvm:
nvm install 22
nvm use 22
Erori de permisiune npm (EACCES)
Nu folosi niciodată sudo npm install -g. În schimb, repară directorul implicit al npm sau folosește nvm, care instalează totul în directorul tău home și evită complet conflictele de permisiuni:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Autentificarea eșuează sau browserul nu se deschide
Dacă login-ul bazat pe browser nu funcționează (frecvent pe servere la distanță sau WSL), te poți autentifica cu o cheie API în schimb:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Generează cheia API la console.anthropic.com.
„Network Error” sau Timeout în timpul instalării
Rețeaua sau firewall-ul tău ar putea bloca npm sau instalerul nativ. Încearcă:
npm config set registry https://registry.npmjs.org/
Dacă ești în spatele unui proxy corporativ, configurează npm să îl folosească:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code rulează încet
Claude Code în sine este ușor -- lentoarea înseamnă de obicei latență de rețea către API-ul Anthropic. Verifică-ți conexiunea la internet. Dacă ești pe un VPN, încearcă să te deconectezi. De asemenea, poți verifica starea API-ului la status.anthropic.com.
Pașii următori
Ai Claude Code instalat, autentificat și funcțional. Iată încotro să te îndrepți de aici:
- Învață fluxul de lucru: Citește tutorialul Claude Code pentru o incursiune profundă în strategiile de prompting, editarea fișierelor multiple și obținerea maximului din dezvoltarea asistată de AI.
- Compară opțiunile tale: Vezi cum se compară Claude Code în analiza noastră Claude Code vs Cursor dacă ești indecis între instrumentele de codare AI.
- Explorează funcțiile avansate: Claude Code acceptă servere MCP, hook-uri personalizate, automatizare headless și configurații multi-model. Documentația oficială acoperă acestea în detaliu.
Claude Code este cel mai rapid mod de a aduce AI în fluxul tău de lucru existent fără a schimba instrumentele sau a părăsi terminalul. Acum că este instalat, începe cu o sarcină mică pe un proiect real -- vei vedea diferența imediat.
