Klíč API a proměnné prostředí
Na této stránce
Lekce aktualizována 2. listopadu 2026 na základě článku API keys and profiles: klíč zadaný během instalace se ukládá do systémového klíčenky (soubor
~/.vibe/.envslouží pouze jako záloha), přihlášení přes prohlížeč je nabízeno ve výchozím nastavení a příkazy/statusnebo/whoamiukazují použitý zdroj. Zdroj: API keys and profiles.
Získejte svůj klíč Mistral API
Chcete-li používat Vibe, potřebujete klíč Mistral API. Tento klíč ověřuje vaše požadavky a umožňuje nástroji Vibe komunikovat s modely Mistral. Bez něj se sice nástroj nainstaluje a spustí, ale žádná generace není možná. Klíč vytvoříte v konzoli Mistral v šesti krocích:
- Přejděte na console.mistral.ai
- Vytvořte účet nebo se přihlaste
- Přejděte do sekce API Keys
- Klikněte na Create new key
- Dejte mu popisný název (např. „vibe-cli-dev“)
- Klíč okamžitě zkopírujte – znovu se již nezobrazí
Ten poslední bod není formalita: klíč je viditelný pouze jednou. Pokud kartu zavřete příliš brzy, budete muset vygenerovat nový. Klíč má formát sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx a musí zůstat důvěrný. Kdokoli, kdo jej získá, může využít vaši kvótu API – a tedy utratit váš rozpočet.
Tři způsoby konfigurace
Vibe nabízí tři způsoby, jak tento klíč poskytnout. Vaše volba závisí výhradně na kontextu vaší práce.
Metoda 1: Interaktivní nastavení
Toto je výchozí metoda při prvním spuštění a nejjednodušší pro osobní pracovní stanici. Vibe vás přímo vyzve k zadání klíče a uloží ho:
vibe
# → "Please enter your Mistral API key:"
# Vložte svůj klíč, stiskněte Enter
Klíč se uloží do vaší systémové klíčenky (Keychain na macOS, Správce pověření ve Windows…). Pokud klíčenka není k dispozici, nástroj se vrátí k souboru ~/.vibe/.env, který je čitelný pouze pro vás. Všimněte si, že při prvním spuštění často přihlášení přes prohlížeč pomocí vašeho účtu Mistral zcela odstraní potřebu zadávat klíč. Chcete-li zjistit, který zdroj Vibe skutečně používá, zadejte během relace příkaz /status nebo /whoami.
# Pokud je klíč v souboru .env (není k dispozici žádná klíčenka)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...
Metoda 2: Proměnná prostředí
Jakmile opustíte prostředí osobní pracovní stanice – například v pipeline CI/CD, automatizovaném skriptu nebo na sdíleném serveru – stává se proměnná prostředí výhodnější, protože nic nezapisuje na disk:
export MISTRAL_API_KEY="sk-your-key-here"
Aby byla trvalá na vašem stroji, přidejte tento řádek do konfiguračního souboru vašeho shellu:
# V ~/.bashrc, ~/.zshrc nebo ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"
Proměnná prostředí má prioritu před souborem .env. To umožňuje velmi praktický způsob použití: dočasné přepínání klíčů bez trvalých změn. Můžete pracovat s vývojovým klíčem a poté prefixovat jediný příkaz jiným klíčem pro citlivou operaci:
# Vývojový klíč
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"
# Produkční klíč (dočasně)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"
Metoda 3: Soubor config.toml
Nakonec můžete odkazovat na proměnnou prostředí v konfiguračním souboru TOML nástroje Vibe:
# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"
Všimněte si, že tento parametr neobsahuje samotný klíč, pouze název proměnné, kterou má načíst. Tato nepřímost dává smysl při práci s více poskytovateli, z nichž každý má svou vlastní proměnnou: api_key_env_var říká nástroji Vibe, kterou z nich použít pro výchozí klíč.
Pořadí priorit
Pokud je nakonfigurováno více metod současně, Vibe uplatní toto pořadí:
- Proměnná prostředí
MISTRAL_API_KEY(pokud je definována v shellu) - Soubor
.envv~/.vibe/.env - Systémová klíčenka, kam ukládá klíč průvodce nastavením
Pro vlastního poskytovatele parametr api_key_env_var v souboru config.toml jednoduše určuje proměnnou, kterou má načíst, přičemž se řídí stejným pořadím.
Pamatujte na první řádek výše: pokud požadavek selže při ověřování, přestože váš .env obsahuje platný klíč, nejprve zkontrolujte, zda ve vašem shellu nezůstala stará proměnná, která jej přepisuje.
Zabezpečení klíče API
Prvním pravidlem je nikdy necommitovat svůj klíč do repozitáře Git. Přidejte .env do svého .gitignore ještě předtím, než soubor vůbec vytvoříte. Tajný klíč odeslaný do veřejného repozitáře se považuje za kompromitovaný, i když commit později smažete. Ze stejné logiky nesdílejte svůj klíč v prostém textu ve zprávě nebo dokumentu. Pokud máte podezření na únik, okamžitě jej regenerujte.
Organizačně používejte oddělené klíče pro vývoj a produkci. Pokud jeden unikne, můžete jej zrušit, aniž by to přerušilo provoz toho druhého. Nakonec nastavte limity útrat v konzoli Mistral. To je nejúčinnější bezpečnostní síť proti skriptu ve smyčce nebo odhalenému klíči: fakturace se automaticky zastaví.
Ověření funkčnosti klíče
Po konfiguraci nic nepředpokládejte. Otestujte to minimálním požadavkem:
vibe "Say hello"
Pokud je klíč platný, Vibe odpoví normálně. Pokud je neplatný nebo vypršel, získáte jasnou chybu ověření, což vám ušetří hledání příčiny v instalaci.
Pokud nakonfigurujete další poskytovatele, jako je OpenRouter, každý potřebuje svou vlastní proměnnou. Obě mohou koexistovat bez problémů:
export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"
Konfiguraci poskytovatelů třetích stran podrobně probereme v samostatné lekci.
Klíčové poznatky
- Získejte svůj klíč Mistral API na console.mistral.ai
- Tři metody konfigurace: interaktivní nastavení, proměnná prostředí, config.toml
- Proměnná prostředí má prioritu před souborem .env
- Nikdy necommitujte svůj klíč do Gitu
- Nastavte limity útrat v konzoli Mistral