Fail config.toml
Sellel lehel
Tund uuendatud 2. novembril 2026, tuginedes Vibe Code’i dokumentatsioonile: integreeritud mudel Mistral Medium 3.5 (lisaks Devstral 2),
enable_update_checks(võtienable_auto_updateenam ei mõjuta), tööriistedit(varemsearch_replace) ja eemaldatud sektsioon[safety], mis asendati võtmegadefault_agent. Allikad: Configuration · Configuration reference.
Kus asub fail config.toml?
Vibe otsib oma konfiguratsioonifaili kahest kohast, järgides seda järjekorda:
- Projekti konfiguratsioon:
./.vibe/config.toml(praeguses kataloogis) - 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_HOMEvõimaldab muuta konfiguratsiooni kataloogi