Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Fail config.toml

Õppetund 6 / 16 Värskendatud 2. november 2026 Arendajatele
Sellel lehel
  1. Kus asub fail config.toml?
  2. Faili struktuur
  3. Mudeli valimine
  4. Süsteemse viiba kohandamine
  5. Agentide konfigureerimine
  6. Tööriistade juhtimine
  7. Teema ja konfiguratsiooni asukoht
  8. Projektispetsiifiline konfiguratsioon
  9. Peamised punktid

Tund uuendatud 2. novembril 2026, tuginedes Vibe Code’i dokumentatsioonile: integreeritud mudel Mistral Medium 3.5 (lisaks Devstral 2), enable_update_checks (võti enable_auto_update enam ei mõjuta), tööriist edit (varem search_replace) ja eemaldatud sektsioon [safety], mis asendati võtmega default_agent. Allikad: Configuration · Configuration reference.

Kus asub fail config.toml?

Vibe otsib oma konfiguratsioonifaili kahest kohast, järgides seda järjekorda:

  1. Projekti konfiguratsioon: ./.vibe/config.toml (praeguses kataloogis)
  2. Globaalne konfiguratsioon: ~/.vibe/config.toml (sinu kodukataloogis)

Projekti konfiguratsioon on ülimuslik globaalse konfiguratsiooni ees. See mehhanism muudab tööriista arendaja igapäevatööks praktiliseks: sinu globaalne konfiguratsioon peegeldab sinu harjumusi, samas kui kliendi repositoorium jõustab oma reeglid oma kataloogis, nõudmata sinult seadete käsitsi vahetamist.

Faili struktuur

Fail config.toml kasutab TOML-vormingut, mis on loetav ja ühemõtteline konfiguratsioonivorming. Siin on täielik kommenteeritud näide, mis sisaldab kõike, mida vajad:

# ~/.vibe/config.toml

# Aktiivne mudel: sisseehitatud mudel või alias presaadile [[models]]
active_model = "mistral-medium-3.5"

# Vaikimisi agent (kui võti puudub, kasutatakse "ask")
default_agent = "ask"

# Kohandatud süsteemne viip (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"

# Teema: järgib automaatselt terminali; vali käsuga /theme
theme = "auto"

# Uute versioonide igapäevane kontrollimine
enable_update_checks = true

Mudeli valimine

Parameeter active_model määrab, millist mudelit Vibe genereerimisel kasutab. See ootab aliast: kas sisseehitatud mudelit Mistral Medium 3.5 või aliast presaadile [[models]], mille oled deklareerinud (sellest räägime järgmises tunnis).

active_model = "mistral-medium-3.5"

Sa ei pea mudeli vahetamiseks faili muutma: käsk /model vahetab mudeleid sessiooni käigus ja kuvab saadaolevate valikute loendi. Kasuta faili oma vaikimisi valiku määramiseks ja käsku ühekordseteks testideks.

Süsteemse viiba kohandamine

Süsteemne viip määrab Vibe’i käitumise. Vaikimisi on see seadistatud tõhusaks kodeerimisassistendiks, kuid saad seda spetsialiseerida. See on sageli seade, mis toob kõige nähtavama kasu: agent, kes tunneb juba ette sinu konventsioone, lõpetab ümberformeerimist vajava koodi pakkumise.

Viibad on Markdown-failid, mida hoitakse kataloogis ~/.vibe/prompts/. Loo oma; siin on näide meeskonnale, kes töötab Pythoni ja FastAPI-ga:

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

Seejärel viita sellele failis config.toml, kasutades failinime ilma laiendita:

system_prompt_id = "mon_prompt"

Agentide konfigureerimine

Agendid lähevad kaugemale kui pelgalt viibad: need on terved konfiguratsiooniprofiilid, kus igal agendil on oma mudel, süsteemne viip ja tööriistade õigused. Sa lood need kataloogi ~/.vibe/agents/. Kõige selgem näide on koodi ülevaatuse agent:

# ~/.vibe/agents/code_review.toml

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

[tools.bash]
permission = "never"

Käivita see vajadusel:

vibe --agent code_review

See agent saab ainult lugeda: ta ei saa faile kirjutada ega käske käivitada. Seetõttu saad lasta tal kolleegi haru skaneerida, kartmata juhuslikke muudatusi, muutes selle ideaalseks režiimiks turvaliseks koodi ülevaatuseks.

Tööriistade juhtimine

See tööriistade filtreerimine kehtib ka põhikonfiguratsioonis. Saadaval on kaks loendit: üks lubab ainult kindlaid tööriistu ja teine keelab need:

# Luba ainult kindlad tööriistad
enabled_tools = ["read_file", "grep", "edit"]   # edit: varem search_replace

# Keela kindlad tööriistad
disabled_tools = ["bash", "write_file"]

Iga nime käsitsi sisestamine muutub tüütuks, kui MCP server avaldab kakskümmend tööriista. MCP tööriistad on nimega {server}_{tool} ja filtrid aktsepteerivad metamärke ja regulaaravaldisi (eesliide re:). See võimaldab sul mõelda perekondade kaupa, mitte üksikute tööriistade kaupa:

# Luba kõik tööriistad MCP serverist nimega serena (glob-muster)
enabled_tools = ["serena_*"]
# ... või sama asi regulaaravaldise abil:
# enabled_tools = ["re:^serena_.*$"]

# Keela kõik tööriistad MCP serverist fetch_server
disabled_tools = ["fetch_server_*"]

Teema ja konfiguratsiooni asukoht

Määra teema samasse faili või reaalajas käsuga /theme:

theme = "auto"

Saadaolevad teemad varieeruvad versiooniti; kasuta interaktiivses režiimis käsku /theme, et näha täielikku loendit ja eelvaadata iga valikut enne oma valiku lukustamist.

Lõpuks salvestab Vibe oma konfiguratsiooni vaikimisi kataloogi ~/.vibe/, kuid saad seda asukohta muuta keskkonnamuutuja abil:

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

See on kasulik, kui sinu kodukataloog asub aeglasel võrgukettal, kus iga konfiguratsiooni lugemine tekitaks viivet, või kui jagad konfiguratsiooni mitme masina vahel sünkroniseerimisteenuse kaudu.

Projektispetsiifiline konfiguratsioon

Pöördume tagasi algusstsenariumi juurde: projektispetsiifiliste seadete jaoks loo .vibe/config.toml projekti juurkataloogi:

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 laadib selle faili ainult siis, kui oled kataloogi esimesel käivitamisel usaldusväärseks deklareerinud. Ettevaatusabinõuna enne commit’imist: lisa .vibe/ oma .gitignore-faili, kui fail sisaldab tundlikku teavet, nagu muutujate nimed või sisemised URL-id, mida sa repositooriumi suruda ei soovi.

Peamised punktid

  • config.toml eksisteerib globaalses (~/.vibe/) ja projekti (./.vibe/) versioonis
  • Projekti konfiguratsioon on ülimuslik globaalse konfiguratsiooni ees
  • Agendid on terved profiilid, mis sisaldavad mudelit, viipa ja õigusi; määra vaikimisi agent võtmega default_agent
  • Tööriistu saab filtreerida, kasutades metamärke või regulaaravaldisi
  • Muutuja VIBE_HOME võimaldab muuta konfiguratsiooni kataloogi