#Claude Code Teams

cmux claude-teams запускає Claude Code з увімкненими командами агентів. Коли Claude створює агентів-напарників, вони з'являються як нативні розділення cmux замість панелей tmux з повними метаданими бічної панелі та сповіщеннями.

#Використання

cmux claude-teams
cmux claude-teams --continue
cmux claude-teams --model sonnet

Усі аргументи після claude-teams передаються до Claude Code. Команда за замовчуванням встановлює режим напарників на auto та налаштовує середовище для використання розділень cmux.

#Як це працює

cmux claude-teams створює скрипт-прокладку tmux та налаштовує середовище так, що Claude Code думає, що працює всередині tmux. Коли Claude видає команди tmux для керування панелями напарників, прокладка перетворює їх у виклики socket API cmux.

Створює прокладку tmux у тимчасовому каталозі прокладок поточної поверхні. Шлях містить UUID поверхні й змінюється для кожної панелі та кожного завантаження системи, тому вказати фіксований шлях неможливо
Встановлює TMUX і TMUX_PANE для імітації tmux у сесії запуску Claude Teams
Додає директорію прокладки на початок PATH, щоб Claude знайшов прокладку раніше справжнього tmux
Вмикає CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 та встановлює режим напарників на auto

Прокладка спрямовує виклики до cmux лише тоді, коли встановлено CMUX_CLAUDE_TEAMS_CMUX_BIN; інакше вона прозоро передає їх наступному справжньому виконуваному файлу tmux. Тому which tmux не показує, чи активне перехоплення Claude Teams.

#Змінні середовища

Змінна	Призначення
`TMUX`	Синтетичний шлях до сокету tmux для сесії, у якій виконано cmux claude-teams
`TMUX_PANE`	Синтетичний ідентифікатор панелі tmux для сесії, у якій виконано cmux claude-teams; порожній у створених панелях агентів
`CMUX_SURFACE_ID`	UUID поточної поверхні; використовуйте його як ідентифікатор поверхні всередині створеної панелі агента
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Вмикає функцію команд агентів Claude Code
`CMUX_SOCKET_PATH`	Шлях до контрольного сокету cmux для підключення прокладки

Синтетичні TMUX, TMUX_PANE і пов’язані значення сумісності з tmux описують сесію, у якій виконано cmux claude-teams, а не створені панелі. Усередині панелі агента використовуйте CMUX_SURFACE_ID і виконайте cmux tree --json; об’єкт caller у виводі ідентифікує панель, з якої викликано команду.

#Директорії

Шлях	Призначення
Каталог для кожної поверхні в системному тимчасовому каталозі (без фіксованого шляху)	Містить активну прокладку tmux і додається на початок PATH для цієї поверхні
`~/.cmuxterm/tmux-compat-store.json`	Постійне сховище буферів, хуків і стану розміщення та компонування розділень tmux-compat

Ключі маршрутизації розділень:

lastSplitSurface — Зіставляє UUID кожного робочого простору з UUID поверхні, створеної останнім розділенням. Ініціалізує прив’язку колонки агентів, яка визначає розташування наступного розділення main-vertical.
mainVerticalLayouts — Зіставляє UUID кожного робочого простору з mainSurfaceId (головною поверхнею або поверхнею-лідером) і lastColumnSurfaceId (найнижчою поверхнею в колонці агентів). Наступні розділення напарників спрямовуються в цю колонку й додаються вниз.

Перевіряйте ці ключі маршрутизації, якщо панель напарника з’являється як вкладка позаду наявної поверхні, а не як розділення поруч із нею.

#Підтримувані команди tmux

Прокладка перетворює ці команди tmux в операції cmux:

new-session, new-window → створює новий робочий простір cmux
split-window → розділяє поточну панель cmux
send-keys → надсилає текст на поверхню cmux
capture-pane → зчитує текст терміналу з поверхні cmux
select-pane, select-window → фокусує панель або робочий простір cmux
kill-pane, kill-window → закриває поверхню або робочий простір cmux
list-panes, list-windows → перелічує панелі або робочі простори cmux