Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

A config.toml fájl

6. lecke 16 közül Frissítve 2026. november 2. Fejlesztő
Ezen az oldalon
  1. Hol található a config.toml?
  2. Fájlszerkezet
  3. Modell kiválasztása
  4. A rendszerprompt testreszabása
  5. Ügynökök konfigurálása
  6. Eszközvezérlés
  7. Téma és konfiguráció helye
  8. Projektspecifikus konfiguráció
  9. Főbb megállapítások

A leckét 2026. november 2-án frissítettük a Vibe Code dokumentációja alapján: integrált modell a Mistral Medium 3.5 (plusz a Devstral 2), az enable_update_checks beállítás (az enable_auto_update kulcs már nincs hatással), az edit eszköz (korábban search_replace), valamint a törölt [safety] szakaszt a default_agent váltotta fel. Források: Konfiguráció · Konfigurációs referencia.

Hol található a config.toml?

A Vibe két helyen keresi a konfigurációs fájlt, ebben a sorrendben:

  1. Projektkonfiguráció: ./.vibe/config.toml (az aktuális könyvtárban)
  2. Globális konfiguráció: ~/.vibe/config.toml (a saját könyvtáradban)

A projektkonfiguráció elsőbbséget élvez a globálissal szemben. Ez a mechanizmus teszi praktikussá az eszközt a fejlesztői napi munkafolyamatokhoz: a globális konfigurációd a szokásaidat tükrözi, míg egy ügyfél tárolója a saját könyvtárán belül érvényesíti a saját szabályait anélkül, hogy manuálisan váltogatnod kellene a beállításokat.

Fájlszerkezet

A config.toml fájl a TOML formátumot használja, amely egy olvasható és egyértelmű konfigurációs formátum. Íme egy teljes, kommentezett példa, amely tartalmaz mindent, amire szükséged lesz:

# ~/.vibe/config.toml

# Aktív modell: a beépített modell vagy egy [[models]] előbeállítás aliasa
active_model = "mistral-medium-3.5"

# Alapértelmezett ügynök (ha a kulcs hiányzik, az alapértelmezett: ask)
default_agent = "ask"

# Egyéni rendszerprompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"

# Téma: az auto követi a terminál beállításait; a /theme parancs segítségével választhatsz
theme = "auto"

# Napi ellenőrzés az új verziók után
enable_update_checks = true

Modell kiválasztása

Az active_model paraméter határozza meg, hogy melyik modellt használja a Vibe a generáláshoz. Egy aliast vár: vagy a beépített modellt, a Mistral Medium 3.5-öt, vagy egy általad deklarált [[models]] előbeállítás aliasát (erről a következő leckében lesz szó).

active_model = "mistral-medium-3.5"

Nem kell szerkesztened a fájlt a modellek váltásához: a /model parancs menet közben vált modellt, és megjeleníti az elérhető lehetőségek listáját. Használd a fájlt az alapértelmezett választás beállítására, a parancsot pedig az egyszeri tesztekhez.

A rendszerprompt testreszabása

A rendszerprompt határozza meg a Vibe viselkedését. Alapértelmezés szerint úgy van konfigurálva, hogy hatékony kódolási asszisztens legyen, de specializálhatod is. Gyakran ez az a beállítás, amely a leglátványosabb javulást hozza: egy ügynök, amely előre ismeri a konvencióidat, megszűnik olyan kódot javasolni, amelyet át kell formázni.

A promptok Markdown fájlok, amelyek a ~/.vibe/prompts/ könyvtárban találhatók. Hozd létre a sajátodat; íme egy példa egy Pythonnal és FastAPI-val dolgozó csapat számára:

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

Ezután hivatkozz rá a config.toml fájlban a fájlnév használatával, kiterjesztés nélkül:

system_prompt_id = "mon_prompt"

Ügynökök konfigurálása

Az ügynökök túlmutatnak a puszta promptokon: teljes konfigurációs profilok, ahol minden ügynöknek saját modellje, rendszerpromptja és eszközengedélyei vannak. Ezeket a ~/.vibe/agents/ könyvtárban hozod létre. A legvilágosabb példa egy kódreview-ügynök:

# ~/.vibe/agents/code_review.toml

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

[tools.bash]
permission = "never"

Indítsd el igény szerint:

vibe --agent code_review

Ez az ügynök csak olvasni tud: nem írhat fájlokat, és nem hajthat végre parancsokat. Ezért biztonságosan rábízhatod egy kolléga branchének átvizsgálását anélkül, hogy a véletlen módosításoktól kellene tartanod, így ez az ideális mód a biztonságos kódreview-khoz.

Eszközvezérlés

Ez az eszkökszűrés a fő konfigurációra is vonatkozik. Két lista áll rendelkezésre: az egyik csak bizonyos eszközök engedélyezésére, a másik pedig azok tiltására szolgál:

# Csak bizonyos eszközök engedélyezése
enabled_tools = ["read_file", "grep", "edit"]   # edit: korábban search_replace

# Bizonyos eszközök letiltása
disabled_tools = ["bash", "write_file"]

Minden nevet kézzel begépelni unalmassá válik, amikor egy MCP szerver húsz eszközt tesz közzé. Az MCP eszközök neve {server}_{eszköz} alakú, és a szűrők elfogadnak helyettesítő karaktereket és reguláris kifejezéseket (a re: előtaggal). Ez lehetővé teszi, hogy családok szerint gondolkodj, ne pedig egyesével az eszközök szerint:

# A serena nevű MCP szerver összes eszközének engedélyezése (glob minta)
enabled_tools = ["serena_*"]
# ... vagy ugyanez reguláris kifejezéssel:
# enabled_tools = ["re:^serena_.*$"]

# A fetch_server MCP szerver összes eszközének letiltása
disabled_tools = ["fetch_server_*"]

Téma és konfiguráció helye

Állítsd be a témát ugyanabban a fájlban, vagy menet közben a /theme parancs segítségével:

theme = "auto"

Az elérhető témák verziónként változnak; használd a /theme parancsot interaktív módban a teljes lista megtekintéséhez, és minden lehetőséget előnézhetsz, mielőtt véglegesítenéd a választásodat.

Végezetül, a Vibe alapértelmezés szerint a ~/.vibe/ könyvtárban tárolja a konfigurációt, de ezt a helyet egy környezeti változóval módosíthatod:

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

Ez akkor hasznos, ha a saját könyvtárad egy lassú hálózati meghajtón található, ahol minden konfigurációs olvasás késleltetést okozna, vagy ha egy szinkronizációs szolgáltatáson keresztül több gépen is megosztod a konfigurációt.

Projektspecifikus konfiguráció

Visszatérve a nyitó forgatókönyvhöz: a projektspecifikus beállításokhoz hozd létre a .vibe/config.toml fájlt a projekt gyökérkönyvtárában:

mkdir -p .vibe
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"

[tools.bash]
permission = "ask"
allowlist = ["git status", "git diff", "pytest"]
EOF

A Vibe csak akkor tölti be ezt a fájlt, ha a mappát megbízhatónak nyilvánítottad az első indításkor. Óvintézkedésként a commit előtt: add hozzá a .vibe/ könyvtárat a .gitignore fájlhoz, ha a fájl érzékeny információkat tartalmaz, például olyan változóneveket vagy belső URL-címeket, amelyeket nem szeretnél feltölteni a tárolóba.

Főbb megállapítások

  • A config.toml létezik globális (~/.vibe/) és projekt (./.vibe/) verzióban is
  • A projektkonfiguráció elsőbbséget élvez a globális konfigurációval szemben
  • Az ügynökök teljes profilok modellel, prompttal és engedélyekkel; az alapértelmezett ügynököt a default_agent segítségével állíthatod be
  • Az eszközök szűrhetők helyettesítő karakterekkel vagy regex segítségével
  • A VIBE_HOME változó lehetővé teszi a konfigurációs könyvtár megváltoztatását