Filen config.toml
På denne side
Lektionen opdateret 2. november 2026 baseret på Vibe Code-dokumentation: integreret model Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(nøglenenable_auto_updatehar ikke længere nogen effekt), værktøjetedit(tidligeresearch_replace), og fjernelsen af afsnittet[safety]erstattet afdefault_agent. Kilder: Konfiguration · Konfigurationsreference.
Hvor findes config.toml?
Vibe leder efter sin konfigurationsfil på to steder, i denne rækkefølge:
- Projektkonfiguration:
./.vibe/config.toml(i den aktuelle mappe) - Global konfiguration:
~/.vibe/config.toml(i din hjemmemappe)
Projektkonfigurationen har forrang frem for den globale konfiguration. Denne mekanisme gør værktøjet praktisk til en udviklers daglige workflow: din globale konfiguration afspejler dine vaner, mens en kundes repository håndhæver sine egne regler inden for sin mappe uden at kræve, at du manuelt skifter indstillinger.
Filstruktur
Filen config.toml bruger TOML-formatet, et læsbart og entydigt konfigurationsformat. Her er et komplet eksempel med kommentarer, der indeholder alt, hvad du får brug for:
# ~/.vibe/config.toml
# Aktiv model: den indbyggede model eller et alias for en [[models]]-forudindstilling
active_model = "mistral-medium-3.5"
# Standardagent (accept-edits, hvis nøglen mangler)
default_agent = "ask"
# Brugerdefineret systemprompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: følger automatisk terminalen; brug /theme til at vælge
theme = "auto"
# Daglig kontrol for nye versioner
enable_update_checks = true
Valg af model
Parameteren active_model bestemmer, hvilken model Vibe bruger til generering. Den forventer et alias: enten den indbyggede model, Mistral Medium 3.5, eller et alias for en [[models]]-forudindstilling, du har erklæret (dette dækkes i næste lektion).
active_model = "mistral-medium-3.5"
Du behøver ikke redigere filen for at skifte model: kommandoen /model skifter modeller midt i en session og viser listen over tilgængelige muligheder. Brug filen til at indstille dit standardvalg, og kommandoen til engangstests.
Tilpasning af systemprompten
Systemprompten definerer Vibes adfærd. Som standard er den konfigureret til at være en effektiv kodningsassistent, men du kan specialisere den. Dette er ofte den indstilling, der giver det mest synlige udbytte: en agent, der kender dine konventioner på forhånd, holder op med at foreslå kode, der skal omformateres.
Prompts er Markdown-filer gemt i ~/.vibe/prompts/. Opret din egen; her er et eksempel til et team, der arbejder med Python og 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
Referer derefter til den i config.toml ved hjælp af filnavnet uden dens filtypenavn:
system_prompt_id = "mon_prompt"
Konfiguration af agenter
Agenter går længere end prompts alene: de er komplette konfigurationsprofiler, hvor hver agent har sin egen model, systemprompt og værktøjstilladelser. Du opretter dem i ~/.vibe/agents/. Det klareste eksempel er en agent til kodegennemgang:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Start den efter behov:
vibe --agent code_review
Denne agent kan kun læse: den kan ikke skrive filer eller udføre kommandoer. Du kan derfor lade den scanne en kollegas branch uden at frygte utilsigtede ændringer, hvilket gør den til den ideelle tilstand til sikker kodegennemgang.
Styring af værktøjer
Denne filtrering af værktøjer gælder også for hovedkonfigurationen. To lister er tilgængelige: en til kun at tillade specifikke værktøjer og en anden til at forbyde dem:
# Aktiver kun specifikke værktøjer
enabled_tools = ["read_file", "grep", "edit"] # edit: tidligere search_replace
# Deaktiver specifikke værktøjer
disabled_tools = ["bash", "write_file"]
Det bliver hurtigt kedeligt at taste hvert navn i hånden, når en MCP-server eksponerer tyve værktøjer. MCP-værktøjer navngives {server}_{tool}, og filtre accepterer jokertegn og regulære udtryk (præfiks re:). Dette lader dig ræsonnere ud fra familier snarere end individuelle værktøjer:
# Aktiver alle værktøjer fra en MCP-server ved navn serena (glob-mønster)
enabled_tools = ["serena_*"]
# ... eller det samme med et regulært udtryk:
# enabled_tools = ["re:^serena_.*$"]
# Deaktiver alle værktøjer fra MCP-serveren fetch_server
disabled_tools = ["fetch_server_*"]
Tema og konfigurationsplacering
Indstil temaet i samme fil, eller løbende via kommandoen /theme:
theme = "auto"
Tilgængelige temaer varierer efter version; brug /theme i interaktiv tilstand for at se den fulde liste og forhåndsvise hver mulighed, før du låser dit valg fast.
Endelig gemmer Vibe sin konfiguration i ~/.vibe/ som standard, men du kan ændre denne placering via en miljøvariabel:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Dette er nyttigt, hvis din hjemmemappe ligger på en langsom netværksdrev, hvor hver konfigurationslæsning ville medføre ventetid, eller hvis du deler en konfiguration på tværs af flere maskiner via en synkroniseringstjeneste.
Projektspecifik konfiguration
Tilbage til åbningsscenariet: for projektspecifikke indstillinger skal du oprette .vibe/config.toml i projektroden:
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 indlæser kun denne fil, hvis du har erklæret mappen betroet ved første start. Som en forholdsregel før commit: tilføj .vibe/ til din .gitignore, hvis filen indeholder følsomme oplysninger, såsom variabelnavne eller interne URLs, som du ikke vil have pushet til repository’et.
Vigtige pointer
- config.toml findes i globale (
~/.vibe/) og projekt-specifikke (./.vibe/) versioner - Projektkonfiguration har forrang frem for global konfiguration
- Agenter er komplette profiler med model, prompt og tilladelser; indstil standardagenten med
default_agent - Værktøjer kan filtreres ved hjælp af jokertegn eller regex
- Variablen
VIBE_HOMElader dig ændre konfigurationsmappen