cmuxcmux
/docs
АгентиКоманди Claude Code
Агенти

Команди Claude Code

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 й налаштовує середовище так, щоб Claude використовував розділення 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_IDUUID поточної поверхні; використовуйте його як ідентифікатор поверхні всередині створеної панелі агента
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