Il file config.toml
In questa pagina
Lezione aggiornata il 2 novembre 2026 sulla base della documentazione di Vibe Code: modello integrato Mistral Medium 3.5 (più Devstral 2),
enable_update_checks(la chiaveenable_auto_updatenon ha più effetto), strumentoedit(precedentementesearch_replace) e la sezione[safety]rimossa sostituita dadefault_agent. Fonti: Configuration · Configuration reference.
Dove si trova config.toml?
Vibe cerca il suo file di configurazione in due posizioni, in questo ordine:
- Configurazione del progetto:
./.vibe/config.toml(nella directory corrente) - Configurazione globale:
~/.vibe/config.toml(nella tua home directory)
La configurazione del progetto ha la precedenza su quella globale. Questo meccanismo rende lo strumento pratico per il flusso di lavoro quotidiano di uno sviluppatore: la tua configurazione globale riflette le tue abitudini, mentre il repository di un cliente impone le proprie regole all’interno della sua directory senza costringerti a cambiare manualmente le impostazioni.
Struttura del file
Il file config.toml utilizza il formato TOML, un formato di configurazione leggibile e inequivocabile. Ecco un esempio completo commentato contenente tutto ciò di cui avrai bisogno:
# ~/.vibe/config.toml
# Modello attivo: il modello integrato o un alias per un preset [[models]]
active_model = "mistral-medium-3.5"
# Agente predefinito (accept-edits se la chiave manca)
default_agent = "ask"
# Prompt di sistema personalizzato (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: auto segue il terminale; usa /theme per scegliere
theme = "auto"
# Controllo giornaliero per nuove versioni
enable_update_checks = true
Scelta del modello
Il parametro active_model determina quale modello Vibe utilizza per la generazione. Si aspetta un alias: o il modello integrato, Mistral Medium 3.5, o un alias per un preset [[models]] che hai dichiarato (trattato nella prossima lezione).
active_model = "mistral-medium-3.5"
Non devi modificare il file per cambiare modello: il comando /model cambia modello a metà sessione e visualizza l’elenco delle opzioni disponibili. Usa il file per impostare la tua scelta predefinita e il comando per test occasionali.
Personalizzazione del prompt di sistema
Il prompt di sistema definisce il comportamento di Vibe. Di default, è configurato per essere un assistente di codifica efficace, ma puoi specializzarlo. Questa è spesso l’impostazione che offre il guadagno più visibile: un agente che conosce in anticipo le tue convenzioni smette di proporre codice che necessita di riformattazione.
I prompt sono file Markdown archiviati in ~/.vibe/prompts/. Crea i tuoi; ecco un esempio per un team che lavora con Python e 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
Quindi riferisciti ad esso in config.toml usando il nome del file senza estensione:
system_prompt_id = "mon_prompt"
Configurazione degli agenti
Gli agenti vanno oltre i semplici prompt: sono profili di configurazione completi in cui ogni agente ha il proprio modello, prompt di sistema e permessi per gli strumenti. Li crei in ~/.vibe/agents/. L’esempio più chiaro è un agente di revisione del codice:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Avvialo su richiesta:
vibe --agent code_review
Questo agente può solo leggere: non può scrivere file né eseguire comandi. Puoi quindi lasciargli scansionare il branch di un collega senza temere modifiche accidentali, rendendolo la modalità ideale per revisioni del codice sicure.
Controllo degli strumenti
Questo filtraggio degli strumenti si applica anche alla configurazione principale. Sono disponibili due elenchi: uno per consentire solo strumenti specifici e un altro per vietarli:
# Abilita solo strumenti specifici
enabled_tools = ["read_file", "grep", "edit"] # edit: precedentemente search_replace
# Disabilita strumenti specifici
disabled_tools = ["bash", "write_file"]
Digitare ogni nome a mano diventa noioso quando un server MCP espone venti strumenti. Gli strumenti MCP sono nominati {server}_{tool} e i filtri accettano caratteri jolly ed espressioni regolari (prefisso re:). Questo ti permette di ragionare per famiglia piuttosto che per singolo strumento:
# Abilita tutti gli strumenti da un server MCP chiamato serena (pattern glob)
enabled_tools = ["serena_*"]
# ... o la stessa cosa con un'espressione regolare:
# enabled_tools = ["re:^serena_.*$"]
# Disabilita tutti gli strumenti dal server MCP fetch_server
disabled_tools = ["fetch_server_*"]
Tema e posizione della configurazione
Imposta il tema nello stesso file o al volo tramite il comando /theme:
theme = "auto"
I temi disponibili variano in base alla versione; usa /theme in modalità interattiva per vedere l’elenco completo e visualizzare in anteprima ogni opzione prima di fissare la tua scelta.
Infine, Vibe archivia la sua configurazione in ~/.vibe/ per default, ma puoi cambiare questa posizione tramite una variabile d’ambiente:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Questo è utile se la tua home directory si trova su un’unità di rete lenta dove ogni lettura della configurazione comporterebbe latenza, o se condividi una configurazione tra più macchine tramite un servizio di sincronizzazione.
Configurazione specifica del progetto
Tornando allo scenario iniziale: per le impostazioni specifiche del progetto, crea .vibe/config.toml alla radice del progetto:
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 carica questo file solo se hai dichiarato la cartella attendibile al primo avvio. Come precauzione prima del commit: aggiungi .vibe/ al tuo .gitignore se il file contiene informazioni sensibili, come nomi di variabili o URL interni che non vuoi spingere nel repository.
Punti chiave
- config.toml esiste nelle versioni globale (
~/.vibe/) e di progetto (./.vibe/) - La configurazione del progetto ha la precedenza su quella globale
- Gli agenti sono profili completi con modello, prompt e permessi; imposta l’agente predefinito con
default_agent - Gli strumenti possono essere filtrati usando caratteri jolly o regex
- La variabile
VIBE_HOMEti permette di cambiare la directory di configurazione