Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Het bestand config.toml

Les 6 van 16 Bijgewerkt op 2 november 2026 Ontwikkelaar
Op deze pagina
  1. Waar bevindt config.toml zich?
  2. Bestandsstructuur
  3. Het model kiezen
  4. De systeemprompt aanpassen
  5. Agents configureren
  6. Gereedschapsbeheer
  7. Thema en configuratielocatie
  8. Projectspezifiek configuratie
  9. Belangrijkste punten

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 sleutel enable_auto_update heeft geen effect meer), gereedschap edit (voorheen search_replace), en de verwijderde sectie [safety] vervangen door default_agent. Bronnen: Configuration · Configuration reference.

Waar bevindt config.toml zich?

Vibe zoekt naar zijn configuratiebestand op twee locaties, in deze volgorde:

  1. Projectconfiguratie: ./.vibe/config.toml (in de huidige map)
  2. 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_HOME stelt u in staat de configuratiemap te wijzigen