Idei principale

• Mai multe căi de instalare: npm, Homebrew, script curl, Go install, Docker și compilarea din sursă -- alegeți-o pe cea care se potrivește fluxului tău de lucru.
• Cinci minute până la prima rulare: Cea mai rapidă cale (scriptul de instalare curl) pornește OpenCode în mai puțin de cinci minute pe orice sistem Unix.
• Independent de furnizor: OpenCode funcționează cu OpenAI, Google Gemini, modele locale Ollama și altele -- nu ești blocat cu un singur furnizor AI.
• Configurarea este minimă: Un singur fișier config.toml și o variabilă de mediu sunt tot ce ai nevoie pentru a începe să programezi cu AI în terminalul tău.

Cum să instalezi OpenCode: Ghid de configurare pas cu pas (2026)

OpenCode este agentul de programare AI open-source construit pentru terminal. Acesta aduce puterea modelelor de limbaj mari direct în linia ta de comandă, permițându-ți să scrii, să refactorizezi, să depanezi și să înțelegi codul fără a părăsi editorul sau fluxul de lucru din terminal.

Indiferent dacă configurezi OpenCode pentru prima dată sau migrezi de la un alt instrument de programare AI, acest ghid te va trece prin fiecare metodă de instalare, configurare inițială, configurarea furnizorului și pașii de depanare de care vei avea nevoie.

---

Cerințe prealabile

Înainte de a instala OpenCode, confirmă că sistemul tău îndeplinește următoarele cerințe.

Sistem de Operare

OpenCode rulează pe macOS, Linux și Windows. Pentru utilizatorii de Windows, WSL (Windows Subsystem for Linux) este recomandat cu tărie. Suportul nativ pentru Windows prin Scoop este, de asemenea, disponibil.

Cerințe de Runtime (depinde de metoda de instalare)

Metodă de instalare	Cerință
npm	Node.js 18 sau mai nou
Homebrew	macOS sau Linux cu Homebrew instalat
Script Curl	bash, curl
Go install	Go 1.22 sau mai nou
Docker	Docker Engine 20+
Compilare din sursă	Go 1.22+, Git

Cerințe de Terminal

OpenCode oferă o TUI (Terminal User Interface), deci emulatorul tău de terminal trebuie să suporte true color și randare Unicode corespunzătoare. Majoritatea terminalelor moderne (iTerm2, Alacritty, WezTerm, Windows Terminal, Ghostty) funcționează direct. Terminalele mai vechi, cum ar fi Terminal.app implicit din macOS, pot avea probleme de randare.

Verifică versiunea ta de Node.js:

node --version

Verifică versiunea ta de Go (dacă folosești metoda Go install):

go version

---

Metoda 1: Script de instalare (Cea mai rapidă)

Scriptul oficial de instalare este cel mai rapid mod de a pune OpenCode în funcțiune. Acesta detectează sistemul de operare și arhitectura, descarcă binarul corect și îl plasează în PATH.

curl -fsSL https://opencode.ai/install | bash

Această singură comandă se ocupă de tot. După ce se termină, verifică instalarea:

opencode --version

Această metodă funcționează pe macOS și Linux. Nu necesită Node.js sau Go.

---

Metoda 2: Instalare prin npm

Dacă ai deja Node.js în fluxul tău de lucru, npm este cea mai familiară opțiune.

npm install -g opencode-ai@latest

Numele pachetului pe npm este opencode-ai, nu opencode. Aceasta este o sursă comună de confuzie.

Pentru verificare:

opencode --version

Dacă întâmpini erori de permisiune, fie repară permisiunile directorului global npm, fie folosește npx pentru a-l rula fără o instalare globală:

npx opencode-ai@latest

---

Metoda 3: Homebrew (macOS și Linux)

Utilizatorii Homebrew pot instala OpenCode din tap-ul oficial:

brew install anomalyco/tap/opencode

Aceasta instalează cea mai recentă versiune stabilă și gestionează actualizările prin brew upgrade.

Pentru verificare:

opencode --version

---

Metoda 4: Go Install

Dacă ai instalat Go 1.22+, poți instala direct din sursă prin go install:

go install github.com/opencode-ai/opencode@latest

Asigură-te că $GOPATH/bin (sau $HOME/go/bin în mod implicit) este în PATH. Adaugă-l în profilul tău de shell dacă nu este deja acolo:

export PATH="$PATH:$(go env GOPATH)/bin"

Verifică:

opencode --version

---

Metoda 5: Docker

Rularea OpenCode în Docker este utilă pentru fluxurile CI/CD sau când dorești un mediu izolat.

docker pull ghcr.io/opencode-ai/opencode:latest

Rulează-l cu directorul proiectului tău montat:

docker run -it --rm \
  -v "$(pwd)":/workspace \
  -w /workspace \
  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
  ghcr.io/opencode-ai/opencode:latest

Flag-urile -it sunt esențiale deoarece OpenCode folosește o TUI interactivă. Flag-ul -v montează directorul curent al proiectului, astfel încât OpenCode să poată citi și modifica fișierele tale.

---

Metoda 6: Compilare din sursă

Pentru contributori sau oricine dorește versiunea de ultimă oră:

git clone https://github.com/opencode-ai/opencode.git
cd opencode
go build -o opencode .

Mută binarul într-un director din PATH:

sudo mv opencode /usr/local/bin/

Compilarea din sursă necesită Go 1.22+ și Git. Aceasta îți oferă acces la funcționalități nelansate și îți permite să modifici instrumentul pentru nevoile tale proprii.

---

Metoda 7: Scoop (Windows)

Utilizatorii de Windows care preferă o experiență nativă în locul WSL pot folosi Scoop:

scoop install opencode

Scoop gestionează automat configurarea PATH.

---

Prima lansare și configurare

Cu OpenCode instalat, navighează în orice director de proiect și lansează-l:

cd your-project
opencode

La prima lansare, OpenCode își deschide TUI și te invită să conectezi un furnizor AI. Poți folosi comanda interactivă /connect pentru a adăuga cheia ta API:

/connect

Aceasta te ghidează prin selectarea unui furnizor (OpenAI, Google, Anthropic etc.) și introducerea cheii tale API. Datele de autentificare sunt stocate în ~/.local/share/opencode/auth.json.

Pentru o pornire mai rapidă, poți de asemenea să inițializezi proiectul cu:

/init

Aceasta analizează structura depozitului tău și creează un fișier agents.md cu context despre baza ta de cod, ajutând AI-ul să ofere răspunsuri mai precise de la început.

---

Configure AI Providers

OpenCode suportă mai mulți furnizori AI. Iată cum să îl configurezi pe fiecare.

OpenAI (GPT-5.4, GPT-4.1, o3)

Setează cheia API ca variabilă de mediu:

export OPENAI_API_KEY="sk-your-key-here"

Sau adaugă-o în profilul tău de shell (~/.zshrc, ~/.bashrc) pentru persistență.

Google Gemini (Gemini 2.5 Pro, Gemini 2.5 Flash)

export GOOGLE_API_KEY="your-google-api-key"

Poți obține o cheie API Google din Google AI Studio.

Ollama (Modele locale -- Gratuit, Privat)

Ollama îți permite să rulezi modele local fără nicio cheie API. Instalează Ollama mai întâi, descarcă un model, apoi configurează OpenCode:

# Instalează Ollama (dacă nu este deja instalat)
curl -fsSL https://ollama.com/install.sh | sh

# Descarcă un model de programare
ollama pull qwen2.5-coder:32b

# OpenCode detectează Ollama automat când rulează pe localhost:11434

Nu este nevoie de nicio cheie API pentru Ollama. OpenCode îl detectează automat când rulează local.

Anthropic (Claude -- Acces limitat)

Anthropic a restricționat accesul Claude în instrumente terțe, inclusiv OpenCode. Dacă ai o cheie API care încă funcționează:

export ANTHROPIC_API_KEY="sk-ant-your-key-here"

Cu toate acestea, majoritatea utilizatorilor în 2026 folosesc OpenAI sau Google Gemini ca furnizor principal cu OpenCode din cauza acestor restricții.

---

Configurarea esențială: Ghid config.toml

OpenCode folosește un fișier de configurare TOML pentru control detaliat. Fișierul de configurare se află la ~/.config/opencode/config.toml (sau în rădăcina proiectului sub numele opencode.json pentru setări specifice proiectului).

Iată un exemplu practic de config.toml:

# Provider configuration
[provider.openai]
apiKey = "{env:OPENAI_API_KEY}"

[provider.openai.models.gpt]
id = "gpt-5.4"

[provider.google]
apiKey = "{env:GOOGLE_API_KEY}"

[provider.google.models.gemini]
id = "gemini-2.5-pro"

# Disable providers you do not use
disabled_providers = ["anthropic"]

Lucruri importante de reținut:

• Substituirea variabilelor: Folosește {env:VARIABLE_NAME} pentru a referi variabile de mediu în loc de a scrie cheile direct în fișier.
• Selecția modelului: Poți specifica exact ce model să fie utilizat pentru fiecare furnizor.
• Furnizori dezactivați: Împiedică OpenCode să încarce furnizori pentru care nu ai date de autentificare, evitând avertismentele la pornire.
• Suprascrierea URL-ului de bază: Dacă folosești un proxy sau un endpoint personalizat, adaugă baseURL = "https://your-proxy.com/v1" sub secțiunea furnizorului.

Pentru configurarea la nivel de proiect, creează un opencode.json în rădăcina proiectului tău:

{
  "provider": "openai",
  "model": "gpt-5.4"
}

Acesta suprascrie setările globale pentru acel proiect specific.

---

Verifică instalarea

Parcurge această listă de verificare pentru a confirma că totul funcționează corect.

1. Verifică versiunea

opencode --version

Ar trebui să vezi numărul versiunii afișat. Din martie 2026, cea mai recentă versiune stabilă este în intervalul 0.x.

2. Lansează TUI

cd any-project-directory
opencode

Ar trebui să vezi interfața de terminal OpenCode cu un prompt în partea de jos.

3. Testează un prompt simplu

În TUI OpenCode, scrie o cerere simplă:

Explain what this project does based on the file structure.

Dacă primești un răspuns de la AI, configurarea furnizorului tău funcționează.

4. Testează operațiunile pe fișiere

Cere OpenCode să creeze un mic fișier de test:

Create a file called test-opencode.txt with the text "OpenCode is working"

Verifică dacă fișierul a fost creat în directorul proiectului tău, apoi șterge-l.

---

Depanarea problemelor comune

"command not found: opencode"

Binarul nu este în PATH. Soluțiile depind de metoda de instalare:

• npm: Rulează npm list -g opencode-ai pentru a confirma instalarea. Dacă este instalat, verifică dacă directorul global bin al npm este în PATH: npm config get prefix și adaugă /bin la acea cale.
• Go: Adaugă $(go env GOPATH)/bin în PATH.
• Script Curl: Rulează din nou scriptul de instalare sau mută manual binarul în /usr/local/bin/.

Erori de permisiune în timpul instalării npm

Nu folosi sudo npm install -g. În schimb, repară directorul implicit al npm:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
npm install -g opencode-ai@latest

"Error: Node.js version too old"

Pachetul npm al OpenCode necesită Node.js 18+. Verifică versiunea:

node --version

Dacă ești pe o versiune mai veche, actualizează folosind nvm:

nvm install 18
nvm use 18

Erori de rețea în spatele unui firewall corporativ

Dacă instalarea npm se blochează sau eșuează din cauza restricțiilor de rețea:

npm install -g opencode-ai@latest --registry https://registry.npmmirror.com

Sau descarcă binarul direct de pe pagina de GitHub releases și plasează-l manual în PATH.

"API key not found" sau "No provider configured"

Asigură-te că variabila de mediu a cheii tale API este exportată în aceeași sesiune de shell:

echo $OPENAI_API_KEY

Dacă nu afișează nimic, setează-o din nou:

export OPENAI_API_KEY="sk-your-key-here"

Pentru persistență, adaugă linia de export în fișierul tău ~/.zshrc sau ~/.bashrc și rulează source ~/.zshrc.

Probleme de randare TUI (text deformat, margini lipsă)

Schimbă cu un emulator de terminal modern care suportă true color. Opțiuni recomandate: iTerm2 (macOS), Alacritty (cross-platform), WezTerm (cross-platform) sau Windows Terminal (Windows).

Go install: "go: command not found"

Go nu este instalat sau nu este în PATH. Instalează Go de pe go.dev/dl și asigură-te că este în PATH:

export PATH="$PATH:/usr/local/go/bin"

---

Actualizarea OpenCode

Menține OpenCode actualizat pentru a primi suport pentru cele mai noi modele și corecții de erori.

npm:

npm update -g opencode-ai

Homebrew:

brew upgrade opencode

Script Curl: Rulează din nou comanda de instalare:

curl -fsSL https://opencode.ai/install | bash

Go install: Rulează din nou cu @latest:

go install github.com/opencode-ai/opencode@latest

---

Pașii următori

Acum că OpenCode este instalat și configurat, ești gata să începi să îl folosești în fluxul tău de lucru zilnic.

• Învață comenzile: Consultă Tutorialul OpenCode 2026 pentru un ghid complet al comenzilor, fluxurilor de lucru și funcțiilor avansate.
• Configurează integrarea GitHub: Instalează aplicația OpenCode GitHub App pentru a folosi revizuirea codului asistată de AI și răspunsuri la issue-uri direct în depozitele tale.
• Explorează comanda /init: Rulează /init în proiectul tău pentru a genera un fișier agents.md care oferă OpenCode un context profund despre arhitectura bazei tale de cod.
• Încearcă mai mulți furnizori: Configurează doi sau trei furnizori și comută între ei pentru a vedea care model funcționează cel mai bine pentru sarcinile tale de programare.

OpenCode este unul dintre instrumentele AI open-source cu cea mai rapidă creștere în 2026, deoarece se întâlnește cu dezvoltatorii acolo unde aceștia lucrează deja: în terminal. Cu o instalare care durează mai puțin de cinci minute și o configurare care necesită doar o cheie API, nu există niciun motiv să nu îl încerci astăzi.