Файлът config.toml
На тази страница
Урокът е актуализиран на 2 ноември 2026 г. въз основа на документацията на Vibe Code: интегриран модел Mistral Medium 3.5 (плюс Devstral 2),
enable_update_checks(ключътenable_auto_updateвече няма ефект), инструментътedit(предишно имеsearch_replace) и премахнатият раздел[safety], заменен отdefault_agent. Източници: Configuration · Configuration reference.
Къде се намира config.toml?
Vibe търси своя конфигурационен файл на две места, в следния ред:
- Проектна конфигурация:
./.vibe/config.toml(в текущата директория) - Глобална конфигурация:
~/.vibe/config.toml(във Вашата домашна директория)
Проектната конфигурация има приоритет пред глобалната. Този механизъм прави инструмента практичен за ежедневния работен поток на разработчика: глобалната Ви конфигурация отразява Вашите навици, докато хранилището на клиента налага собствените си правила в своята директория, без да се налага ръчно да превключвате настройките.
Структура на файла
Файлът config.toml използва формата TOML – четим и недвусмислен формат за конфигурация. Ето пълен пример с коментари, съдържащ всичко, от което ще се нуждаете:
# ~/.vibe/config.toml
# Активен модел: вграденият модел или псевдоним за预设 [[models]]
active_model = "mistral-medium-3.5"
# Агент по подразбиране (приема редакции, ако ключът липсва)
default_agent = "ask"
# Персонализиран системен промпт (~/.vibe/prompts/my_custom_prompt.md)
system_prompt_id = "my_custom_prompt"
# Тема: автоматично следва терминала; използвайте /theme за избор
theme = "auto"
# Ежедневна проверка за нови версии
enable_update_checks = true
Избор на модел
Параметърът active_model определя кой модел Vibe използва за генериране. Той очаква псевдоним: или вградения модел Mistral Medium 3.5, или псевдоним за预设 [[models]], който сте декларирали (разгледано в следващия урок).
active_model = "mistral-medium-3.5"
Не е необходимо да редактирате файла, за да смените моделите: командата /model превключва моделите по време на сесията и показва списък с наличните опции. Използвайте файла, за да зададете избора си по подразбиране, а командата – за еднократни тестове.
Персонализиране на системния промпт
Системният промпт дефинира поведението на Vibe. По подразбиране той е конфигуриран да бъде ефективен асистент за кодиране, но можете да го специализирате. Това често е настройката, която носи най-видим полза: агент, който предварително познава Вашите конвенции, спира да предлага код, който се нуждае от преформатиране.
Промптовете са Markdown файлове, съхранявани в ~/.vibe/prompts/. Създайте свой собствен; ето пример за екип, работещ с Python и 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
След това го реферирайте в config.toml, използвайки името на файла без разширението:
system_prompt_id = "mon_prompt"
Конфигуриране на агенти
Агентите отиват по-далеч от самите промптове: те са пълни профили за конфигурация, където всеки агент има собствен модел, системен промпт и разрешения за инструменти. Създавате ги в ~/.vibe/agents/. Най-ясният пример е агент за код ревю:
# ~/.vibe/agents/code_review.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]
[tools.bash]
permission = "never"
Стартирайте го при поискване:
vibe --agent code_review
Този агент може само да чете: той не може да записва файлове или да изпълнява команди. Следователно можете да му позволите да сканира бранча на колега, без да се страхувате от случайни модификации, което го прави идеален режим за безопасни код ревюта.
Контрол на инструментите
Това филтриране на инструменти важи и за основната конфигурация. Налични са два списъка: един за разрешаване само на конкретни инструменти и друг за забраняването им:
# Разрешаване само на конкретни инструменти
enabled_tools = ["read_file", "grep", "edit"] # edit: предишно име search_replace
# Забраняване на конкретни инструменти
disabled_tools = ["bash", "write_file"]
Ръчното въвеждане на всяко име става досадно, когато MCP сървър излага двадесет инструмента. MCP инструментите се именуват като {server}_{tool}, а филтрите приемат заместващи символи и регулярни изрази (префикс re:). Това Ви позволява да мислите по семейства, а не по отделни инструменти:
# Разрешаване на всички инструменти от MCP сървър с име serena (glob шаблон)
enabled_tools = ["serena_*"]
# ... или същото нещо с регулярен израз:
# enabled_tools = ["re:^serena_.*$"]
# Забраняване на всички инструменти от MCP сървъра fetch_server
disabled_tools = ["fetch_server_*"]
Тема и местоположение на конфигурацията
Задайте темата в същия файл или динамично чрез командата /theme:
theme = "auto"
Наличните теми варират според версията; използвайте /theme в интерактивен режим, за да видите пълния списък и да прегледате всяка опция, преди да заключите избора си.
Накрая, Vibe съхранява своята конфигурация в ~/.vibe/ по подразбиране, но можете да промените това местоположение чрез променлива на средата:
export VIBE_HOME="/chemin/vers/mon/dossier/vibe"
Това е полезно, ако Вашата домашна директория се намира на бавен мрежов диск, където всяко четене на конфигурация би внесло забавяне, или ако споделяте конфигурация между множество машини чрез услуга за синхронизация.
Специфична за проекта конфигурация
Връщайки се към началния сценарий: за настройки, специфични за проекта, създайте .vibe/config.toml в корена на проекта:
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 зарежда този файл само ако сте декларирали папката като доверена при първото стартиране. Като предпазна мярка преди commit: добавете .vibe/ към Вашия .gitignore, ако файлът съдържа чувствителна информация, като имена на променливи или вътрешни URL адреси, които не искате да бъдат изпратени в хранилището.
Ключови изводи
- config.toml съществува в глобална (
~/.vibe/) и проектна (./.vibe/) версия - Проектната конфигурация има приоритет пред глобалната конфигурация
- Агентите са пълни профили с модел, промпт и разрешения; задайте агента по подразбиране с
default_agent - Инструментите могат да се филтрират чрез заместващи символи или регулярни изрази
- Променливата
VIBE_HOMEВи позволява да промените директорията за конфигурация