Filen config.toml
På denna sida
Lektionen uppdaterad 2 november 2026 baserat på Vibe Code-dokumentationen: integrerad modell Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(nyckelnenable_auto_updatehar ingen effekt längre), verktygetedit(tidigaresearch_replace), och avsnittet[safety]har tagits bort och ersatts avdefault_agent. Källor: Configuration · Configuration reference.
Var finns config.toml?
Vibe letar efter sin konfigurationsfil på två platser, i denna ordning:
- Projektkonfiguration:
./.vibe/config.toml(i den aktuella katalogen) - Global konfiguration:
~/.vibe/config.toml(i din hemkatalog)
Projektkonfigurationen har företräde framför den globala konfigurationen. Denna mekanism gör verktyget praktiskt för en utvecklares dagliga arbete: din globala konfiguration speglar dina vanor, medan en kunds repositorium tillämpar sina egna regler inom sin katalog utan att du behöver växla inställningar manuellt.
Filstruktur
Filen config.toml använder formatet TOML, ett läsbart och entydigt konfigurationsformat. Här är ett komplett exempel med kommentarer som innehåller allt du behöver:
# ~/.vibe/config.toml
# Aktiv modell: den inbyggda modellen, eller ett alias för en [[models]]-förinställning
active_model = "mistral-medium-3.5"
# Standardagent (accept-edits om nyckeln saknas)
default_agent = "ask"
# Anpassad systemprompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: auto följer terminalen; använd /theme för att välja
theme = "auto"
# Daglig kontroll av nya versioner
enable_update_checks = true
Välja modell
Parametern active_model avgör vilken modell Vibe använder för generering. Den förväntar sig ett alias: antingen den inbyggda modellen, Mistral Medium 3.5, eller ett alias för en [[models]]-förinställning som du har deklarerat (behandlas i nästa lektion).
active_model = "mistral-medium-3.5"
Du behöver inte redigera filen för att byta modell: kommandot /model byter modell mitt i sessionen och visar listan över tillgängliga alternativ. Använd filen för att ställa in ditt standardval, och kommandot för engångstester.
Anpassa systemprompten
Systemprompten definierar Vibes beteende. Som standard är den konfigurerad för att vara en effektiv kodningsassistent, men du kan specialisera den. Detta är ofta den inställning som ger mest synlig vinst: en agent som känner dina konventioner i förväg slutar föreslå kod som behöver formateras om.
Prompter är Markdown-filer som lagras i ~/.vibe/prompts/. Skapa din egen; här är ett exempel för ett team som arbetar med Python och 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
Referera sedan till den i config.toml med filnamnet utan dess tillägg:
system_prompt_id = "mon_prompt"
Konfigurera agenter
Agenter går längre än bara prompter: de är kompletta konfigurationsprofiler där varje agent har sin egen modell, systemprompt och verktygsbehörigheter. Du skapar dem i ~/.vibe/agents/. Det tydligaste exemplet är en agent för kodgranskning:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Starta den vid behov:
vibe --agent code_review
Denna agent kan endast läsa: den kan inte skriva filer eller exekvera kommandon. Du kan därför låta den skanna en kollegas branch utan att frukta oavsiktliga ändringar, vilket gör den till det ideala läget för säkra kodgranskningar.
Verktygskontroll
Denna filtrering av verktyg gäller även huvudkonfigurationen. Två listor finns tillgängliga: en för att endast tillåta specifika verktyg, och en annan för att förbjuda dem:
# Aktivera endast specifika verktyg
enabled_tools = ["read_file", "grep", "edit"] # edit: tidigare search_replace
# Inaktivera specifika verktyg
disabled_tools = ["bash", "write_file"]
Att skriva varje namn för hand blir tröttsamt när en MCP-server exponerar tjugo verktyg. MCP-verktyg namnges {server}_{tool}, och filter accepterar jokertecken och reguljära uttryck (prefix re:). Detta låter dig resonera efter familj snarare än efter enskilda verktyg:
# Aktivera alla verktyg från en MCP-server vid namn serena (glob-mönster)
enabled_tools = ["serena_*"]
# ... eller samma sak med ett reguljärt uttryck:
# enabled_tools = ["re:^serena_.*$"]
# Inaktivera alla verktyg från MCP-servern fetch_server
disabled_tools = ["fetch_server_*"]
Tema och konfigurationsplats
Ställ in temat i samma fil, eller direkt via kommandot /theme:
theme = "auto"
Tillgängliga teman varierar beroende på version; använd /theme i interaktivt läge för att se hela listan och förhandsgranska varje alternativ innan du låser ditt val.
Slutligen lagrar Vibe sin konfiguration i ~/.vibe/ som standard, men du kan ändra denna plats via en miljövariabel:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Detta är användbart om din hemkatalog ligger på en långsam nätverksenhet där varje konfigurationsläsning skulle innebära latens, eller om du delar en konfiguration över flera maskiner via en synkroniseringstjänst.
Projektspecifik konfiguration
Återgår vi till inledningsscenariot: för projektspecifika inställningar skapar du .vibe/config.toml i projektroten:
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 läser in denna fil endast om du har deklarerat mappen som betrodd vid första starten. Som en försiktighetsåtgärd innan commit: lägg till .vibe/ i din .gitignore om filen innehåller känslig information, såsom variabelnamn eller interna URL:er som du inte vill ska pushas till repositoriet.
Viktiga punkter
- config.toml finns i globala (
~/.vibe/) och projektbaserade (./.vibe/) versioner - Projektkonfiguration har företräde framför global konfiguration
- Agenter är kompletta profiler med modell, prompt och behörigheter; ställ in standardagenten med
default_agent - Verktyg kan filtreras med jokertecken eller regex
- Variabeln
VIBE_HOMElåter dig ändra konfigurationskatalogen