Ċavetta tal-API u Varjabbli tal-Ambjent
F'din il-paġna
Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi ta’ API keys and profiles: iċ-ċavetta daħħalt waqt l-installazzjoni tmur fil-keychain tas-sistema (il-fajl
~/.vibe/.envhuwa biss backup), il-login permezz tal-browser huwa offrut b’mod predefinit, u/statusjew/whoamijindikaw is-sors użat. Sors: API keys and profiles.
Ikseb iċ-Ċavetta tal-API ta’ Mistral Tiegek
Biex tuża Vibe, għandek bżonn ċavetta tal-API ta’ Mistral. Din iċ-ċavetta tawtentika t-talbiet tiegħek u tippermetti lil Vibe jikkomunika mal-mudelli ta’ Mistral. Mingħajrha, l-għodda tinstalla u tniedi, iżda l-ebda ġenerazzjoni ma tkun possibbli. Toħloq iċ-ċavetta fuq il-Konsoll ta’ Mistral f’sitt passi:
- Mur fuq console.mistral.ai
- Oħloq kont jew idħol
- Immur fit-taqsima API Keys
- Ikklikkja Create new key
- Agħtiha isem deskrittiv (eż. “vibe-cli-dev”)
- Ikkopja ċ-ċavetta immedjatament—mhux se tintwera mill-ġdid
Dak l-aħħar punt mhuwiex formalità: iċ-ċavetta tidher darba biss. Jekk tagħlaq it-tab kmieni wisq, ikollok toħloq waħda ġdida. Iċ-ċavetta ssegwi l-format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx u trid tibbaża kunfidenzjali. Kulmin ikollha jista’ juża l-kwota tal-API tiegħek—u għalhekk jonfoq il-baġit tiegħek.
Tliet Metodi ta’ Konfigurazzjoni
Vibe jaċċetta tliet modi biex tipprovdi din iċ-ċavetta. L-għażla tiegħek tiddependi għalkollox fuq il-kuntest tax-xogħol tiegħek.
Metodu 1: Setup Interattiv
Dan huwa l-metodu predefinit fl-ewwel tniedija u l-aktar sempliċi għal workstation personali. Vibe jistaqsik direttament għaċ-ċavetta tiegħek u jissalvaha:
vibe
# → "Please enter your Mistral API key:"
# Ippastejja ċ-ċavetta tiegħek, agħfas Enter
Iċ-ċavetta tinħażen fil-keychain tas-sistema tiegħek (macOS Keychain, Windows Credential Manager…). Jekk ma jkun hemm l-ebda keychain disponibbli, isir fallback għall-fajl ~/.vibe/.env, li huwa aċċessibbli biss minnek. Innota li fl-ewwel tniedija, il-login permezz tal-browser bil-kont ta’ Mistral tiegħek spiss ineħħi l-ħtieġa għal ċavetta għalkollox. Biex tara liema sors qed juża Vibe attwalment, ikteb /status jew /whoami matul sessjoni.
# Jekk iċ-ċavetta tkun fil-fajl .env (l-ebda keychain disponibbli)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Metodu 2: Varjabbli tal-Ambjent
Hekk kif toħroġ mill-ambjent tal-workstation personali—bħal pipeline CI/CD, skript awtomatizzat, jew server kondiviż—varjabbli tal-ambjent issir preferibbli għax ma tikteb xejn fuq id-disk:
export MISTRAL_API_KEY="sk-your-key-here"
Biex tagħmilha persistenti fuq il-magna tiegħek, żid din il-linja fil-fajl tal-konfigurazzjoni tal-shell tiegħek:
# F' ~/.bashrc, ~/.zshrc, jew ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Il-varjabbli tal-ambjent tieħu prijorità fuq il-fajl .env. Dan jippermetti mudell ta’ użu prattiku ħafna: tibdel iċ-ċavetti temporanjament mingħajr ma tagħmel bidliet permanenti. Tista’ taħdem biċ-ċavetta tal-iżvilupp tiegħek, imbagħad tippreċedi kmand wieħed b’ċavetta differenti għal operazzjoni sensittiva:
# Ċavetta tal-iżvilupp
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Ċavetta tal-produzzjoni (temporanja)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Metodu 3: Fajl config.toml
Fl-aħħar nett, tista’ tirreferenzja l-varjabbli tal-ambjent fil-fajl tal-konfigurazzjoni TOML ta’ Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Innota li dan il-parametru ma fihx iċ-ċavetta nnifisha, iżda biss l-isem tal-varjabbli biex taqra. Din l-indirezzjoni tagħmel sens meta taħdem ma’ fornituri multipli, kull wieħed bil-varjabbli tiegħu stess: api_key_env_var jgħid lil Vibe liema wieħed juża għaċ-ċavetta predefinita.
Ordni ta’ Prijorità
Meta metodi multipli jiġu kkonfigurati simultanjament, Vibe japplika dan l-ordni:
- Varjabbli tal-ambjent
MISTRAL_API_KEY(jekk iddefinita fil-shell) - Fajl
.envf’~/.vibe/.env - Keychain tas-sistema, fejn il-magħżel tal-installazzjoni jħażen iċ-ċavetta
Għal fornitur personalizzat, api_key_env_var f’config.toml sempliċiment jindika l-varjabbli biex taqra, u jsegwi l-istess ordni.
Ftakar fl-ewwel linja hawn fuq: jekk talba tonqos mill-awtentikazzjoni anke jekk il-.env tiegħek fiha ċavetta valida, l-ewwel iċċekkja jekk hemmx varjabbli antika qed titħalla fil-shell tiegħek u tikserha.
Sigurtà taċ-Ċavetta tal-API
L-ewwel regola hija li qatt ma tagħmel commit taċ-ċavetta tiegħek f’repożitorju Git. Żid .env mal-.gitignore tiegħek qabel ma toħloq il-fajl. Sigriet imbuttat lejn repo pubbliku jitqies kompromess, anke jekk tħassar il-commit aktar tard. Bl-istess loġika, ma taqsamx iċ-ċavetta tiegħek b’test ċar f’messaġġ jew dokument. Jekk tissuspetta tnixxija, erġa’ oħloqha immedjatament.
Organizzattivament, uża ċavetti separati għall-iżvilupp u l-produzzjoni. Jekk waħda tnixxi, tista’ tirrevokaha mingħajr ma tinterrampi l-oħra. Fl-aħħar nett, stabbilixxi limiti ta’ nfiq fuq il-Konsoll ta’ Mistral. Din hija x-xibka tas-sigurtà l-aktar effettiva kontra skript li jdur f’loop jew ċavetta esposta: il-fatturazzjoni tieqaf awtomatikament.
Ivverifika li ċ-Ċavetta Taħdem
Wara l-konfigurazzjoni, tassumi xejn. Ittestja b’talba minima:
vibe "Say hello"
Jekk iċ-ċavetta tkun valida, Vibe jwieġeb normalment. Jekk tkun invalida jew skadiet, se tikseb żball ta’ awtentikazzjoni ċar, li jiffrankalek milli tfittex il-kawża fl-installazzjoni.
Jekk tikkonfigura fornituri addizzjonali bħal OpenRouter, kull wieħed jeħtieġ il-varjabbli tiegħu stess. It-tnejn jikkoegżistu mingħajr problemi:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Se nkopru l-konfigurazzjoni tal-fornituri ta’ partijiet terzi fid-dettal fil-lezzjoni ddedikata.
Punti Ewlenin
- Ikseb iċ-ċavetta tal-API ta’ Mistral tiegħek fuq console.mistral.ai
- Tliet metodi ta’ konfigurazzjoni: setup interattiv, varjabbli tal-ambjent, config.toml
- Il-varjabbli tal-ambjent tieħu prijorità fuq il-fajl .env
- Qatt ma tagħmel commit taċ-ċavetta tiegħek fuq Git
- Stabbilixxi limiti ta’ nfiq fuq il-Konsoll ta’ Mistral