Clé API et variables d'environnement

Obtenir votre clé API Mistral

Pour utiliser Vibe, vous avez besoin d’une clé API Mistral. Cette clé authentifie vos requêtes et permet à Vibe de communiquer avec les modèles Mistral.

Créer une clé sur la console Mistral

1. Rendez-vous sur console.mistral.ai
2. Créez un compte ou connectez-vous
3. Naviguez vers la section API Keys
4. Cliquez sur Create new key
5. Donnez-lui un nom descriptif (ex: “vibe-cli-dev”)
6. Copiez immédiatement la clé — elle ne sera plus affichée

La clé a le format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx. Gardez-la confidentielle : quiconque possède cette clé peut utiliser votre quota API.

Les trois méthodes de configuration

Vibe propose trois façons de configurer votre clé API, par ordre de priorité.

Méthode 1 : Setup interactif (recommandé)

C’est la méthode par défaut au premier lancement. Vibe vous demande directement votre clé et la sauvegarde dans ~/.vibe/.env :

vibe
# → "Please enter your Mistral API key:"
# Collez votre clé, appuyez sur Entrée

La clé est stockée dans un fichier .env dans le répertoire de configuration de Vibe :

cat ~/.vibe/.env
# MISTRAL_API_KEY=sk-xxxxxxxxxxxx

Cette méthode est la plus simple et la plus sûre pour un usage personnel.

Méthode 2 : Variable d’environnement

Si vous préférez gérer la clé via votre shell (utile en CI/CD ou pour des scripts), exportez la variable MISTRAL_API_KEY :

export MISTRAL_API_KEY="sk-votre-cle-ici"

Pour la rendre persistante, ajoutez cette ligne dans votre fichier de configuration shell :

# Dans ~/.bashrc, ~/.zshrc ou ~/.profile
export MISTRAL_API_KEY="sk-votre-cle-ici"

La variable d’environnement a priorité sur le fichier .env. C’est utile si vous avez plusieurs clés et souhaitez basculer rapidement :

# Clé de développement
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyse ce code"

# Clé de production (temporaire)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Déploie les migrations"

Méthode 3 : Fichier config.toml

Vous pouvez également référencer la variable d’environnement dans le fichier de configuration TOML de Vibe :

# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"

Cette option est utile quand vous travaillez avec plusieurs providers et que chaque provider a sa propre variable d’environnement. Le paramètre api_key_env_var indique à Vibe quelle variable lire pour la clé par défaut.

Ordre de priorité

Quand plusieurs méthodes sont configurées simultanément, Vibe applique cet ordre de priorité :

1. Variable d’environnement MISTRAL_API_KEY (si définie dans le shell)
2. Fichier .env dans ~/.vibe/.env
3. Référence config.toml via api_key_env_var

Sécurité de la clé API

Quelques bonnes pratiques essentielles pour protéger votre clé :

• Ne commitez jamais votre clé dans un dépôt Git. Ajoutez .env à votre .gitignore
• Ne partagez pas votre clé en clair dans des messages ou des documents
• Régénérez votre clé si vous suspectez une fuite
• Utilisez des clés distinctes pour le développement et la production
• Définissez des limites de dépenses sur la console Mistral pour éviter les surprises

Vérifier que la clé fonctionne

Après configuration, testez avec une requête simple :

vibe "Dis-moi bonjour"

Si la clé est valide, Vibe répond normalement. Si elle est invalide ou expirée, vous obtiendrez une erreur d’authentification claire.

Variables d’environnement pour les providers tiers

Si vous configurez des providers additionnels (OpenRouter, etc.), chacun nécessite sa propre variable :

export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"

Nous verrons la configuration des providers tiers en détail dans la leçon dédiée.

Points clés à retenir

• La clé API Mistral s’obtient sur console.mistral.ai
• Trois méthodes de configuration : setup interactif, variable d’environnement, config.toml
• La variable d’environnement a priorité sur le fichier .env
• Ne commitez jamais votre clé dans Git
• Définissez des limites de dépenses sur la console Mistral