Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Datoteka config.toml

Lekcija 6 od 16 Posodobljeno 2. november 2026 Razvijalec
Na tej strani
  1. Kje se nahaja config.toml?
  2. Struktura datoteke
  3. Izbira modela
  4. Prilagajanje sistemskega poziva
  5. Konfiguriranje agentov
  6. Nadzor orodij
  7. Tema in lokacija konfiguracije
  8. Konfiguracija specifična za projekt
  9. Ključne ugotovitve

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_update nima več učinka), orodje edit (nekdanji search_replace) in odstranjen razdelek [safety], ki ga je nadomestil default_agent. Viri: Konfiguracija · Referenca za konfiguracijo.

Kje se nahaja config.toml?

Vibe išče svojo konfiguracijsko datoteko na dveh mestih, v tem vrstnem redu:

  1. Konfiguracija projekta: ./.vibe/config.toml (v trenutnem imeniku)
  2. 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_HOME vam omogoča spremembo imenika za konfiguracijo