Fișierul config.toml
Pe această pagină
Lecție actualizată la 2 noiembrie 2026 pe baza documentației Vibe Code: model integrat Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(cheiaenable_auto_updatenu mai are efect), instrumentuledit(fostulsearch_replace) și secțiunea[safety]eliminată, înlocuită dedefault_agent. Surse: Configuration · Configuration reference.
Unde se află config.toml?
Vibe caută fișierul său de configurare în două locuri, în această ordine:
- Configurarea proiectului:
./.vibe/config.toml(în directorul curent) - Configurarea globală:
~/.vibe/config.toml(în directorul dumneavoastră home)
Configurarea proiectului are prioritate față de cea globală. Acest mecanism face instrumentul practic pentru fluxul de lucru zilnic al unui dezvoltator: configurația globală reflectă obiceiurile dumneavoastră, în timp ce repository-ul unui client își impune propriile reguli în interiorul directorului său, fără a vă obliga să comutați manual setările.
Structura fișierului
Fișierul config.toml folosește formatul TOML, un format de configurare lizibil și neambiguu. Iată un exemplu complet comentat care conține tot ce aveți nevoie:
# ~/.vibe/config.toml
# Model activ: modelul încorporat sau un alias pentru un preset [[models]]
active_model = "mistral-medium-3.5"
# Agent implicit (accept-edits dacă cheia lipsește)
default_agent = "ask"
# Prompt de sistem personalizat (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Temă: auto urmează terminalul; folosiți /theme pentru a alege
theme = "auto"
# Verificare zilnică pentru noi versiuni
enable_update_checks = true
Alegerea modelului
Parametrul active_model determină ce model folosește Vibe pentru generare. Acesta așteaptă un alias: fie modelul încorporat, Mistral Medium 3.5, fie un alias pentru un preset [[models]] pe care l-ați declarat (acoperit în lecția următoare).
active_model = "mistral-medium-3.5"
Nu trebuie să editați fișierul pentru a schimba modelele: comanda /model comută modelele în timpul sesiunii și afișează lista opțiunilor disponibile. Folosiți fișierul pentru a seta alegerea implicită și comanda pentru teste punctuale.
Personalizarea promptului de sistem
Promptul de sistem definește comportamentul lui Vibe. Implicit, este configurat să fie un asistent de codificare eficient, dar îl puteți specializa. Aceasta este adesea setarea care oferă cel mai vizibil câștig: un agent care vă cunoaște convențiile din start nu va mai propune cod care necesită reformatare.
Prompturile sunt fișiere Markdown stocate în ~/.vibe/prompts/. Creați-le pe ale dumneavoastră; iată un exemplu pentru o echipă care lucrează cu Python și 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
Apoi, faceți referire la el în config.toml folosind numele fișierului fără extensie:
system_prompt_id = "mon_prompt"
Configurarea agenților
Agenții merg mai departe decât simplile prompturi: sunt profiluri de configurare complete, unde fiecare agent are propriul model, prompt de sistem și permisiuni pentru instrumente. Îi creați în ~/.vibe/agents/. Cel mai clar exemplu este un agent de revizuire a codului:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Lansați-l la cerere:
vibe --agent code_review
Acest agent poate doar să citească: nu poate scrie fișiere sau executa comenzi. Prin urmare, îl puteți lăsa să scaneze ramura unui coleg fără teama unor modificări accidentale, făcându-l modul ideal pentru revizuiri de cod sigure.
Controlul instrumentelor
Această filtrare a instrumentelor se aplică și configurației principale. Sunt disponibile două liste: una pentru a permite doar instrumente specifice și alta pentru a le interzice:
# Activează doar instrumente specifice
enabled_tools = ["read_file", "grep", "edit"] # edit: fostul search_replace
# Dezactivează instrumente specifice
disabled_tools = ["bash", "write_file"]
Tastarea fiecărui nume manual devine obositoare când un server MCP expune douăzeci de instrumente. Instrumentele MCP sunt numite {server}_{tool}, iar filtrele acceptă jolly (wildcards) și expresii regulate (prefix re:). Acest lucru vă permite să raționați pe familii, nu pe instrumente individuale:
# Activează toate instrumentele de la un server MCP numit serena (model glob)
enabled_tools = ["serena_*"]
# ... sau același lucru cu o expresie regulată:
# enabled_tools = ["re:^serena_.*$"]
# Dezactivează toate instrumentele de la serverul MCP fetch_server
disabled_tools = ["fetch_server_*"]
Tema și locația configurației
Setați tema în același fișier sau din mers prin comanda /theme:
theme = "auto"
Temele disponibile variază în funcție de versiune; folosiți /theme în modul interactiv pentru a vedea lista completă și a previzualiza fiecare opțiune înainte de a vă fixa alegerea.
În final, Vibe își stochează configurația în ~/.vibe/ implicit, dar puteți schimba această locație printr-o variabilă de mediu:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Acest lucru este util dacă directorul dumneavoastră home se află pe o unitate de rețea lentă, unde fiecare citire a configurației ar induce latență, sau dacă partajați o configurație între mai multe mașini printr-un serviciu de sincronizare.
Configurarea specifică proiectului
Revenind la scenariul de deschidere: pentru setările specifice proiectului, creați .vibe/config.toml la rădăcina proiectului:
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 încarcă acest fișier doar dacă ați declarat folderul de încredere (trusted) la prima lansare. Ca măsură de precauție înainte de commit: adăugați .vibe/ în .gitignore dacă fișierul conține informații sensibile, cum ar fi nume de variabile sau URL-uri interne pe care nu doriți să le împingeți în repository.
Puncte cheie
- config.toml există în versiuni globale (
~/.vibe/) și de proiect (./.vibe/) - Configurarea proiectului are prioritate față de cea globală
- Agenții sunt profiluri complete cu model, prompt și permisiuni; setați agentul implicit cu
default_agent - Instrumentele pot fi filtrate folosind jolly sau regex
- Variabila
VIBE_HOMEvă permite să schimbați directorul de configurare