Mehrere Verzeichnisse, ein Projekt
für jeden KI-Agenten, den du startest
Ein Spiel in einem Ordner und seine Portierung auf eine neuere Engine-Version in einem anderen. Eine Web-App und die API, die sie aufruft, in zwei Repositories. Eine gemeinsame Bibliothek neben den Apps, die sie nutzen. Deine Agenten brauchen beide Seiten, und die Ordner unter ein gemeinsames Elternverzeichnis zu verschieben, würde ein funktionierendes Setup kaputtmachen.
Verknüpfe die anderen Ordner stattdessen mit dem Projekt. Sie bleiben, wo sie sind, und behalten ihre eigene Versionskontrolle. Jeder Agent, den du im Projekt startest, bekommt sie: per --add-dir auf Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code und Mistral Vibe, und in seinem Briefing bei den anderen CLIs. Im Tab Änderungen prüfst und committest du danach jedes Repository.
- /work/web-appProjektordner · git
- /work/apiVerknüpfter Ordner · git
- /work/shared-libVerknüpfter Ordner · git
Ein Projekt, drei Repositories: Jeder Agent startet im Projektordner und bekommt die beiden anderen in der Form, die seine CLI versteht.
Ein Agent startet in einem Ordner, und die meisten CLIs halten ihn dort. Lesen kann er oft auch drumherum, aber außerhalb seines Arbeitsverzeichnisses zu bearbeiten bedeutet eine Berechtigungsabfrage, eine Ablehnung durch die Sandbox oder ein Flag, an das du bei jedem Start denken musst. Das geht gut, bis sich die Arbeit über zwei Orte erstreckt: die App und ihre API, ein Spiel und seine Kopie auf einer neueren Engine, eine Bibliothek und die Projekte, die sie nutzen.
Die üblichen Lösungen haben ihren Preis. Beide Ordner unter ein gemeinsames Elternverzeichnis zu verschieben, macht Pfade, Skripte und Editor-Einstellungen kaputt, die funktioniert haben. Ein Symlink verwirrt manche Tools und verschleiert, wo die Dateien wirklich liegen. --add-dir bei jedem Start einzutippen, funktioniert bis zu dem einen Start, an dem du es vergisst.
Verknüpfte Ordner sind eine Liste, die am Projekt gespeichert ist. Du fügst einen Ordner einmal hinzu, unter Projekteinstellungen, Allgemein, Verknüpfte Ordner. Ab dann bekommt jeder Agent des Projekts diese Ordner, egal ob du ihn aus der Agentenliste, aus einem Backlog-Ticket oder vom Smartphone startest, und jeder Ordner behält sein eigenes Repository.
Was verknüpfte Ordner tun
Eine Liste am Projekt, die bei jedem Start gelesen wird. Ein Projekt ohne verknüpfte Ordner funktioniert genau wie bisher.
Ordner bleiben, wo sie sind
Wähle einen Ordner mit der Ordnerauswahl des Systems. Nichts wird verschoben, kopiert oder per Symlink verknüpft, und jeder Ordner behält sein eigenes Repository, seinen Branch und seine Historie. Bis zu zehn Ordner pro Projekt.
Das passende Flag für jede CLI
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code und Mistral Vibe bekommen jeden Ordner über ihr eigenes Flag --add-dir, sowohl wenn der Agent neu startet als auch wenn er eine Sitzung fortsetzt.
Im Briefing des Agenten genannt
Jeder Agent, egal mit welcher CLI, bekommt außerdem einen kurzen Block in seinem Briefing: die Ordner, dass sie zum Projekt gehören und dass git aus jedem von ihnen heraus ausgeführt wird. Die CLIs ohne Flag erreichen sie über den vollständigen Pfad, wenn ihre Sandbox es zulässt.
Jedes Repository committen
Im Tab Änderungen listet ein Repository-Auswahlfeld den Projektordner und jeden verknüpften Ordner auf, der ein Git-Repository ist. Wähle eines, um seinen Diff zu sehen, und stage, committe und pushe es dann.
Genauso auf dem Smartphone
Ein Agent, der aus der mobilen App von AgentsRoom gestartet wird, bekommt dieselben Flags und dasselbe Briefing, weil der Desktop den Start vorbereitet. Das Smartphone zeigt die verknüpften Ordner im Projektmenü, und sein Bildschirm Änderungen bietet die verknüpften Repositories ebenfalls an.
Beim Start geprüft
Ein Ordner, der auf der Festplatte fehlt, etwa auf einem abgesteckten Laufwerk, bleibt mit einer Warnung in der Liste und wird beim Start übersprungen, mit einer Zeile im Terminal. Der Projektordner selbst und Duplikate werden abgelehnt.
So funktioniert es
Vier Schritte, und die ersten beiden erledigst du einmal pro Projekt.
- 1
Die Projekteinstellungen öffnen
Projekteinstellungen, Allgemein, Verknüpfte Ordner. Das Feld sagt, welche CLIs die Ordner per Flag bekommen und wie die anderen sie erreichen.
- 2
Einen Ordner hinzufügen
Ordner hinzufügen öffnet die Ordnerauswahl des Systems, und der Ordner wird sofort gespeichert. Das Kreuz daneben entfernt ihn später wieder aus dem Projekt: Auf der Festplatte ändert sich nichts.
- 3
Einen Agenten starten
Starte einen beliebigen Agenten des Projekts wie gewohnt: aus der Agentenliste, aus einem Backlog-Ticket oder vom Smartphone. Er startet im Projektordner und hat auch die verknüpften Ordner.
- 4
Jedes Repository prüfen und committen
Öffne den Tab Änderungen und wähle ein Repository: den Projektordner oder einen verknüpften Ordner. Lies seinen Diff, dann stage, committe und pushe es dort. Jeder Ordner behält seine eigene Historie.
Claude Code und Codex können schon ein Verzeichnis hinzufügen. Das ändert sich
Claude Code nimmt beim Start --add-dir und während einer Sitzung /add-dir an und speichert eine dauerhafte Liste in additionalDirectories seiner Einstellungsdateien. Ein hinzugefügtes Verzeichnis bekommt Dateizugriff nach denselben Berechtigungsregeln wie das Arbeitsverzeichnis. Aus einem per --add-dir oder /add-dir übergebenen Verzeichnis lädt es auch Skills, Befehle und Subagents, aber nicht dessen CLAUDE.md, außer CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 ist gesetzt; ein in einer Einstellungsdatei aufgeführtes Verzeichnis gewährt nur Dateizugriff. Geprüft anhand der Dokumentation von Claude Code und der Version 2.1.300 im Oktober 2026.
Codex hat ebenfalls --add-dir, das ein Verzeichnis neben dem Haupt-Workspace beschreibbar macht, und writable_roots unter sandbox_workspace_write in config.toml für eine dauerhafte Liste (codex-cli 0.162.1). GitHub Copilot CLI, Antigravity CLI, Kimi Code und Mistral Vibe haben jeweils ihr eigenes --add-dir.
Das Flag ist also nicht das Neue. Was AgentsRoom hinzufügt, ist die am Projekt gespeicherte Liste, die jedem Agenten bei jedem Start übergeben wird, in der Form, die jede CLI erwartet (Claude Code braucht Flag und Ordner in einem Stück, wie bei --add-dir=/work/api, sonst schluckt die Option den Prompt, der ihr folgt), dasselbe Briefing für die CLIs ohne Flag, Starts vom Smartphone, die dieselben Ordner bekommen, und einen Tab Änderungen, der jedes Repository committet. AgentsRoom setzt CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD nicht für dich.
Gut zu wissen
- Automatische Commits, wenn ein Ticket erledigt ist, ein Worktree pro Ticket und die Diffs der Team-Schritte bleiben beim Projektordner. In einem verknüpften Ordner prüfst und committest du von Hand.
- Die Liste wird auf jedem Computer gespeichert, weil ein Pfad wie D:\Games\UE5 auf einem anderen Rechner nichts bedeutet. Füge die Ordner auf deinen anderen Computern erneut hinzu.
- Ein Agent, der per SSH auf einem Remote-Server gestartet wird, bekommt die verknüpften Ordner nicht: Es sind Pfade auf diesem Computer. Eine Zeile in seinem Terminal weist darauf hin.
- OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin und Cursor haben kein Flag für ein zusätzliches Verzeichnis. Ihre Agenten finden die Ordner in ihrem Briefing und erreichen sie über den vollständigen Pfad nur, wenn ihre eigene Sandbox es erlaubt.
- Das Smartphone zeigt die Liste, bearbeitet sie aber nicht: Ein Ordner wird mit der Ordnerauswahl des Computers gewählt.
- Höchstens zehn Ordner pro Projekt, weil ein Startbefehl unter Windows eine Längenbegrenzung hat.
Häufige Fragen
Wie gebe ich Claude Code Zugriff auf mehrere Verzeichnisse?
In Claude Code selbst: --add-dir mit einem Pfad beim Start, /add-dir während einer Sitzung oder additionalDirectories in einer Einstellungsdatei für eine dauerhafte Liste. In AgentsRoom fügst du die Ordner einmal als verknüpfte Ordner des Projekts hinzu (Projekteinstellungen, Allgemein, Verknüpfte Ordner): Jeder Agent des Projekts mit Claude Code startet dann mit einem --add-dir für jeden von ihnen, genauso wie die Agenten der anderen CLIs, die das Flag haben.
Kann Codex über mehrere Repos hinweg arbeiten?
Ja. Codex startet in einem Workspace, --add-dir macht ein weiteres Verzeichnis daneben beschreibbar, und writable_roots in config.toml speichert eine dauerhafte Liste. AgentsRoom übergibt jedem Codex-Agenten des Projekts --add-dir für jeden verknüpften Ordner, auch wenn der Agent eine Sitzung fortsetzt, und sein Briefing sagt ihm, git aus jedem Repository heraus auszuführen.
Kann ein Projekt mehrere Git-Repositories umfassen?
Ja. Das Projekt behält seinen Hauptordner, in dem die Agenten starten, und verknüpft die anderen Repositories. Jedes behält seine eigene Versionskontrolle. Im Tab Änderungen wechselt das Repository-Auswahlfeld zwischen dem Projektordner und jedem verknüpften Repository, um dessen Diff zu lesen, es zu committen und zu pushen.
Werden meine Ordner verschoben, kopiert oder per Symlink verknüpft?
Nein. AgentsRoom speichert nur ihre Pfade und übergibt sie den Agenten beim Start. Auf der Festplatte ändert sich nichts, wenn du einen verknüpften Ordner hinzufügst oder entfernst.
Welche Agent-CLIs bekommen die verknüpften Ordner?
Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code und Mistral Vibe bekommen jeden Ordner über ihr eigenes Flag --add-dir. OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin und Cursor haben kein solches Flag: Sie finden die Ordner in ihrem Briefing und öffnen sie über den vollständigen Pfad, wenn ihre Sandbox es zulässt.
Liest der Agent die CLAUDE.md eines verknüpften Ordners?
Standardmäßig nicht. Claude Code lädt die Skills, Befehle und Subagents eines per --add-dir übergebenen Verzeichnisses, dessen CLAUDE.md aber nur, wenn CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 gesetzt ist, und AgentsRoom setzt es nicht für dich. Was jeder Agent bekommt, ist das Briefing: wo jeder verknüpfte Ordner liegt, dass er zum Projekt gehört und dass er seine eigene Versionskontrolle behält.
Gelten Worktrees und automatischer Commit auch für die verknüpften Ordner?
Nein, sie bleiben beim Projektordner: ein Worktree pro Ticket, automatische Commits, wenn ein Ticket erledigt ist, und die Diffs der Team-Schritte. In einem verknüpften Ordner prüfst und committest du von Hand im Tab Änderungen.
Folgen mir verknüpfte Ordner auf meine anderen Computer?
Nein. Die Liste wird auf dem Computer gespeichert, auf dem du sie angelegt hast, weil ein Ordnerpfad nur dort existiert. Agenten, die per SSH auf einem Remote-Server gestartet werden, bekommen die Ordner ebenfalls nicht. Der Rest des Projekts, seine Agenten, sein Backlog und seine Einstellungen, folgt deinem Konto wie gewohnt.
Funktioniert das unter Windows und Linux?
Ja, unter macOS, Windows und Linux. Unter Windows werden Laufwerksbuchstaben und beide Arten von Schrägstrichen verstanden, und jedes --add-dir wird für PowerShell in Anführungszeichen gesetzt.
Das könnte dich auch interessieren
Multi-Projekt · Multi-Agent · Parallel
AgentsRoom betreibt mehrere KI-Agenten von Claude, Codex, GitHub Copilot CLI, Cursor und 10 weiteren Agent-CLIs parallel über mehrere Projekte hinweg, alles in einem einzigen Fenster. Farbcodierte Rollen, Live-Status, Zähler pro Projekt, native Desktop- und Mobile-Benachrichtigungen. Die visuelle Alternative zu 12 Terminal-Tabs und dem Chaos verstreuter Claude-Code-Sessions in iTerm2, Warp und tmux.
Git-Worktrees
Gib jedem KI-Agenten oder Ticket einen eigenen Git-Worktree, bereit zum Bauen (Abhängigkeiten installiert, .env kopiert), dann prüfe, committe und merge ihn in einem einzigen Fenster.
Review pro Agent
Prüfen Sie Code-Änderungen jedes KI-Agenten einzeln. AgentsRoom verfolgt, welcher Claude Code Agent welche Dateien geändert hat. Filtern Sie Diffs nach Agent, prüfen Sie einzeln, committen Sie pro Agent für eine saubere Git-Historie.
Multi-Provider
AgentsRoom unterstützt 14 KI-Coding-Provider: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin und Cursor. Weisen Sie jedem Agenten einen anderen Provider zu, wechseln Sie mitten im Gespräch und behalten Sie den vollen Kontext mit automatischem Handoff. Das beste Multi-Provider-Tool fürs KI-Coding.
SSH-Verbindungen
Speichere deine SSH-Verbindungen, öffne ein integriertes Terminal über SSH und starte Claude Code, Codex oder Antigravity CLI direkt auf deinem Remote-Server oder VPS. Authentifizierung per SSH-Schlüssel oder Passwort, Verbindungsprofile pro Projekt, kein separater SSH-Client nötig.
Gib deinen Agenten das ganze Projekt
Lade AgentsRoom herunter, öffne dein Haupt-Repository als Projekt und verknüpfe die anderen unter Projekteinstellungen, Allgemein, Verknüpfte Ordner.
Companion-App: Agenten auch unterwegs im Blick behalten
Nutzen Sie Claude, Codex, Antigravity CLI oder einen anderen KI-Anbieter.
Bugs und Wünsche direkt in dein öffentliches Backlog schicken.