Cheie API și variabile de mediu
Pe această pagină
Lecție actualizată la 2 noiembrie 2026 pe baza Cheilor API și profilurilor: cheia introdusă în timpul instalării este stocată în lanțul de chei al sistemului (fișierul
~/.vibe/.envfiind doar o soluție de rezervă), autentificarea prin browser este oferită implicit, iar/statussau/whoamiindică sursa utilizată. Sursă: API keys and profiles.
Obținerea cheii dvs. API Mistral
Pentru a utiliza Vibe, aveți nevoie de o cheie API Mistral. Această cheie autentifică cererile dumneavoastră și permite comunicarea dintre Vibe și modelele Mistral. Fără ea, instrumentul se instalează și pornește, dar nicio generare nu este posibilă. Creați cheia în Consola Mistral în șase pași:
- Accesați console.mistral.ai
- Creați un cont sau autentificați-vă
- Navigați la secțiunea API Keys
- Faceți clic pe Create new key
- Dați-i un nume descriptiv (de exemplu, „vibe-cli-dev“)
- Copiați cheia imediat – nu va mai fi afișată din nou
Acest ultim punct nu este o formalitate: cheia este vizibilă o singură dată. Dacă închideți fila prea devreme, va trebui să generați una nouă. Cheia respectă formatul sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx și trebuie să rămână confidențială. Oricine o deține poate utiliza cota dvs. API – și, prin urmare, poate cheltui bugetul dumneavoastră.
Trei metode de configurare
Vibe acceptă trei modalități de furnizare a acestei chei. Alegerea dumneavoastră depinde exclusiv de contextul de lucru.
Metoda 1: Configurare interactivă
Aceasta este metoda implicită la prima lansare și cea mai simplă pentru o stație de lucru personală. Vibe vă cere cheia direct și o salvează:
vibe
# → "Please enter your Mistral API key:"
# Lipiți cheia dvs., apăsați Enter
Cheia este stocată în lanțul de chei al sistemului (macOS Keychain, Windows Credential Manager…). Dacă nu este disponibil niciun lanț de chei, se utilizează ca soluție de rezervă fișierul ~/.vibe/.env, care este accesibil doar dumneavoastră. Rețineți că, la prima lansare, autentificarea prin browser cu contul dvs. Mistral elimină adesea nevoia unei chei. Pentru a vedea ce sursă utilizează efectiv Vibe, tastați /status sau /whoami în timpul unei sesiuni.
# Dacă cheia se află în fișierul .env (niciun lanț de chei disponibil)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Metoda 2: Variabilă de mediu
De îndată ce părăsiți mediul stației de lucru personale – cum ar fi un pipeline CI/CD, un script automatizat sau un server partajat – o variabilă de mediu devine preferabilă, deoarece nu scrie nimic pe disc:
export MISTRAL_API_KEY="sk-your-key-here"
Pentru a o face persistentă pe mașina dumneavoastră, adăugați această linie în fișierul de configurare al shell-ului:
# În ~/.bashrc, ~/.zshrc sau ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Variabila de mediu are prioritate față de fișierul .env. Acest lucru permite un model de utilizare foarte practic: comutarea temporară a cheilor fără a face modificări permanente. Puteți lucra cu cheia de dezvoltare, apoi puteți prefixa o singură comandă cu o cheie diferită pentru o operațiune sensibilă:
# Cheie de dezvoltare
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Cheie de producție (temporar)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Metoda 3: Fișierul config.toml
În final, puteți face referire la variabila de mediu în fișierul de configurare TOML al Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Rețineți că acest parametru nu conține cheia în sine, ci doar numele variabilei de citit. Această indirectare are sens atunci când lucrați cu mai mulți furnizori, fiecare având propria variabilă: api_key_env_var indică Vibe care variabilă să fie utilizată pentru cheia implicită.
Ordinea priorităților
Atunci când mai multe metode sunt configurate simultan, Vibe aplică următoarea ordine:
- Variabila de mediu
MISTRAL_API_KEY(dacă este definită în shell) - Fișierul
.envdin~/.vibe/.env - Lanțul de chei al sistemului, unde asistentul de configurare stochează cheia
Pentru un furnizor personalizat, api_key_env_var din config.toml desemnează pur și simplu variabila de citit, respectând aceeași ordine.
Rețineți prima linie de mai sus: dacă o cerere eșuează la autentificare, deși .env conține o cheie validă, verificați mai întâi dacă o variabilă veche nu persistă în shell-ul dumneavoastră și nu o suprascrie.
Securitatea cheii API
Prima regulă este să nu faceți niciodată commit al cheii într-un repository Git. Adăugați .env în .gitignore înainte chiar de a crea fișierul. Un secret împins într-un repo public este considerat compromis, chiar dacă ștergeți commit-ul ulterior. Prin aceeași logică, nu partajați cheia în text clar într-un mesaj sau document. Dacă suspectați o scurgere, regenerați-o imediat.
La nivel organizațional, utilizați chei separate pentru dezvoltare și producție. Dacă una este compromisă, o puteți revoca fără a întrerupe funcționarea celeilalte. În final, stabiliți limite de cheltuieli în Consola Mistral. Aceasta este cea mai eficientă plasă de siguranță împotriva unui script blocat în buclă sau a unei chei expuse: facturarea se oprește automat.
Verificarea funcționării cheii
După configurare, nu presupuneți nimic. Testați cu o cerere minimă:
vibe "Say hello"
Dacă cheia este validă, Vibe răspunde normal. Dacă este invalidă sau expirată, veți primi o eroare de autentificare clară, scutindu-vă de căutarea cauzei în instalare.
Dacă configurați furnizori suplimentari, cum ar fi OpenRouter, fiecare are nevoie de propria variabilă. Cele două coexistă fără probleme:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Vom acoperi în detaliu configurarea furnizorilor terți în lecția dedicată.
Puncte cheie
- Obțineți cheia API Mistral la console.mistral.ai
- Trei metode de configurare: configurare interactivă, variabilă de mediu, config.toml
- Variabila de mediu are prioritate față de fișierul .env
- Nu faceți niciodată commit al cheii în Git
- Stabiliți limite de cheltuieli în Consola Mistral