Ključ API in spremenljivke okolja
Na tej strani
Lekcija posodobljena 2. novembra 2026 na podlagi API ključev in profilov: ključ, vnesen med namestitvijo, gre v sistemski ključar (datoteka
~/.vibe/.envje le nadomestna možnost), prijava prek brskalnika je privzeto na voljo, ukaza/statusali/whoamipa kažeta na uporabljeni vir. Vir: API keys and profiles.
Pridobi svoj Mistral API ključ
Za uporabo orodja Vibe potrebuješ Mistral API ključ. Ta ključ avtenticira tvoje zahteve in omogoča komunikacijo med orodjem Vibe in modeli Mistral. Brez njega se orodje namesti in zažene, vendar generiranje ni mogoče. Ključ ustvariš v konzoli Mistral v šestih korakih:
- Obišči console.mistral.ai
- Ustvari račun ali se prijavi
- Pojdi v razdelek API Keys
- Klikni Create new key
- Daj mu opisno ime (npr. “vibe-cli-dev”)
- Ključ takoj kopiraj – prikazan bo le enkrat
Zadnja točka ni zgolj formalnost: ključ je viden samo enkrat. Če zavirok prezgodaj zapreš, boš moral ustvariti novega. Ključ sledi formatu sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx in mora ostati zaupen. Vsakdo, ki ga ima, lahko porabi tvojo kvoto API-ja – in s tem tvoj proračun.
Trije načini konfiguracije
Vibe sprejme tri načine za posredovanje tega ključa. Tvoja izbira je v celoti odvisna od delovnega konteksta.
1. način: Interaktivna nastavitev
To je privzeta metoda ob prvem zagonu in najpreprostejša za osebno delovno postajo. Vibe te neposredno vpraša po ključu in ga shrani:
vibe
# → "Please enter your Mistral API key:"
# Prilepi svoj ključ in pritisni Enter
Ključ se shrani v tvoj sistemski ključar (macOS Keychain, Windows Credential Manager …). Če ključar ni na voljo, se uporabi nadomestna datoteka ~/.vibe/.env, ki je berljiva samo zate. Upoštevaj, da pri prvem zagonu prijava prek brskalnika z računom Mistral pogosto popolnoma odpravi potrebo po ročnem vnosu ključa. Da preveriš, kateri vir Vibe dejansko uporablja, med sejo vpiši /status ali /whoami.
# Če je ključ v datoteki .env (ključar ni na voljo)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
2. način: Spremenljivka okolja
Takoj ko zapustiš okolje osebne delovne postaje – na primer v cevovodu CI/CD, avtomatiziranem skriptu ali na skupnem strežniku – postane prednostna uporaba spremenljivke okolja, saj ta ne zapisuje ničesar na disk:
export MISTRAL_API_KEY="sk-your-key-here"
Če želiš, da je nastavitev trajna na tvojem računalniku, dodaj to vrstico v konfiguracijsko datoteko svoje lupine:
# V ~/.bashrc, ~/.zshrc ali ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Spremenljivka okolja ima prednost pred datoteko .env. To omogoča zelo praktičen način uporabe: začasno preklop med ključi brez trajnih sprememb. Morda delaš z razvojnim ključem, nato pa pred enim samim ukazom za občutljivo operacijo navedeš drug ključ:
# Razvojni ključ
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Produkcijski ključ (začasno)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
3. način: Datoteka config.toml
Končno lahko spremenljivko okolja navedeš tudi v konfiguracijski datoteki TOML za Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Upoštevaj, da ta parameter ne vsebuje samega ključa, temveč le ime spremenljivke, ki jo je treba prebrati. Ta posredni pristop ima smisel pri delu z več ponudniki, od katerih ima vsak svojo spremenljivko: api_key_env_var pove Vibeu, katero naj uporabi za privzeti ključ.
Vrstni red prednosti
Ko je hkrati konfiguriranih več metod, Vibe upošteva naslednji vrstni red:
- Spremenljivka okolja
MISTRAL_API_KEY(če je definirana v lupini) - Datoteka
.envv~/.vibe/.env - Sistemski ključar, kamor čarovnik za namestitev shrani ključ
Za ponudnika po meri parameter api_key_env_var v datoteki config.toml preprosto določi spremenljivko za branje, pri čemer sledi istemu vrstnemu redu.
Zapomni si prvo vrstico zgoraj: če zahteva ne uspe zaradi avtentikacije, čeprav tvoja datoteka .env vsebuje veljaven ključ, najprej preveri, ali v tvoji lupini ni ostala stara spremenljivka, ki jo prepisuje.
Varnost API ključa
Prvo pravilo je, da svojega ključa nikoli ne potisneš v skladišče Git. Preden sploh ustvariš datoteko .env, jo dodaj v .gitignore. Skrivnost, potisnjena v javno skladišče, velja za ogroženo, tudi če pozneje izbrišeš commit. Po isti logike svojega ključa ne deli v navadnem besedilu v sporočilih ali dokumentih. Če sumiš na uhajanje, ključ takoj ponovno ustvari.
Organizacijsko uporabi ločene ključe za razvoj in produkcijo. Če eden uhaja, ga lahko prekličeš, ne da bi prekinil delo drugega. Nazadnje, v konzoli Mistral nastavi omejitve porabe. To je najučinkovitejša varnostna mreža proti skripti v zanki ali razkritemu ključu: obračun se samodejno ustavi.
Preveri, ali ključ deluje
Po konfiguraciji ne domnevaj ničesar. Preizkusi z minimalno zahtevo:
vibe "Say hello"
Če je ključ veljaven, Vibe odgovori običajno. Če je neveljaven ali potekel, boš prejel jasno napako avtentikacije, kar ti prihrani iskanje vzroka v namestitvi.
Če konfiguriraš dodatne ponudnike, kot je OpenRouter, potrebuje vsak svojo spremenljivko. Obstaajeta brez težav:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Konfiguracijo ponudnikov tretjih strani bomo podrobneje obravnavali v namenski lekciji.
Ključne ugotovitve
- Svoj Mistral API ključ pridobi na console.mistral.ai
- Trije načini konfiguracije: interaktivna nastavitev, spremenljivka okolja, config.toml
- Spremenljivka okolja ima prednost pred datoteko .env
- Ključa nikoli ne potisni v Git
- V konzoli Mistral nastavi omejitve porabe