El archivo config.toml
En esta página
Lección actualizada el 2 de noviembre de 2026 según la documentación de Vibe Code: modelo integrado Mistral Medium 3.5 (más Devstral 2),
enable_update_checks(la claveenable_auto_updateya no tiene efecto), herramientaedit(anteriormentesearch_replace) y la sección[safety]eliminada, sustituida pordefault_agent. Fuentes: Configuration · Configuration reference.
¿Dónde se encuentra config.toml?
Vibe busca su archivo de configuración en dos ubicaciones, en este orden:
- Configuración del proyecto:
./.vibe/config.toml(en el directorio actual) - Configuración global:
~/.vibe/config.toml(en tu directorio personal)
La configuración del proyecto tiene prioridad sobre la global. Este mecanismo hace que la herramienta sea práctica para el flujo de trabajo diario de un desarrollador: tu configuración global refleja tus hábitos, mientras que el repositorio de un cliente impone sus propias reglas dentro de su directorio sin obligarte a cambiar la configuración manualmente.
Estructura del archivo
El archivo config.toml utiliza el formato TOML, un formato de configuración legible y sin ambigüedades. Aquí tienes un ejemplo completo comentado que contiene todo lo que necesitarás:
# ~/.vibe/config.toml
# Modelo activo: el modelo integrado o un alias para un preset [[models]]
active_model = "mistral-medium-3.5"
# Agente predeterminado (accept-edits si falta la clave)
default_agent = "ask"
# Prompt de sistema personalizado (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Tema: sigue automáticamente el terminal; usa /theme para elegir
theme = "auto"
# Comprobación diaria de nuevas versiones
enable_update_checks = true
Elección del modelo
El parámetro active_model determina qué modelo utiliza Vibe para la generación. Espera un alias: bien el modelo integrado, Mistral Medium 3.5, o un alias para un preset [[models]] que hayas declarado (se trata en la siguiente lección).
active_model = "mistral-medium-3.5"
No necesitas editar el archivo para cambiar de modelo: el comando /model cambia de modelo en mitad de la sesión y muestra la lista de opciones disponibles. Usa el archivo para establecer tu elección predeterminada y el comando para pruebas puntuales.
Personalización del prompt de sistema
El prompt de sistema define el comportamiento de Vibe. Por defecto, está configurado para ser un asistente de codificación eficaz, pero puedes especializarlo. A menudo, este es el ajuste que ofrece la mejora más visible: un agente que conoce tus convenciones de antemano deja de proponer código que necesita reformateo.
Los prompts son archivos Markdown almacenados en ~/.vibe/prompts/. Crea el tuyo propio; aquí tienes un ejemplo para un equipo que trabaja con Python y 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
A continuación, haz referencia a él en config.toml usando el nombre del archivo sin su extensión:
system_prompt_id = "mon_prompt"
Configuración de agentes
Los agentes van más allá de los simples prompts: son perfiles de configuración completos donde cada agente tiene su propio modelo, prompt de sistema y permisos de herramientas. Se crean en ~/.vibe/agents/. El ejemplo más claro es un agente de revisión de código:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Lánzalo bajo demanda:
vibe --agent code_review
Este agente solo puede leer: no puede escribir archivos ni ejecutar comandos. Por tanto, puedes dejar que escanee la rama de un compañero sin temor a modificaciones accidentales, lo que lo convierte en el modo ideal para revisiones de código seguras.
Control de herramientas
Este filtrado de herramientas también se aplica a la configuración principal. Hay dos listas disponibles: una para permitir solo herramientas específicas y otra para prohibirlas:
# Habilitar solo herramientas específicas
enabled_tools = ["read_file", "grep", "edit"] # edit: anteriormente search_replace
# Deshabilitar herramientas específicas
disabled_tools = ["bash", "write_file"]
Escribir cada nombre a mano resulta tedioso cuando un servidor MCP expone veinte herramientas. Las herramientas MCP se nombran como {servidor}_{herramienta}, y los filtros aceptan comodines y expresiones regulares (prefijo re:). Esto te permite razonar por familias en lugar de por herramientas individuales:
# Habilitar todas las herramientas de un servidor MCP llamado serena (patrón glob)
enabled_tools = ["serena_*"]
# ... o lo mismo con una expresión regular:
# enabled_tools = ["re:^serena_.*$"]
# Deshabilitar todas las herramientas del servidor MCP fetch_server
disabled_tools = ["fetch_server_*"]
Tema y ubicación de la configuración
Establece el tema en el mismo archivo o sobre la marcha mediante el comando /theme:
theme = "auto"
Los temas disponibles varían según la versión; usa /theme en modo interactivo para ver la lista completa y previsualizar cada opción antes de fijar tu elección.
Por último, Vibe almacena su configuración en ~/.vibe/ por defecto, pero puedes cambiar esta ubicación mediante una variable de entorno:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Esto es útil si tu directorio personal está en una unidad de red lenta donde cada lectura de configuración implicaría latencia, o si compartes una configuración entre varias máquinas mediante un servicio de sincronización.
Configuración específica del proyecto
Volviendo al escenario inicial: para configuraciones específicas del proyecto, crea .vibe/config.toml en la raíz del proyecto:
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 carga este archivo solo si declaraste la carpeta como de confianza en el primer lanzamiento. Como precaución antes de hacer commit: añade .vibe/ a tu .gitignore si el archivo contiene información sensible, como nombres de variables o URLs internas que no quieras subir al repositorio.
Puntos clave
- config.toml existe en versiones global (
~/.vibe/) y de proyecto (./.vibe/) - La configuración del proyecto tiene prioridad sobre la global
- Los agentes son perfiles completos con modelo, prompt y permisos; establece el agente predeterminado con
default_agent - Las herramientas se pueden filtrar usando comodines o expresiones regulares
- La variable
VIBE_HOMEte permite cambiar el directorio de configuración