Configuration

La CLI Vibe Code se configure via un fichier config.toml. Cette page explique où se trouve ce fichier, comment l’ouvrir et les paramètres les plus courants à personnaliser.

Emplacements des fichiers de configuration

La CLI recherche config.toml dans cet ordre :

./.vibe/config.toml dans le répertoire de travail courant (au niveau du projet).
~/.vibe/config.toml dans votre dossier personnel (au niveau utilisateur).

La configuration projet a priorité sur la configuration utilisateur. La configuration du projet n’est chargée que si le dossier de travail est approuvé.

Ouvrir votre fichier de configuration

Ouvrez ~/.vibe/config.toml avec votre éditeur par défaut :

# macOS
open ~/.vibe/config.toml

# Linux
xdg-open ~/.vibe/config.toml

# Windows (PowerShell)
Invoke-Item ~\.vibe\config.toml

# macOS
open ~/.vibe/config.toml

# Linux
xdg-open ~/.vibe/config.toml

# Windows (PowerShell)
Invoke-Item ~\.vibe\config.toml

Vous pouvez également ouvrir le menu de configuration depuis une session avec la commande slash /config.

Répertoire racine de Vibe

Par défaut, la CLI stocke sa configuration et son état dans ~/.vibe/. Modifiez l’emplacement avec la variable d’environnement VIBE_HOME :

export VIBE_HOME="/chemin/vers/votre/dossier/vibe/personnalisé"

export VIBE_HOME="/chemin/vers/votre/dossier/vibe/personnalisé"

VIBE_HOME détermine l’emplacement des éléments suivants :

config.toml : configuration principale.
.env : clés API et identifiants de fournisseurs.
agents/ : profils d’agents personnalisés.
prompts/ : prompts système personnalisés.
skills/ : Skills personnalisées.
tools/ : outils personnalisés.
logs/ : journaux des sessions et de l’application.

Répertoire de travail

Utilisez --workdir pour pointer la CLI vers un projet qui n’est pas le dossier courant :

vibe --workdir /chemin/vers/projet

vibe --workdir /chemin/vers/projet

Utilisez --add-dir pour donner à la CLI un accès en lecture à un autre dossier, le temps d’une session.

Sections courantes de configuration

config.toml accepte de nombreuses clés et sections principales. Les plus courantes sont listées ici, chacune renvoyant vers une page dédiée.

Agent par défaut

Définissez l’agent interactif par défaut :

default_agent = "plan"

default_agent = "plan"

Ce réglage ne concerne que les sessions interactives. En mode programmatique, le mode auto-approve est utilisé si --agent n’est pas précisé. Voir Agents.

Fournisseurs et modèles

Définissez les préréglages de fournisseurs, de modèles, et le modèle actif :

active_model = "devstral-openrouter"

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"

active_model = "devstral-openrouter"

[[providers]]
name = "openrouter"
api_base = "https://openrouter.ai/api/v1"
api_key_env_var = "OPENROUTER_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "mistralai/devstral-2512:free"
provider = "openrouter"
alias = "devstral-openrouter"

Voir Clés API et profils.

Serveurs MCP

Ajoutez des serveurs Model Context Protocol sous mcp_servers. Voir Serveurs MCP.

Skills

Activez, désactivez ou ajoutez des chemins de Skills :

skill_paths = ["/chemin/vers/Skills/personnalisées"]
enabled_skills = ["code-review", "test-*"]
disabled_skills = ["experimental-*"]

skill_paths = ["/chemin/vers/Skills/personnalisées"]
enabled_skills = ["code-review", "test-*"]
disabled_skills = ["experimental-*"]

enabled_skills et disabled_skills interagissent comme suit :

Si enabled_skills est défini et non vide, seules les Skills dont le nom correspond à un motif de cette liste sont disponibles.
Sinon, toutes les Skills détectées sont disponibles, sauf celles dont le nom correspond à un motif de disabled_skills.

Voir Skills.

Autorisations et filtres d’outils

Restreignez les outils accessibles à l’agent :

enabled_tools = ["serena_*"]
disabled_tools = ["mcp_*", "grep"]

enabled_tools = ["serena_*"]
disabled_tools = ["mcp_*", "grep"]

Les filtres d’outils acceptent les noms exacts, les glob patterns et les regex avec le préfixe re:. Des autorisations spécifiques peuvent aussi être définies dans des blocs [tools.<tool_name>]. Voir Sécurité, validations et permissions.

Mises à jour et télémétrie

Gérez la mise à jour automatique, les notifications et la télémétrie :

enable_auto_update = true
enable_notifications = true
enable_telemetry = true

enable_auto_update = true
enable_notifications = true
enable_telemetry = true

Paramètre	Par défaut	Détails
`enable_auto_update`	`true`	Vibe vérifie les nouvelles versions et se met à jour en arrière-plan. Nous vous recommandons vivement de laisser cette option activée afin de toujours bénéficier des dernières corrections. Vous pouvez aussi relancer le script d’installation à tout moment pour une mise à jour manuelle.
`enable_notifications`	`true`	Notifications du système d’exploitation quand Vibe termine une tâche longue ou demande votre intervention (par exemple, lorsqu’une demande d’approbation attend).
`enable_telemetry`	`true`	Envoie à Mistral des données anonymes d’utilisation et d’erreur. Sert à améliorer le produit (diagnostics de crash, usage des fonctions, performance). Aucun prompt, contenu de fichier ou sortie de modèle n’est transmis. Désactivez-la pour une utilisation strictement hors ligne.

Ordre de prise en compte de la configuration

Lorsque le même paramètre est défini à plusieurs endroits, la CLI les applique dans cet ordre (priorité décroissante) :

Options en ligne de commande (par exemple, --agent, --workdir).
Variables d’environnement (par exemple, MISTRAL_API_KEY, VIBE_HOME).
Projet ./.vibe/config.toml.
Utilisateur ~/.vibe/config.toml.