Ghiduri si tutoriale

Instalare Claude Code pe Windows, Mac si Linux (2026)

Instalare Claude Code in 2026: o comanda pe Windows, Mac si Linux, fara Node.js si fara WSL. Login cu abonament sau API key, VS Code si erorile de la prima pornire.

Cosmin-Anton Mihoc
11 min de lectură
Instalare Claude Code pe Windows, Mac si Linux (2026)

Cuprins

Indice dei contenuti (20 sezioni)

Instalare Claude Code in 2026 inseamna o singura comanda. Nu mai ai nevoie de Node.js, nu trebuie sa fii administrator, iar pe Windows nu mai ai nevoie de WSL. Totusi, jumatate din intrebarile pe care le primesc despre Claude Code sunt despre instalare, pentru ca pe internet circula inca ghiduri din 2025 care vorbesc despre npm install -g, Node 18 si WSL obligatoriu. Toate sunt depasite.

Ghidul asta urmeaza documentatia oficiala actuala (am verificat comenzile in septembrie 2026) si acopera pas cu pas instalarea Claude Code pe Windows, Mac si Linux, login-ul cu abonament sau cu API key, integrarea cu VS Code, unde se instaleaza exact fisierele si erorile care ii blocheaza pe cei mai multi la prima pornire. Daca pe Google ai cautat "claude code install" si ai dat doar de pagina de login sau de tutoriale video in engleza, aici gasesti totul intr-un singur loc, in romana.

Ce iti trebuie inainte de instalare Claude Code

Trei lucruri, si niciunul nu e Node.js:

  • Un cont cu acces la Claude Code. Ai nevoie de planul Pro (20 de dolari pe luna, cam 90-100 de lei in functie de cursul bancii), Max, Team, Enterprise sau de un cont API (Console) cu credite. Planul gratuit de pe Claude.ai nu include Claude Code. Toate variantele, cu limite si costuri in lei, le-am pus in ghidul despre cat costa Claude Code si ce plan sa alegi.
  • Un sistem de operare suportat: macOS 13 sau mai nou, Windows 10 (versiunea 1809+) sau Windows 11, Windows Server 2019+, Ubuntu 20.04+, Debian 10+, Alpine 3.19+. Procesor x64 sau ARM64 si minimum 4 GB RAM. Romania este in lista tarilor suportate de Anthropic, deci nu ai nevoie de VPN.
  • Un terminal. Pe Mac si Linux, cel de sistem. Pe Windows merg la fel de bine PowerShell si CMD.

Daca nu vrei sa lucrezi in terminal, Anthropic ofera si aplicatia Claude Desktop, cu Claude Code integrat intr-o interfata grafica. Restul ghidului este pentru varianta din terminal, care ramane cea mai completa.

Instalare Claude Code pe Windows (fara WSL)

In 2026 Claude Code ruleaza nativ pe Windows. Pentru instalare Claude Code pe Windows ai doua comenzi, iar alegerea depinde de ce vezi in promptul terminalului.

Din PowerShell (promptul incepe cu PS C:\)

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

Din CMD (promptul incepe cu C:\ fara PS)

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Nu trebuie sa deschizi terminalul ca administrator. Daca primesti eroarea "The token '&&' is not a valid statement separator", esti in PowerShell si ai folosit comanda pentru CMD. Daca vezi "'irm' is not recognized", e invers.

Unde se instaleaza Claude Code pe Windows

Executabilul ajunge in %USERPROFILE%\.local\bin\claude.exe, adica in folderul tau de utilizator, nu in Program Files. De asta nu cere drepturi de administrator. Dupa instalare inchide si redeschide terminalul, apoi verifica cu claude --version.

Daca Windows raspunde "claude is not recognized", folderul nu a ajuns in PATH. In PowerShell il adaugi asa, apoi deschizi o fereastra noua:

$p = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')

Ca sa vezi daca ai mai multe instalari care se bat cap in cap (de exemplu una veche din npm si una noua nativa), foloseste Get-Command claude -All.

Git for Windows: optional, dar il recomand

Claude Code foloseste un shell ca sa execute comenzi. Fara Git for Windows foloseste PowerShell, si functioneaza. Cu Git for Windows instalat foloseste Git Bash, iar majoritatea scripturilor, tutorialelor si skill-urilor din comunitate presupun Bash. Daca lucrezi pe proiecte web cu npm, Docker sau scripturi shell, instaleaza-l. Daca Claude Code nu gaseste Git Bash, ii indici calea in ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

Si WSL? Cand merita inca

WSL 2 ramane alegerea buna daca proiectele tale traiesc deja in Linux, daca folosesti toolchain-uri Linux (Docker, Python de sistem, make) sau daca vrei sandboxing pentru comenzi, care pe Windows nativ nu este suportat. In cazul asta deschizi terminalul Ubuntu din WSL si rulezi comanda de instalare Claude Code pentru Linux de mai jos: instalezi si pornesti claude in WSL, nu din PowerShell. WSL 1 merge, dar fara sandboxing.

Exista si WinGet, pentru cine gestioneaza totul de acolo: winget install Anthropic.ClaudeCode. Atentie: instalarea prin WinGet nu se actualizeaza singura.

Instalare Claude Code pe Mac

Deschide Terminal (Cmd + Space, scrii "Terminal") si lipeste comanda pentru instalare Claude Code:

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

Scriptul descarca binarul nativ semnat de Anthropic si il pune in ~/.local/bin/claude. Merge atat pe Apple Silicon (M1 pana la M5), cat si pe Intel. La final inchide si redeschide terminalul, apoi verifica:

claude --version

Daca preferi Homebrew:

brew install --cask claude-code

Diferenta importanta: instalarea nativa se actualizeaza singura in fundal, cea prin Homebrew nu. Cu brew rulezi din cand in cand brew upgrade claude-code. Cask-ul claude-code urmeaza canalul stabil, iar claude-code@latest primeste fiecare versiune imediat ce apare.

Instalare Claude Code pe Linux (Ubuntu, Debian, Fedora)

Pentru instalare Claude Code pe Linux folosesti aceeasi comanda ca pe Mac:

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

Singura problema tipica pe Linux: binarul ajunge in ~/.local/bin, care pe unele distributii nu e in PATH implicit. Daca dupa instalare primesti "command not found", adauga linia asta in ~/.bashrc sau ~/.zshrc si redeschide terminalul:

export PATH="$HOME/.local/bin:$PATH"

Instalare Claude Code cu apt pe Ubuntu si Debian

Daca vrei ca actualizarile sa vina prin apt upgrade, ca tot restul sistemului, Anthropic publica un repository semnat:

sudo apt install curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL https://downloads.claude.ai/keys/claude-code.asc -o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] https://downloads.claude.ai/claude-code/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-code

Inainte sa ai incredere in cheie, verifica amprenta cu gpg --show-keys /etc/apt/keyrings/claude-code.asc: trebuie sa fie 31DD DE24 DDFA B679 F42D 7BD2 BAA9 29FF 1A7E CACE. Pentru Fedora si RHEL exista repository-ul dnf echivalent, pentru Alpine cel apk. Actualizarea o faci cu sudo apt update && sudo apt upgrade claude-code.

Instalare Claude Code pe un server (VPS, Hetzner, Docker)

Eu folosesc Claude Code si pe serverele unde ruleaza proiectele clientilor, pentru debug si mentenanta. Comanda pentru instalare Claude Code e aceeasi, dar cu doua precautii: creeaza un utilizator care nu e root pentru instalare si, pentru autentificare, foloseste un API key prin variabila de mediu in loc de login-ul din browser, care pe un server fara interfata grafica nu se deschide. Detaliile sunt in sectiunea de login de mai jos.

Instalare Claude Code cu npm: mai merita?

Varianta clasica de "claude code install" prin npm inca functioneaza, dar nu o mai recomand:

npm install -g @anthropic-ai/claude-code

Pachetul npm cere acum Node.js 22 sau mai nou si, oricum, descarca acelasi binar nativ: Node e folosit doar la instalare, nu si la rulare. Are sens doar daca mediul tau gestioneaza deja toate CLI-urile globale prin npm. Nu folosi niciodata sudo npm install -g. Pentru actualizare foloseste npm install -g @anthropic-ai/claude-code@latest, nu npm update -g.

Instalare Claude Code pe canalul stabil, din start

Un detaliu pe care ghidurile in engleza il sar des: poti alege canalul direct la instalare. Canalul stable e cam cu o saptamana in urma si sare peste versiunile cu probleme cunoscute. Pe macOS si Linux:

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

Pe Windows PowerShell:

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) stable

Canalul ales la instalare Claude Code devine cel implicit pentru actualizarile automate.

Prima pornire si login: abonament sau API key

Dupa instalare Claude Code, intra in folderul unui proiect si porneste:

cd proiectul-tau
claude

La prima pornire se deschide browserul pentru login. Aici e alegerea care decide cat platesti:

  • Login cu contul Claude.ai (Pro, Max, Team): Claude Code foloseste cota din abonament. Niciun cost in plus peste cei 20 sau 100 de dolari pe luna. Plata se face in dolari, iar banca ta face conversia in lei.
  • API key (Console): platesti la consum, pe tokeni. Pentru munca zilnica iese mai scump decat abonamentul, dar e singura varianta pe servere fara browser si in CI/CD. Daca mergi pe API, citeste si cum reduci consumul de tokeni in Claude Code.

Capcana cea mai des intalnita: daca ai variabila ANTHROPIC_API_KEY setata in shell, poate de la alt proiect, Claude Code o foloseste in locul abonamentului si iti factureaza API-ul. Daca vrei abonamentul, sterge-o cu unset ANTHROPIC_API_KEY inainte sa pornesti claude. In sesiune, comanda /status iti arata ce metoda de autentificare folosesti de fapt, iar /login si /logout schimba contul.

Pentru a folosi o cheie pe server:

export ANTHROPIC_API_KEY=sk-ant-cheia-ta
claude

Claude Code iti cere o singura data sa aprobi cheia si nu mai deschide browserul. Daca vrei sa stii ce model sa alegi dupa login, am comparat variantele in Fable 5.1 vs Opus 5.5 vs Opus 5.

Instalare Claude Code in VS Code

Terminalul integrat din VS Code functioneaza deja: deschizi proiectul, deschizi terminalul (Ctrl + `) si rulezi claude. Daca vrei integrarea completa, cu modificarile afisate ca diff in editor, instaleaza extensia oficiala Claude Code din marketplace-ul VS Code (Ctrl + Shift + X, cauti "Claude Code"). Extensia foloseste aceeasi instalare si aceleasi credentiale ca terminalul. La fel functioneaza si plugin-ul pentru JetBrains (PhpStorm, WebStorm, IntelliJ). Un sfat din practica: daca ai Claude Code in WSL, deschide si workspace-ul VS Code in WSL, altfel apar probleme cu caile de fisiere.

Verificare dupa instalare Claude Code: cum stii ca e totul corect

Doua comenzi de stiut. Prima iti spune daca totul e in regula:

claude doctor

Afiseaza tipul instalarii, versiunea, erorile din fisierele de setari si rezultatul ultimei actualizari automate. A doua forteaza actualizarea fara sa astepti verificarea din fundal:

claude update

Implicit, instalarea nativa urmeaza canalul latest. Daca lucrezi pe proiecte unde o regresie te costa o zi, treci pe stable. Din Claude Code: /config, apoi Auto-update channel, sau in ~/.claude/settings.json:

{
  "autoUpdatesChannel": "stable"
}

Pentru Homebrew si WinGet poti lasa Claude Code sa ruleze singur upgrade-ul setand variabila CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE la 1.

Erori frecvente la instalare Claude Code si solutii

"command not found: claude" dupa instalare. PATH-ul nu include ~/.local/bin (sau %USERPROFILE%\.local\bin pe Windows). Inchide si redeschide terminalul. Daca nu ajunge, adauga folderul in PATH cum am aratat mai sus.

"syntax error near unexpected token '<'" sau eroare 403 la curl. Un proxy de firma sau un firewall intercepteaza descarcarea. Incearca din alta retea (chiar si hotspot de pe telefon) sau foloseste repository-ul apt/dnf ori Homebrew.

Login-ul din browser nu se finalizeaza. Ruleaza /logout in sesiune si apoi din nou claude. In WSL sau prin SSH, copiaza linkul afisat in terminal, deschide-l intr-un browser din Windows si, daca primesti un cod, lipeste-l inapoi in terminal. Pe servere fara browser foloseste API key.

Claude Code foloseste API-ul in loc de abonament. Ai ANTHROPIC_API_KEY in mediu. Scoate-o din shell si din fisierele .env incarcate automat, apoi verifica cu /status.

Pe Windows comenzile Bash esueaza. Lipseste Git for Windows sau Claude Code nu il gaseste: seteaza CLAUDE_CODE_GIT_BASH_PATH ca mai sus.

Doua versiuni de Claude Code in conflict. Se intampla celor care aveau versiunea npm si au instalat-o pe cea nativa. claude doctor semnaleaza problema, iar cea din npm o stergi cu npm uninstall -g @anthropic-ai/claude-code.

Homebrew sau WinGet spun "up to date", dar versiunea e veche. E normal: acesti manageri nu actualizeaza singuri. Ruleaza brew upgrade claude-code sau winget upgrade Anthropic.ClaudeCode.

Dezinstalare Claude Code

Instalare nativa pe Mac si Linux:

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Pe Windows PowerShell:

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Pentru Homebrew brew uninstall --cask claude-code, pentru WinGet winget uninstall Anthropic.ClaudeCode, pentru apt sudo apt remove claude-code. Setarile, serverele MCP configurate si istoricul sesiunilor raman in ~/.claude: sterge folderul doar daca vrei cu adevarat sa o iei de la zero.

Dupa instalare Claude Code: de unde incepi

Cu Claude Code instalat, trei lucruri fac diferenta in prima saptamana: un fisier CLAUDE.md in proiect cu regulile codului, cateva servere MCP conectate la instrumentele tale (daca nu stii ce sunt, am explicat ce este Model Context Protocol) si skill-urile potrivite. Am facut o lista cu cele mai bune skill-uri Claude Code de instalat in 2026. Daca nu vrei sa platesti abonament, uite 5 metode sa folosesti Claude Code gratuit, inclusiv cu Ollama. Iar daca inca nu esti sigur ca e unealta potrivita, am comparat Claude Code vs OpenCode vs Codex.

Concluzii

Instalare Claude Code in 2026 cere o comanda pentru fiecare sistem de operare, nicio dependenta si niciun drept de administrator. Ce conteaza cu adevarat sunt trei lucruri: sa alegi intre login cu abonament si API key stiind ce platesti, sa tii canalul stabil daca lucrezi in productie si sa rulezi claude doctor inainte sa cauti solutii pe Reddit.

Daca vrei sa aduci Claude Code in echipa ta sau sa il integrezi in procesele firmei, cu setup, CLAUDE.md, servere MCP si training, scrie-mi. E unul dintre lucrurile pe care le fac cel mai des, alaturi de proiectele de agenti AI pentru afaceri.

Distribuie acest articol
Ai întrebări? Contactează-mă

Ești gata să-ți dai viață proiectului?

Contactează-mă ca să discutăm ideea ta și să primești o ofertă gratuită.

Să începem împreună