Het bestand config.toml
Op deze pagina
Les bijgewerkt op 2 november 2026 op basis van de Vibe Code-documentatie: geïntegreerd model Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(de sleutelenable_auto_updateheeft geen effect meer), gereedschapedit(voorheensearch_replace), en de verwijderde sectie[safety]vervangen doordefault_agent. Bronnen: Configuration · Configuration reference.
Waar bevindt config.toml zich?
Vibe zoekt naar zijn configuratiebestand op twee locaties, in deze volgorde:
- Projectconfiguratie:
./.vibe/config.toml(in de huidige map) - Globale configuratie:
~/.vibe/config.toml(in uw home-directory)
Projectconfiguratie heeft voorrang op globale configuratie. Dit mechanisme maakt het gereedschap praktisch voor de dagelijkse workflow van een ontwikkelaar: uw globale configuratie weerspiegelt uw gewoonten, terwijl de repository van een klant binnen zijn eigen map zijn eigen regels afdwingt zonder dat u handmatig instellingen hoeft om te schakelen.
Bestandsstructuur
Het bestand config.toml gebruikt het TOML-formaat, een leesbaar en eenduidig configuratieformaat. Hier is een compleet voorbeeld met commentaar dat alles bevat wat u nodig heeft:
# ~/.vibe/config.toml
# Actief model: het ingebouwde model, of een alias voor een [[models]]-preset
active_model = "mistral-medium-3.5"
# Standaardagent (accept-edits als de sleutel ontbreekt)
default_agent = "ask"
# Aangepaste systeemprompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Thema: volgt automatisch de terminal; gebruik /theme om te kiezen
theme = "auto"
# Dagelijkse controle op nieuwe versies
enable_update_checks = true
Het model kiezen
De parameter active_model bepaalt welk model Vibe gebruikt voor generatie. Deze verwacht een alias: hetzij het ingebouwde model, Mistral Medium 3.5, hetzij een alias voor een [[models]]-preset die u heeft gedeclareerd (behandeld in de volgende les).
active_model = "mistral-medium-3.5"
U hoeft het bestand niet te bewerken om van model te wisselen: het commando /model wisselt modellen tijdens een sessie en toont de lijst met beschikbare opties. Gebruik het bestand om uw standaardkeuze in te stellen, en het commando voor eenmalige tests.
De systeemprompt aanpassen
De systeemprompt definieert het gedrag van Vibe. Standaard is deze geconfigureerd als een effectieve codeerassistent, maar u kunt deze specialiseren. Dit is vaak de instelling die het meest zichtbare rendement oplevert: een agent die uw conventies vooraf kent, stopt met het voorstellen van code die opnieuw geformatteerd moet worden.
Prompts zijn Markdown-bestanden opgeslagen in ~/.vibe/prompts/. Maak uw eigen prompt; hier is een voorbeeld voor een team dat werkt met Python en FastAPI:
mkdir -p ~/.vibe/prompts
cat > ~/.vibe/prompts/mon_prompt.md << 'EOF'
Tu es un assistant de développement spécialisé en Python et FastAPI.
Tu écris du code propre, typé, avec des docstrings.
Tu privilégies les approches fonctionnelles quand c'est possible.
Tu réponds toujours en français.
EOF
Verwijs er vervolgens naar in config.toml met de bestandsnaam zonder extensie:
system_prompt_id = "mon_prompt"
Agents configureren
Agents gaan verder dan alleen prompts: het zijn complete configuratieprofielen waarbij elke agent zijn eigen model, systeemprompt en gereedschapsrechten heeft. U maakt ze aan in ~/.vibe/agents/. Het duidelijkste voorbeeld is een code review-agent:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Start deze op aanvraag:
vibe --agent code_review
Deze agent kan alleen lezen: hij kan geen bestanden schrijven of commando’s uitvoeren. U kunt hem daarom een branch van een collega laten scannen zonder bang te zijn voor accidentele wijzigingen, wat hem de ideale modus maakt voor veilige code reviews.
Gereedschapsbeheer
Deze filtering van gereedschappen is ook van toepassing op de hoofdconfiguratie. Er zijn twee lijsten beschikbaar: één om alleen specifieke gereedschappen toe te staan, en een andere om ze te verbieden:
# Alleen specifieke gereedschappen inschakelen
enabled_tools = ["read_file", "grep", "edit"] # edit: voorheen search_replace
# Specifieke gereedschappen uitschakelen
disabled_tools = ["bash", "write_file"]
Het met de hand invoeren van elke naam wordt vervelend wanneer een MCP-server twintig gereedschappen blootlegt. MCP-gereedschappen hebben de naam {server}_{tool}, en filters accepteren wildcards en reguliere expressies (voorvoegsel re:). Hierdoor kunt u redeneren per familie in plaats van per individueel gereedschap:
# Schakel alle gereedschappen in van een MCP-server genaamd serena (glob-patroon)
enabled_tools = ["serena_*"]
# ... of hetzelfde met een reguliere expressie:
# enabled_tools = ["re:^serena_.*$"]
# Schakel alle gereedschappen uit van de fetch_server MCP-server
disabled_tools = ["fetch_server_*"]
Thema en configuratielocatie
Stel het thema in in hetzelfde bestand, of on-the-fly via het commando /theme:
theme = "auto"
Beschikbare thema’s variëren per versie; gebruik /theme in de interactieve modus om de volledige lijst te zien en elke optie te bekijken voordat u uw keuze definitief maakt.
Tot slot slaat Vibe zijn configuratie standaard op in ~/.vibe/, maar u kunt deze locatie wijzigen via een omgevingsvariabele:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Dit is nuttig als uw home-directory zich op een langzame netwerkschijf bevindt waar elke configuratielezing latentie zou veroorzaken, of als u een configuratie deelt over meerdere machines via een synchronisatiedienst.
Projectspezifiek configuratie
Terugkomend op het openingsscenario: voor projectspecifieke instellingen maakt u .vibe/config.toml aan in de projectroot:
mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pytest"]
EOF
Vibe laadt dit bestand alleen als u de map bij de eerste start als vertrouwd heeft gemarkeerd. Als voorzorgsmaatregel voordat u commit: voeg .vibe/ toe aan uw .gitignore als het bestand gevoelige informatie bevat, zoals variabelenamen of interne URL’s die u niet naar de repository wilt pushen.
Belangrijkste punten
- config.toml bestaat in een globale (
~/.vibe/) en een projectversie (./.vibe/) - Projectconfiguratie heeft voorrang op globale configuratie
- Agents zijn complete profielen met model, prompt en rechten; stel de standaardagent in met
default_agent - Gereedschappen kunnen worden gefilterd met wildcards of regex
- De variabele
VIBE_HOMEstelt u in staat de configuratiemap te wijzigen