Datoteka config.toml
Na tej strani
Lekcija posodobljena 2. novembra 2026 na podlagi dokumentacije Vibe Code: integriran model Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(ključenable_auto_updatenima več učinka), orodjeedit(nekdanjisearch_replace) in odstranjen razdelek[safety], ki ga je nadomestildefault_agent. Viri: Konfiguracija · Referenca za konfiguracijo.
Kje se nahaja config.toml?
Vibe išče svojo konfiguracijsko datoteko na dveh mestih, v tem vrstnem redu:
- Konfiguracija projekta:
./.vibe/config.toml(v trenutnem imeniku) - Globalna konfiguracija:
~/.vibe/config.toml(v vašem domačem imeniku)
Konfiguracija projekta ima prednost pred globalno konfiguracijo. Ta mehanizem naredi orodje praktično za vsakodnevno delo razvijalca: vaša globalna konfiguracija odraža vaše navade, medtem ko skladišče klienta uveljavlja lastna pravila znotraj svojega imenika, ne da bi morali ročno preklopiti nastavitve.
Struktura datoteke
Datoteka config.toml uporablja format TOML, berljiv in nedvoumen konfiguracijski format. Tukaj je popoln primer s komentarji, ki vsebuje vse, kar boste potrebovali:
# ~/.vibe/config.toml
# Aktivni model: vgrajeni model ali alias za prednastavitev [[models]]
active_model = "mistral-medium-3.5"
# Privzeti agent (če ključ manjka, se uporabi accept-edits)
default_agent = "ask"
# Sistemski poziv po meri (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: samodejno sledi terminalu; za izbiro uporabite /theme
theme = "auto"
# Dnevno preverjanje novih različic
enable_update_checks = true
Izbira modela
Parameter active_model določa, kateri model Vibe uporablja za generiranje. Pričakuje alias: bodisi vgrajeni model, Mistral Medium 3.5, bodisi alias za prednastavitev [[models]], ki ste jo deklarirali (obravnavano v naslednji lekciji).
active_model = "mistral-medium-3.5"
Datoteke vam ni treba urejati za spremembo modelov: ukaz /model preklopi modele sredi seje in prikaže seznam razpoložljivih možnosti. Datoteko uporabite za nastavitev privzete izbire, ukaz pa za enkratne teste.
Prilagajanje sistemskega poziva
Sistemski poziv določa obnašanje Vibea. Privzeto je konfiguriran kot učinkovit asistent za kodiranje, vendar ga lahko specializirate. To je pogosto nastavitev, ki prinese najbolj vidne rezultate: agent, ki vnaprej pozna vaše konvencije, preneha predlagati kodo, ki jo je treba preoblikovati.
Pozivi so datoteke Markdown, shranjene v ~/.vibe/prompts/. Ustvarite svoje; tukaj je primer za ekipo, ki dela s Pythonom in 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
Nato ga sklicujte v config.toml z uporabo imena datoteke brez končnice:
system_prompt_id = "mon_prompt"
Konfiguriranje agentov
Agenti gredo dlje od samih pozivov: so popolni konfiguracijski profili, kjer ima vsak agent svoj model, sistemski poziv in dovoljenja za orodja. Ustvarite jih v ~/.vibe/agents/. Najjasnejši primer je agent za pregled kode:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Zaženite ga po potrebi:
vibe --agent code_review
Ta agent lahko samo bere: ne more zapisovati datotek ali izvajati ukazov. Zato mu lahko dovolite skeniranje veje kolega brez strahu pred nenamernimi spremembami, kar ga dela za idealni način za varne preglede kode.
Nadzor orodij
To filtriranje orodij velja tudi za glavno konfiguracijo. Na voljo sta dva seznama: eden za dovoljenje samo določenih orodij in drugi za njihovo prepoved:
# Omogoči samo določena orodja
enabled_tools = ["read_file", "grep", "edit"] # edit: nekdanji search_replace
# Onemogoči določena orodja
disabled_tools = ["bash", "write_file"]
Ročno vnašanje vsakega imena postane dolgočasno, ko strežnik MCP razkrije dvajset orodij. Orodja MCP so poimenovana {server}_{tool}, filtri pa sprejemajo nadomestne znake in regularne izraze (predpona re:). To vam omogoča razmišljanje po družinah namesto po posameznih orodjih:
# Omogoči vsa orodja strežnika MCP z imenom serena (vzorec glob)
enabled_tools = ["serena_*"]
# ... ali isto z regularnim izrazom:
# enabled_tools = ["re:^serena_.*$"]
# Onemogoči vsa orodja strežnika MCP fetch_server
disabled_tools = ["fetch_server_*"]
Tema in lokacija konfiguracije
Temo nastavite v isti datoteki ali sproti prek ukaza /theme:
theme = "auto"
Razpoložljive teme se razlikujejo glede na različico; v interaktivnem načinu uporabite /theme, da si ogledate celoten seznam in predogledate vsako možnost, preden dokončno izberete.
Končno, Vibe privzeto shrani svojo konfiguracijo v ~/.vibe/, vendar lahko to lokacijo spremenite prek spremenljivke okolja:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
To je uporabno, če je vaš domači imenik na počasnem omrežnem pogonu, kjer bi vsako branje konfiguracije povzročilo zakasnitev, ali če delite konfiguracijo med več računalniki prek storitve za sinhronizacijo.
Konfiguracija specifična za projekt
Vrnimo se k uvodnemu scenariju: za nastavitve, specifične za projekt, ustvarite .vibe/config.toml v korenskem imeniku projekta:
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 to datoteko naloži le, če ste ob prvem zagonu imenik razglasili za zaupanja vrednega. Kot previdnostni ukrep pred uveljavitvijo sprememb: dodajte .vibe/ v svoj .gitignore, če datoteka vsebuje občutljive informacije, kot so imena spremenljivk ali notranji URL-ji, ki jih ne želite potisniti v skladišče.
Ključne ugotovitve
- config.toml obstaja v globalni (
~/.vibe/) in projektni (./.vibe/) različici - Konfiguracija projekta ima prednost pred globalno konfiguracijo
- Agenti so popolni profili z modelom, pozivom in dovoljenji; privzeti agent nastavite z
default_agent - Orodja lahko filtrirate z nadomestnimi znaki ali regexom
- Spremenljivka
VIBE_HOMEvam omogoča spremembo imenika za konfiguracijo