A config.toml fájl
Ezen az oldalon
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_checksbeállítás (azenable_auto_updatekulcs már nincs hatással), azediteszköz (korábbansearch_replace), valamint a törölt[safety]szakaszt adefault_agentvá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:
- Projektkonfiguráció:
./.vibe/config.toml(az aktuális könyvtárban) - 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_agentsegítségével állíthatod be - Az eszközök szűrhetők helyettesítő karakterekkel vagy regex segítségével
- A
VIBE_HOMEváltozó lehetővé teszi a konfigurációs könyvtár megváltoztatását