Ključ API-ja i varijable okruženja
Na ovoj stranici
Lekcija ažurirana 2. studenog 2026. na temelju API ključeva i profila: ključ unesen tijekom instalacije pohranjuje se u sustavni privjesak za ključeve (datoteka
~/.vibe/.envsluži samo kao rezervna opcija), prijava putem preglednika nudí se prema zadanim postavkama, a/statusili/whoamipokazuju korišteni izvor. Izvor: API keys and profiles.
Nabavi svoj Mistral API ključ
Za korištenje alata Vibe potreban ti je Mistral API ključ. Taj ključ autentificira tvoje zahtjeve i omogućuje Vibeu komunikaciju s Mistral modelima. Bez njega alat se može instalirati i pokrenuti, ali generiranje nije moguće. Ključ stvaraš u Mistral konzoli u šest koraka:
- Odi na console.mistral.ai
- Stvori račun ili se prijavi
- Navigiraj do odjeljka API Keys
- Klikni Create new key
- Daj mu opisno ime (npr. “vibe-cli-dev”)
- Odmah kopiraj ključ – više ga nećeš moći vidjeti
Posljednja točka nije puka formalnost: ključ je vidljiv samo jednom. Ako prerano zatvoriš karticu, morat ćeš generirati novi. Ključ prati format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx i mora ostati povjerljiv. Svatko tko ga posjeduje može trošiti tvoju API kvotu – i time tvoj budžet.
Tri metode konfiguracije
Vibe prihvaća tri načina za proslijeđivanje ovog ključa. Tvoj izbor u potpunosti ovisi o tvom radnom kontekstu.
1. metoda: Interaktivno postavljanje
Ovo je zadana metoda pri prvom pokretanju i najjednostavnija za osobno radno mjesto. Vibe te izravno pita za ključ i sprema ga:
vibe
# → "Please enter your Mistral API key:"
# Zalijepi svoj ključ, pritisni Enter
Ključ se pohranjuje u tvoj sustavni privjesak za ključeve (macOS Keychain, Windows Credential Manager…). Ako privjesak za ključeve nije dostupan, alat koristi rezervnu opciju u datoteci ~/.vibe/.env, koju može čitati samo ti. Imaj na umu da pri prvom pokretanju prijava putem preglednika s tvojim Mistral računom često u potpunosti uklanja potrebu za ključem. Da bi vidio koji izvor Vibe zapravo koristi, upiši /status ili /whoami tijekom sesije.
# Ako je ključ u .env datoteci (privjesak za ključeve nije dostupan)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
2. metoda: Varijabla okruženja
Čim izađeš iz okruženja osobnog radnog mjesta – poput CI/CD pipelinea, automatizirane skripte ili dijeljenog poslužitelja – varijabla okruženja postaje poželjnija jer ništa ne zapisuje na disk:
export MISTRAL_API_KEY="sk-your-key-here"
Da bi je učinio trajnom na svom računalu, dodaj ovaj redak u svoju konfiguracijsku datoteku ljuske:
# U ~/.bashrc, ~/.zshrc ili ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Varijabla okruženja ima prioritet nad .env datotekom. To omogućuje vrlo praktičan obrazac korištenja: privremeno prebacivanje ključeva bez trajnih promjena. Možeš raditi sa svojim razvojnim ključem, a zatim prefiksirati jednu naredbu drugačijim ključem za osjetljivu operaciju:
# Razvojni ključ
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Produkcijski ključ (privremeno)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
3. metoda: config.toml datoteka
Konačno, varijablu okruženja možeš referencirati u Vibeuvoj TOML konfiguracijskoj datoteci:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Imaj na umu da ovaj parametar ne sadrži sam ključ, već samo ime varijable koju treba pročitati. Ova neizravnost ima smisla kada radiš s više pružatelja usluga, od kojih svaki ima svoju varijablu: api_key_env_var govori Vibeu koju varijablu koristiti za zadani ključ.
Redoslijed prioriteta
Kada su istovremeno konfigurirane više metoda, Vibe primjenjuje sljedeći redoslijed:
- Varijabla okruženja
MISTRAL_API_KEY(ako je definirana u ljusci) .envdatoteka u~/.vibe/.env- Sustavni privjesak za ključeve, gdje čarobnjak za postavljanje pohranjuje ključ
Za prilagođenog pružatelja usluga, api_key_env_var u config.toml jednostavno označava varijablu koju treba pročitati, slijedeći isti redoslijed.
Zapamti prvi redak gore: ako zahtjev ne uspije zbog autentifikacije unatoč tome što tvoja .env datoteka sadrži valjani ključ, prvo provjeri lebdi li stara varijabla u tvojoj ljusci i nadjačava li je.
Sigurnost API ključa
Prvo pravilo je nikada ne commitati svoj ključ u Git repozitorij. Dodaj .env u svoj .gitignore prije nego što uopće stvoriš datoteku. Tajna koja je gurnuta u javni repozitorij smatra se kompromitiranom, čak i ako kasnije obrišeš commit. Istom logikom, nemoj dijeliti svoj ključ u običnom tekstu u poruci ili dokumentu. Ako sumnjaš na curenje, odmah ga regeneriraj.
Organizacijski, koristi odvojene ključeve za razvoj i produkciju. Ako jedan curi, možeš ga opozvati bez prekida rada drugoga. Naposljetku, postavi ograničenja trošenja u Mistral konzoli. To je najučinkovitija sigurnosna mreža protiv skripte u petlji ili otkrivenog ključa: naplata se automatski zaustavlja.
Provjeri funkcionira li ključ
Nakon konfiguracije, nemoj ništa pretpostavljati. Testiraj s minimalnim zahtjevom:
vibe "Say hello"
Ako je ključ valjan, Vibe odgovara normalno. Ako je nevaljan ili istekao, dobit ćeš jasnu pogrešku autentifikacije, što će te poštedjeti traženja uzroka u instalaciji.
Ako konfiguriraš dodatne pružatelje usluga poput OpenRoutera, svaki treba svoju varijablu. Dva ključa mogu nesmetano suživjeti:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Konfiguraciju pružatelja trećih strana detaljno ćemo obraditi u namjenskoj lekciji.
Ključne točke
- Nabavi svoj Mistral API ključ na console.mistral.ai
- Tri metode konfiguracije: interaktivno postavljanje, varijabla okruženja, config.toml
- Varijabla okruženja ima prioritet nad .env datotekom
- Nikada ne commitaj svoj ključ u Git
- Postavi ograničenja trošenja u Mistral konzoli