Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Filen config.toml

Lektion 6 av 16 Uppdaterad 2 november 2026 Utvecklare
På denna sida
  1. Var finns config.toml?
  2. Filstruktur
  3. Välja modell
  4. Anpassa systemprompten
  5. Konfigurera agenter
  6. Verktygskontroll
  7. Tema och konfigurationsplats
  8. Projektspecifik konfiguration
  9. Viktiga punkter

Lektionen uppdaterad 2 november 2026 baserat på Vibe Code-dokumentationen: integrerad modell Mistral Medium 3.5 (plus Devstral 2), enable_update_checks (nyckeln enable_auto_update har ingen effekt längre), verktyget edit (tidigare search_replace), och avsnittet [safety] har tagits bort och ersatts av default_agent. Källor: Configuration · Configuration reference.

Var finns config.toml?

Vibe letar efter sin konfigurationsfil på två platser, i denna ordning:

  1. Projektkonfiguration: ./.vibe/config.toml (i den aktuella katalogen)
  2. 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_HOME låter dig ändra konfigurationskatalogen