Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Tiedosto config.toml

Oppitunti 6 / 16 Päivitetty 2. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Missä config.toml sijaitsee?
  2. Tiedoston rakenne
  3. Mallin valinta
  4. Järjestelmäkehotteen mukauttaminen
  5. Agenttien määrittäminen
  6. Työkalujen hallinta
  7. Teema ja määrityksen sijainti
  8. Projektikohtaiset asetukset
  9. Keskeiset asiat

Oppitunti päivitetty 2. marraskuuta 2026 Vibe Code -dokumentaation perusteella: integroitu malli Mistral Medium 3.5 (plus Devstral 2), enable_update_checks (avain enable_auto_update ei enää vaikuta), työkalu edit (aiemmin search_replace) ja poistettu osio [safety] korvattu avaimella default_agent. Lähteet: Configuration · Configuration reference.

Missä config.toml sijaitsee?

Vibe etsii määritystiedostoaan kahdesta paikasta seuraavassa järjestyksessä:

  1. Projektikohtaiset asetukset: ./.vibe/config.toml (nykyisessä hakemistossa)
  2. Yleiset asetukset: ~/.vibe/config.toml (kotihakemistossasi)

Projektikohtaiset asetukset ohittavat yleiset asetukset. Tämä mekanismi tekee työkalusta käytännöllisen kehittäjän päivittäiseen työhön: yleiset asetuksesi heijastavat tottumuksiasi, kun taas asiakkaan repositorio pakottaa omat sääntönsä hakemistonsa sisällä ilman, että sinun tarvitsee vaihtaa asetuksia manuaalisesti.

Tiedoston rakenne

Tiedosto config.toml käyttää TOML-muotoa, joka on luettava ja yksiselitteinen määritysmuoto. Tässä on täydellinen kommentoitu esimerkki, joka sisältää kaiken tarvitsemasi:

# ~/.vibe/config.toml

# Aktiivinen malli: sisäänrakennettu malli tai alias kohdalle [[models]]
active_model = "mistral-medium-3.5"

# Oletusagentti (käyttää arvoa ask-edits, jos avain puuttuu)
default_agent = "ask"

# Mukautettu järjestelmäkehote (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"

# Teema: auto seuraa päätettä; valitse komennolla /theme
theme = "auto"

# Päivittäinen tarkistus uusien versioiden varalta
enable_update_checks = true

Mallin valinta

Parametri active_model määrittää, mitä mallia Vibe käyttää sisällöntuotantoon. Se odottaa aliasta: joko sisäänrakennettua mallia, Mistral Medium 3.5:tä, tai aliasta [[models]]-esiasetukselle, jonka olet määrittänyt (käsitellään seuraavassa oppitunnissa).

active_model = "mistral-medium-3.5"

Sinun ei tarvitse muokata tiedostoa vaihtaaksesi mallia: komento /model vaihtaa malleja istunnon aikana ja näyttää luettelon käytettävissä olevista vaihtoehdoista. Käytä tiedostoa asettaaksesi oletusvalintasi ja komentoa kertaluonteisiin testeihin.

Järjestelmäkehotteen mukauttaminen

Järjestelmäkehote määrittelee Viben toimintatavan. Oletuksena se on konfiguroitu tehokkaaksi koodausavustajaksi, mutta voit erikoistaa sitä. Tämä on usein asetus, joka tuottaa näkyvimmän hyödyn: agentti, joka tuntee käytäntösi etukäteen, lakkaa ehdottamasta koodia, joka tarvitsee uudelleenmuotoilua.

Kehotteet ovat Markdown-tiedostoja, jotka tallennetaan hakemistoon ~/.vibe/prompts/. Luo oma; tässä on esimerkki tiimille, joka työskentelee Pythonin ja FastAPIn kanssa:

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

Viittaa siihen sitten tiedostossa config.toml käyttämällä tiedostonimeä ilman tiedostopäätettä:

system_prompt_id = "mon_prompt"

Agenttien määrittäminen

Agentit menevät pelkkiä kehotteita pidemmälle: ne ovat täydellisiä määritysprofiileja, joissa jokaisella agentilla on oma mallinsa, järjestelmäkehotteensa ja työkalukäyttöoikeutensa. Luot ne hakemistoon ~/.vibe/agents/. Selkein esimerkki on koodinkatselmointiagentti:

# ~/.vibe/agents/code_review.toml

system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]

[tools.bash]
permission = "never"

Käynnistä se tarvittaessa:

vibe --agent code_review

Tämä agentti voi vain lukea: se ei voi kirjoittaa tiedostoja tai suorittaa komentoja. Voit siis antaa sen skannata kollegan haaran pelkäämättä vahinkomuutoksia, mikä tekee siitä ihanteellisen tilan turvallisiin koodinkatselmuksiin.

Työkalujen hallinta

Tämä työkalujen suodatus koskee myös päämääritystä. Käytettävissä on kaksi listaa: yksi sallimaan vain tietyt työkalut ja toinen kieltämään niitä:

# Ota käyttöön vain tietyt työkalut
enabled_tools = ["read_file", "grep", "edit"]   # edit: aiemmin search_replace

# Poista käytöstä tietyt työkalut
disabled_tools = ["bash", "write_file"]

Jokaisen nimen näpyttely käsin käy työlääksi, kun MCP-palvelin paljastaa kaksikymmentä työkalua. MCP-työkalut nimetään muodossa {server}_{tool}, ja suodattimet hyväksyvät jokerimerkkejä ja säännöllisiä lausekkeita (etuliite re:). Tämä antaa sinun ajatella perheittäin eikä yksittäisten työkalujen tasolla:

# Ota käyttöön kaikki työkalut MCP-palvelimelta nimeltä serena (glob-malli)
enabled_tools = ["serena_*"]
# ... tai sama asia säännöllisellä lausekkeella:
# enabled_tools = ["re:^serena_.*$"]

# Poista käytöstä kaikki työkalut fetch_server-MCP-palvelimelta
disabled_tools = ["fetch_server_*"]

Teema ja määrityksen sijainti

Aseta teema samaan tiedostoon tai lennossa komennolla /theme:

theme = "auto"

Käytettävissä olevat teemat vaihtelevat version mukaan; käytä komentoa /theme vuorovaikutteisessa tilassa nähdäksesi koko luettelon ja esikatsellaksesi jokaista vaihtoehtoa ennen valintasi lukitsemista.

Lopuksi, Vibe tallentaa määrityksensä oletusarvoisesti hakemistoon ~/.vibe/, mutta voit muuttaa tätä sijaintia ympäristömuuttujan avulla:

export VIBE_HOME="/chemin/vers/mon/dossier/vibe"

Tämä on hyödyllistä, jos kotihakemistosi on hitaalla verkkolevyllä, jossa jokainen määrityksen luku aiheuttaisi viivettä, tai jos jaat määrityksiä useiden koneiden välillä synkronointipalvelun kautta.

Projektikohtaiset asetukset

Palataan aloitusskenaarioon: luodaksesi projektikohtaisia asetuksia, luo .vibe/config.toml projektin juureen:

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 lataa tämän tiedoston vain, jos olet merkinnyt kansion luotetuksi ensimmäisen käynnistyksen yhteydessä. Varotoimenpiteenä ennen commitointia: lisää .vibe/ tiedostoon .gitignore, jos tiedosto sisältää arkaluonteista tietoa, kuten muuttujanimiä tai sisäisiä URL-osoitteita, joita et halua työntää repositorioon.

Keskeiset asiat

  • config.toml on olemassa yleisenä (~/.vibe/) ja projektikohtaisena (./.vibe/) versiona
  • Projektikohtaiset asetukset ohittavat yleiset asetukset
  • Agentit ovat täydellisiä profiileja, joissa on malli, kehote ja käyttöoikeudet; aseta oletusagentti avaimella default_agent
  • Työkaluja voi suodattaa käyttämällä jokerimerkkejä tai regexiä
  • Muuttuja VIBE_HOME antaa sinun vaihtaa määrityshakemistoa