Связанные папки

Несколько директорий, один проект
для каждого запущенного ИИ-агента

Игра в одной папке и её порт на более новую версию движка в другой. Веб-приложение и API, который оно вызывает, в двух репозиториях. Общая библиотека рядом с приложениями, которые её используют. Вашим агентам нужны обе стороны, а перенос папок под общего родителя сломал бы работающую организацию.

Вместо этого свяжите другие папки с проектом. Они остаются на своих местах и сохраняют собственную систему контроля версий. Каждый агент, запущенный в проекте, получает их: через --add-dir в Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code и Mistral Vibe, и в своём брифе для остальных CLI. Затем вкладка «Изменения» позволяет проверить и закоммитить каждый репозиторий.

Один проект, три репозитория
  • /work/web-appПапка проекта · git
  • /work/apiСвязанная папка · git
  • /work/shared-libСвязанная папка · git
При запуске
Claude Code--add-dir=/work/api --add-dir=/work/shared-lib
Codex--add-dir=/work/api --add-dir=/work/shared-lib
GitHub Copilot CLI--add-dir=/work/api --add-dir=/work/shared-lib
OpenCodeпапки перечислены в его брифе

Один проект, три репозитория: каждый агент запускается в папке проекта и получает две другие в том виде, который понимает его CLI.

Агент запускается в одной папке, и большинство CLI его там и держат. Читать вокруг он часто может, но правка за пределами рабочей директории означает запрос разрешения, отказ песочницы или флаг, который нужно помнить при каждом запуске. Это работает, пока задача не охватывает два места: приложение и его API, игру и её копию на более новом движке, библиотеку и проекты, которые её используют.

У привычных решений есть цена. Перенос обеих папок под общего родителя ломает пути, скрипты и настройки редактора, которые работали. Символическая ссылка сбивает с толку некоторые инструменты и скрывает, где на самом деле лежат файлы. Вводить --add-dir при каждом запуске можно, пока однажды вы его не забудете.

Связанные папки: это список, который хранится в проекте. Вы добавляете папку один раз в «Настройки проекта», «Общие», «Связанные папки». С этого момента каждый агент проекта, запущен ли он из списка агентов, из тикета бэклога или с телефона, получает эти папки, а у каждой папки остаётся свой репозиторий.

Что делают связанные папки

Список в проекте, который читается при каждом запуске. Проект без связанных папок работает точно так же, как раньше.

Папки остаются на своих местах

Выберите папку в системном окне выбора папки. Ничего не перемещается, не копируется и не заменяется символической ссылкой, и у каждой папки остаются свой репозиторий, своя ветка и своя история. До десяти папок на проект.

Нужный флаг для каждого CLI

Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code и Mistral Vibe получают каждую папку через собственный флаг --add-dir, и при новом запуске агента, и при возобновлении сессии.

Названы в брифе агента

Каждый агент, какой бы CLI у него ни был, также получает короткий блок в своём брифе: список папок, то, что они относятся к проекту, и то, что git запускается изнутри каждой из них. CLI без флага добираются до них по полному пути, если это позволяет их песочница.

Коммит каждого репозитория

На вкладке «Изменения» выбор репозитория показывает папку проекта и каждую связанную папку, которая является git-репозиторием. Выберите одну, чтобы увидеть её diff, затем добавьте изменения в индекс, закоммитьте и запушьте.

То же самое на телефоне

Агент, запущенный из мобильного приложения AgentsRoom, получает те же флаги и тот же бриф, потому что запуск готовит компьютер. Телефон показывает связанные папки в меню проекта, а его экран «Изменения» тоже предлагает связанные репозитории.

Проверка при запуске

Папка, которой нет на диске, например на отключённом накопителе, остаётся в списке с предупреждением и пропускается при запуске, с одной строкой в терминале. Сама папка проекта и дубликаты не принимаются.

Настройки проекта AgentsRoom, «Общие», «Связанные папки»: две папки, связанные с проектом my-shop, my-shop-api и shared-ui, кнопка «Добавить папку» и пометка о том, что Claude Code, Codex, Copilot, Antigravity, Kimi и Mistral Vibe получают их при запуске
Карточка «Связанные папки» в настройках проекта, раздел «Общие»: два репозитория, связанные с проектом, каждый остаётся на своём месте. Пометка под списком говорит, какие CLI получают их через флаг и как до них добираются остальные.

Как это работает

Четыре шага, и первые два выполняются один раз на проект.

  1. 1

    Откройте настройки проекта

    «Настройки проекта», «Общие», «Связанные папки». Поле показывает, какие CLI получают папки через флаг и как до них добираются остальные.

  2. 2

    Добавьте папку

    «Добавить папку» открывает системное окно выбора папки, и папка сразу сохраняется. Крестик рядом с ней позже убирает её из проекта: на диске ничего не меняется.

  3. 3

    Запустите агента

    Запустите любого агента проекта как обычно: из списка агентов, из тикета бэклога или с телефона. Он запускается в папке проекта и получает также связанные папки.

  4. 4

    Проверьте и закоммитьте каждый репозиторий

    Откройте вкладку «Изменения» и выберите репозиторий: папку проекта или связанную папку. Прочитайте её diff, затем добавьте изменения в индекс, закоммитьте и запушьте прямо там. У каждой папки остаётся своя история.

Вкладка «Изменения» в AgentsRoom: в выборе репозитория стоит my-shop-api (связанная папка), уведомление «Связанная папка», ветка main с 2 изменениями и два изменённых файла products.ts и shipping.ts
Вкладка «Изменения» на связанном репозитории: выберите его в списке репозиториев, и ветка, изменения и кнопка коммита будут его собственными. Автокоммит и worktree на тикет остаются за папкой проекта.

Claude Code и Codex уже умеют добавлять директорию. Вот что меняется

Claude Code принимает --add-dir при запуске и /add-dir во время сессии, а постоянный список хранит в additionalDirectories своих файлов настроек. Добавленная директория получает доступ к файлам по тем же правилам разрешений, что и рабочая директория. Из директории, переданной через --add-dir или /add-dir, он также загружает навыки, команды и субагенты, но не её CLAUDE.md, если не задано CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1; директория, указанная в файле настроек, даёт только доступ к файлам. Проверено по документации Claude Code и на версии 2.1.300 в октябре 2026 года.

У Codex тоже есть --add-dir, который делает директорию доступной для записи рядом с основным рабочим пространством, а для постоянного списка есть writable_roots в разделе sandbox_workspace_write файла config.toml (codex-cli 0.162.1). У GitHub Copilot CLI, Antigravity CLI, Kimi Code и Mistral Vibe есть свой --add-dir.

Так что новое здесь не флаг. AgentsRoom добавляет список, который хранится в проекте и передаётся каждому агенту при каждом запуске в том виде, который ждёт каждый CLI (Claude Code нужен флаг и папка одним куском, как в --add-dir=/work/api, иначе опция проглатывает следующий за ней промпт), тот же бриф для CLI без флага, запуски с телефона, получающие те же папки, и вкладку «Изменения», которая коммитит каждый репозиторий. AgentsRoom не задаёт CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD за вас.

Что нужно знать

  • Автоматические коммиты по завершении тикета, worktree на тикет и diff шагов команды остаются за папкой проекта. В связанной папке вы проверяете и коммитите вручную.
  • Список сохраняется на каждом компьютере отдельно, потому что путь вроде D:\Games\UE5 ничего не значит на другой машине. Добавьте папки заново на других компьютерах.
  • Агент, запущенный на удалённом сервере по SSH, не получает связанные папки: это пути на этом компьютере. Об этом сообщает строка в его терминале.
  • У OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin и Cursor нет флага для дополнительной директории. Их агенты находят папки в своём брифе и добираются до них по полному пути, только если это позволяет их собственная песочница.
  • Телефон показывает список, но не редактирует его: папка выбирается в окне выбора папки на компьютере.
  • Не более десяти папок на проект, потому что у команды запуска в Windows есть ограничение длины.

Частые вопросы

Как дать Claude Code доступ к нескольким директориям?

В самом Claude Code: --add-dir с путём при запуске, /add-dir во время сессии или additionalDirectories в файле настроек для постоянного списка. В AgentsRoom добавьте папки один раз как связанные папки проекта («Настройки проекта», «Общие», «Связанные папки»): тогда каждый агент Claude Code в проекте запускается с --add-dir для каждой из них, как и агенты других CLI, у которых есть этот флаг.

Может ли Codex работать с несколькими репозиториями?

Да. Codex запускается в одном рабочем пространстве, --add-dir делает рядом с ним доступной для записи другую директорию, а writable_roots в config.toml хранит постоянный список. AgentsRoom передаёт --add-dir каждому агенту Codex в проекте для каждой связанной папки, в том числе когда агент возобновляет сессию, а его бриф велит запускать git изнутри каждого репозитория.

Может ли один проект включать несколько git-репозиториев?

Да. У проекта остаётся основная папка, в которой запускаются агенты, а остальные репозитории к ней привязываются. Каждый сохраняет собственную систему контроля версий. На вкладке «Изменения» выбор репозитория переключается между папкой проекта и каждым связанным репозиторием, чтобы прочитать его diff, закоммитить и запушить.

Мои папки перемещаются, копируются или заменяются символическими ссылками?

Нет. AgentsRoom только хранит их пути и передаёт их агентам при запуске. Когда вы добавляете или убираете связанную папку, на диске ничего не меняется.

Какие CLI агентов получают связанные папки?

Claude Code, Codex, GitHub Copilot CLI, Antigravity CLI, Kimi Code и Mistral Vibe получают каждую папку через собственный флаг --add-dir. У OpenCode, Aider, Grok Build, Amp, oh-my-pi, Freebuff, Devin и Cursor такого флага нет: они находят папки в своём брифе и открывают их по полному пути, если это позволяет их песочница.

Читает ли агент CLAUDE.md связанной папки?

По умолчанию нет. Claude Code загружает навыки, команды и субагенты директории, переданной через --add-dir, но её CLAUDE.md только если задано CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1, а AgentsRoom не задаёт его за вас. Зато каждый агент получает бриф: где находится каждая связанная папка, что она относится к проекту и что у неё своя система контроля версий.

Распространяются ли worktree и автокоммит на связанные папки?

Нет, они остаются за папкой проекта: worktree на тикет, автоматические коммиты по завершении тикета и diff шагов команды. В связанной папке проверяйте и коммитьте вручную на вкладке «Изменения».

Переходят ли связанные папки на мои другие компьютеры?

Нет. Список сохраняется на компьютере, где вы его составили, потому что путь к папке существует только там. Агенты, запущенные на удалённом сервере по SSH, тоже не получают эти папки. Остальное в проекте, его агенты, бэклог и настройки, как обычно следует за вашим аккаунтом.

Это работает в Windows и Linux?

Да, в macOS, Windows и Linux. В Windows понимаются буквы дисков и оба вида слешей, а каждый --add-dir заключается в кавычки для PowerShell.

Вам также может понравиться

Мультипроект · Мультиагент · Параллельно

AgentsRoom запускает несколько AI-агентов Claude, Codex, GitHub Copilot CLI, Cursor и 10 других CLI-агентов параллельно по нескольким проектам, всё в одном окне. Цветовые роли, живой статус, счётчики по проектам, нативные уведомления на десктопе и мобильном. Визуальная альтернатива 12 вкладкам терминала и хаосу сессий Claude Code, разбросанных по iTerm2, Warp и tmux.

Git worktree

Дайте каждому ИИ-агенту или тикету собственный git worktree, готовый к сборке (зависимости установлены, .env скопированы), затем проверяйте, коммитьте и вливайте его в одном окне.

Ревью по агентам

Просматривайте изменения кода каждого ИИ-агента отдельно. AgentsRoom отслеживает, какой агент Claude Code изменил какие файлы. Фильтруйте диффы по агенту, проверяйте индивидуально, коммитьте по агентам для чистой git-истории.

Мульти-провайдер

AgentsRoom поддерживает 14 AI-провайдеров для кодинга: Claude, Codex, GitHub Copilot CLI, OpenCode, Antigravity CLI, Aider, Grok Build, Mistral Vibe, Kimi Code, Amp, oh-my-pi, Freebuff, Devin и Cursor. Назначайте своего провайдера каждому агенту, переключайте провайдера посреди разговора и сохраняйте весь контекст с автоматическим хендоффом. Лучший мульти-провайдерный инструмент для AI-разработки.

SSH-подключения

Сохраняй свои SSH-подключения, открывай встроенный терминал по SSH и запускай Claude Code, Codex или Antigravity CLI прямо на удалённом сервере или VPS. Авторизация по SSH-ключу или паролю, профили подключений для каждого проекта, отдельный SSH-клиент не нужен.

Дайте агентам весь проект

Скачайте AgentsRoom, откройте основной репозиторий как проект и свяжите остальные в «Настройки проекта», «Общие», «Связанные папки».

БесплатноСкачать AgentsRoom

Приложение-компаньон: следите за агентами на ходу

Используйте Claude, Codex, Antigravity CLI или другого поставщика AI.

Установить расширение
Chrome Web Store

Отправляйте баги и запросы прямо в ваш публичный бэклог.

Мульти-проекты
Мульти-провайдер
Мульти-агенты
Статус онлайн
Diff и коммиты
Мобильное приложение
Live-превью
Команды агентов
Тесты в браузере
Разработка от backlog
Библиотека промптов
Библиотека навыков
Все функции