Die config.toml-Datei
Auf dieser Seite
Lektion aktualisiert am 2. November 2026 basierend auf der Vibe Code-Dokumentation: Integration des Modells Mistral Medium 3.5 (plus Devstral 2),
enable_update_checks(der Schlüsselenable_auto_updatehat keine Wirkung mehr),edit-Tool (frühersearch_replace) und der entfernte[safety]-Abschnitt, der durchdefault_agentersetzt wurde. Quellen: Konfiguration · Konferenzenzreferenz.
Wo befindet sich config.toml?
Vibe sucht die Konfigurationsdatei an zwei Stellen, in dieser Reihenfolge:
- Projekt-Konfiguration:
./.vibe/config.toml(im aktuellen Verzeichnis) - Globale Konfiguration:
~/.vibe/config.toml(in Ihrem Heimatverzeichnis)
Die Projekt-Konfiguration hat Vorrang vor der globalen Konfiguration. Dieser Mechanismus macht das Tool für den täglichen Arbeitsablauf eines Entwicklers praktisch: Ihre globale Konfiguration spiegelt Ihre Gewohnheiten wider, während ein Repository eines Kunden innerhalb seines Verzeichnisses eigene Regeln durchsetzt, ohne dass Sie manuell Einstellungen umschalten müssen.
Dateistruktur
Die config.toml-Datei verwendet das TOML-Format, ein lesbares und eindeutiges Konfigurationsformat. Hier ist ein vollständiges kommentiertes Beispiel, das alles enthält, was Sie benötigen:
# ~/.vibe/config.toml
# Aktives Modell: das integrierte Modell oder ein Alias für ein [[models]]-Vorgabe
active_model = "mistral-medium-3.5"
# Standard-Agent (Akzeptiert Änderungen, wenn der Schlüssel fehlt)
default_agent = "ask"
# Benutzerdefinigtes System-Prompt (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Thema: auto folgt dem Terminal; verwenden Sie /theme zur Auswahl
theme = "auto"
# Tägliche Prüfung auf neue Versionen
enable_update_checks = true
Modell auswählen
Der Parameter active_model bestimmt, welches Modell Vibe für die Generierung verwendet. Er erwartet einen Alias: entweder das integrierte Modell, Mistral Medium 3.5, oder einen Alias für eine [[models]]-Vorgabe, die Sie deklariert haben (dies wird in der nächsten Lektion behandelt).
active_model = "mistral-medium-3.5"
Sie müssen die Datei nicht bearbeiten, um Modelle zu wechseln: Der /model-Befehl wechselt Modelle mitten in einer Sitzung und zeigt die Liste der verfügbaren Optionen an. Verwenden Sie die Datei, um Ihre Standardauswahl festzulegen, und den Befehl für einmalige Tests.
System-Prompt anpassen
Der System-Prompt definiert das Verhalten von Vibe. Standardmäßig ist es so konfiguriert, dass es ein effektiver Programmierassistent ist, aber Sie können ihn spezialisieren. Dies ist oft die Einstellung, die den sichtbarsten Gewinn bringt: Ein Agent, der Ihre Konventionen von vornherein kennt, schlägt keinen Code vor, der neu formatiert werden muss.
Prompts sind Markdown-Dateien, die in ~/.vibe/prompts/ gespeichert sind. Erstellen Sie Ihre eigenen; hier ist ein Beispiel für ein Team, das mit Python und FastAPI arbeitet:
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
Verweisen Sie darauf dann in config.toml unter Verwendung des Dateinamens ohne die Endung:
system_prompt_id = "mon_prompt"
Agenten konfigurieren
Agenten gehen über reine Prompts hinaus: Sie sind vollständige Konfigurationsprofile, bei denen jeder Agent über sein eigenes Modell, sein System-Prompt und Tool-Berechtigungen verfügt. Sie erstellen sie in ~/.vibe/agents/. Das klarste Beispiel ist ein Code-Review-Agent:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Starten Sie ihn auf Abruf:
vibe --agent code_review
Dieser Agent kann nur lesen: Er kann keine Dateien schreiben oder Befehle ausführen. Sie können ihn daher verwenden, um einen Branch eines Kollegen zu scannen, ohne Angst vor versehentlichen Änderungen zu haben, was ihn zum idealen Modus für sichere Code-Reviews macht.
Tool-Steuerung
Diese Tool-Filterung gilt auch für die Hauptkonfiguration. Es stehen zwei Listen zur Verfügung: eine, um nur bestimmte Tools zuzulassen, und eine, um sie zu verbieten:
# Nur bestimmte Tools aktivieren
enabled_tools = ["read_file", "grep", "edit"] # edit: früher search_replace
# Bestimmte Tools deaktivieren
disabled_tools = ["bash", "write_file"]
Das manuelle Tippen jedes Namens wird mühsam, wenn ein MCP-Server zwanzig Tools bereitstellt. MCP-Tools werden als {server}_{tool} benannt, und Filter akzeptieren Wildecards und Reguläre Ausdrücke (Präfix re:). Dies ermöglicht es Ihnen, nach Familien statt nach einzelnen Tools zu argumentieren:
# Aktiviere alle Tools von einem MCP-Server namens serena (Glob-Muster)
enabled_tools = ["serena_*"]
# ... oder dasselbe mit einem regulären Ausdruck:
# enabled_tools = ["re:^serena_.*$"]
# Deaktiviere alle Tools vom fetch_server MCP-Server
disabled_tools = ["fetch_server_*"]
Thema und Konfigurationsort
Stellen Sie das Thema in derselben Datei ein oder wechseln Sie es auf dem Laufenden über den /theme-Befehl:
theme = "auto"
Verfügbare Themen variieren je nach Version; verwenden Sie /theme im interaktiven Modus, um die vollständige Liste anzuzeigen und jede Option vor der Festlegung vorab vorzusehen.
Schließlich speichert Vibe seine Konfiguration standardmäßig in ~/.vibe/, aber Sie können diesen Ort über eine Umgebungsvariable ändern:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Dies ist nützlich, wenn Ihr Heimatverzeichnis auf einem langsamen Netzwerklaufwerk liegt, bei dem jede Konfigurationsabfrage Latenz verursachen würde, oder wenn Sie eine Konfiguration über einen Synchronisationsservice auf mehreren Maschinen teilen.
Projekt-spezifische Konfiguration
Zurück zum eröffnenden Szenario: Für projekt-spezifische Einstellungen erstellen Sie .vibe/config.toml am Wurzelverzeichnis des Projekts:
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 lädt diese Datei nur, wenn Sie das Verzeichnis beim ersten Start als vertrauenswürdig deklariert haben. Als Vorsichtsmaßnahme vor dem Commit: Fügen Sie .vibe/ zu Ihrer .gitignore hinzu, falls die Datei sensible Informationen enthält, wie Variablennamen oder interne URLs, die Sie nicht in das Repository hochladen möchten.
Kernaussagen
config.tomlexistiert in globaler (~/.vibe/) und projekt-spezifischer (./.vibe/) Version- Projekt-Konfiguration hat Vorrang vor globaler Konfiguration
- Agenten sind vollständige Profile mit Modell, Prompt und Berechtigungen; legen Sie den Standard-Agent mit
default_agentfest - Tools können mit Wildecards oder regulären Ausdrücken gefiltert werden
- Die
VIBE_HOME-Variable ermöglicht es, das Konfigurationsverzeichnis zu ändern