Arbeitsverzeichnis steuern
Auf dieser Seite
Lektion aktualisiert am 2. November 2026: Die Beispiele setzen nicht mehr
active_model = "devstral-2"(Devstral wurde von der API entfernt). Ohne diesen Schlüssel verwendet das Projekt das Modell, das in Ihrer Benutzerkonfiguration definiert ist. Hinweis: Eine Projektdatei.vibe/config.tomlwird nur innerhalb eines vertrauenswürdigen Ordners geladen. Quelle: Konfiguration.
Aktualisierung vom 2. November 2026 — Devstral. Devstral 2 (
devstral-2512) erreichte am 31. Juli 2026 sein Lebensende, und Devstral Small 2 am 31. März 2026: Aufrufe an diese Modelle sind nicht mehr garantiert. Die offizielle Modelltabelle leitet diese auf Mistral Medium 3.5 weiter, die ihrerseits zugunsten von Mistral Large 4 veraltet ist. Codestral (codestral-2508) bleibt für Code-Vervollständigungen allgemein verfügbar. Prüfen Sie die Modelltabelle, um zu sehen, wohin-latest-Alias verweisen, bevor Sie diese Beispiele wiederverwenden.
Das Startverzeichnis definiert das Projekt
Wenn Sie vibe ausführen, übernimmt der Agent das aktuelle Verzeichnis als Arbeitsverzeichnis. Diese Wahl ist entscheidend: Sie bestimmt den gesamten Projektkontext, da Vibe den Verzeichnisbaum durchsucht, Konfigurationsdateien liest und den Projekttyp an dieser Stelle ableitet.
cd /home/user/projects/my-api
vibe
# → Vibe analysiert das my-api-Projekt
Das Starten von Vibe aus Ihrem Heimatverzeichnis statt aus dem Repository führt zu einem Agenten, der Ihren Code nicht versteht – nicht weil er das nicht könnte, sondern weil er am falschen Ort sucht. In der Praxis ist der cd-Befehl Teil des Kommandos.
Arbeiten anderswo ohne Navigation
Manchmal ist cd nicht möglich oder bequem. Die Option --workdir weist das Zielverzeichnis explizit aus:
vibe --workdir /home/user/projects/my-api
Das Verhalten ist strikt identisch mit dem Starten aus diesem Ordner: Projektsuche, Auflösung von Dateipfaden und Shell-Befehle verwenden dieses Verzeichnis als Basis. Diese Option ist nützlich für Automatisierungsskripte, bei denen Sie das aktuelle Verzeichnis nicht kontrollieren, beim Wechseln zwischen mehreren Projekten ohne Terminalwechsel und in CI/CD-Pipelines, um auf ein frisch geklontes Repository zu verweisen. Der Skript-Fall ist am anschaulichsten und ermöglicht es Ihnen, eine Reihe von Projekten in einer Schleife zu verarbeiten:
# In einem Skript
for project in api frontend worker; do
vibe --workdir "/projects/$project" \
--prompt "Nach npm-Schwachstellen suchen" \
--output json > "audit-$project.json"
done
Organisation von Mehrprojekt-Arbeit
Im interaktiven Modus ist der sauberste Ansatz, pro Projekt ein Terminal – oder einen tmux-Pane oder eine screen-Sitzung – zu verwenden:
# Terminal 1: Backend-API
cd /projects/api-backend
vibe
# Terminal 2: Frontend
cd /projects/frontend-react
vibe
# Terminal 3: Infrastruktur
cd /projects/infra-terraform
vibe
Jede Instanz hat dann ihren eigenen Kontext, ihre eigene Sitzung und ihre eigene Historie, wodurch Sie Terraform-Überlegungen nicht mit React-Logik vermischen.
Diese Trennung erstreckt sich bis hin zur Konfiguration. Das Platzieren einer .vibe/config.toml-Datei in jedem Projekt passt das Verhalten des Agents an den jeweiligen Codebase an. Für eine Python-API:
# Python-API-Projekt
# /projects/api-backend/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "python_expert"
[tools.bash]
permission = "ask"
EOF
Und für ein React-Frontend, indem ein MCP-Server hinzugefügt wird:
# React-Frontend-Projekt
# /projects/frontend-react/.vibe/config.toml
cat > .vibe/config.toml << 'EOF'
system_prompt_id = "react_expert"
[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]
EOF
Die Prioritätsregel ist einfach zu merken: Die Projektkonfiguration (./.vibe/config.toml) überschreibt die globale Konfiguration (~/.vibe/config.toml). Jedes Repository kann somit sein eigenes Modell, seinen eigenen Systemprompt und seine eigenen MCP-Server durchsetzen, ohne dass Sie beim Wechseln zwischen ihnen etwas ändern müssen.
Vertrauenswürdige Ordner
Das Arbeitsverzeichnis bestimmt auch, was Vibe tun darf, ohne Sie zu fragen. Das System der vertrauenswürdigen Ordner stützt sich auf ~/.vibe/trusted_folders.toml, das Orte auflistet, an denen bestimmte automatische Aktionen – insbesondere die automatische Genehmigung – erlaubt sind.
# ~/.vibe/trusted_folders.toml
trusted = [
"/home/user/projects/my-api",
"/home/user/projects/frontend",
]
Wenn Sie die automatische Genehmigung in einem Verzeichnis aktivieren, das in dieser Liste fehlt, warnt Vibe Sie, dass es nicht als vertrauenswürdig gilt. Genau diese Schutzmaßnahme wollen Sie, wenn Sie ein unbekanntes Repository klonen, um einem Kollegen zu helfen.
Verweise auf Dateien und Verzeichniswechsel während der Sitzung
In Ihren Gesprächen akzeptiert @ sowohl relative Pfade zum Arbeitsverzeichnis als auch absolute Pfade, wobei die Autovervollständigung in beiden Fällen funktioniert.
# Relativer Pfad (empfohlen)
Erklären Sie den Code in @src/api/routes.ts
# Absoluter Pfad
Erklären Sie den Code in @/home/user/projects/my-api/src/api/routes.ts
Bevorzugen Sie relative Pfade: Sie sind lesbarer und bleiben unabhängig vom Benutzer oder der Maschine gültig, was wichtig ist, wenn Sie einen Prompt mit einem Kollegen teilen.
Schließlich hindert nichts daran, während einer Sitzung mit einem Shell-Befehl anderswohin zu navigieren:
!cd /other/project && ls
Seien Sie jedoch darüber informiert, was Sie erhalten: Der Projektkontext aus der anfänglichen Suche bleibt an das Startverzeichnis gebunden, und Vibe durchsucht den neuen Ordner nicht automatisch. Der Agent wird die aufgeführten Dateien sehen, wird aber weiterhin basierend auf der ursprünglichen Projektarchitektur schlussfolgern. Für einen echten Kontextwechsel öffnen Sie eine neue Sitzung.
Kernaussagen
- Vibe verwendet das aktuelle Verzeichnis als Projektkontext beim Start
--workdirermöglicht es Ihnen, ein Verzeichnis anzugeben, ohne dorthin zu navigieren- Ein Terminal pro Projekt ist der sauberste Ansatz für Mehrprojekt-Arbeit
- Die pro-Projekt-Datei
.vibe/config.tomlpasst das Verhalten für jede Codebase an - Das System der vertrauenswürdigen Ordner sichert die automatische Genehmigung auf Verzeichnisbasis
- Relative Pfade mit @ werden für die Lesbarkeit empfohlen