#Claude Code Teams

cmux claude-teams launches Claude Code with agent teams enabled. When Claude spawns teammate agents, they appear as native cmux splits instead of tmux panes, with full sidebar metadata and notifications.

#Usage

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

All arguments after claude-teams are forwarded to Claude Code. The command defaults teammate mode to auto and sets the environment so Claude uses cmux splits.

#How it works

cmux claude-teams creates a tmux shim script and configures the environment so Claude Code thinks it's running inside tmux. When Claude issues tmux commands to manage teammate panes, the shim translates them into cmux socket API calls.

Erstellt einen tmux-Shim im temporären Shim-Verzeichnis der aktuellen Oberfläche. Der Pfad enthält die Oberflächen-UUID und ändert sich pro Panel und bei jedem Systemstart, sodass kein fester Pfad angegeben werden kann
Setzt TMUX und TMUX_PANE, um tmux für die Claude-Teams-Startsitzung zu simulieren
Prepends the shim directory to PATH so Claude finds the shim before real tmux
Enables CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 and sets teammate mode to auto

Der Shim leitet nur dann an cmux weiter, wenn CMUX_CLAUDE_TEAMS_CMUX_BIN gesetzt ist; andernfalls fällt er transparent auf die nächste echte tmux-Datei zurück. Deshalb zeigt which tmux nicht, ob die Claude-Teams-Übernahme aktiv ist.

#Environment variables

Variable	Purpose
`TMUX`	Synthetischer tmux-Socket-Pfad für die Sitzung, in der cmux claude-teams ausgeführt wurde
`TMUX_PANE`	Synthetische tmux-Panelkennung für die Sitzung, in der cmux claude-teams ausgeführt wurde; in erzeugten Agent-Panels leer
`CMUX_SURFACE_ID`	Die UUID der aktuellen Oberfläche; verwenden Sie sie in einem erzeugten Agent-Panel als Oberflächenkennung
`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS`	Enables Claude Code agent teams feature
`CMUX_SOCKET_PATH`	Path to the cmux control socket for the shim to connect to

Die synthetischen Werte TMUX, TMUX_PANE und die zugehörigen tmux-Kompatibilitätswerte beschreiben die Sitzung, in der cmux claude-teams ausgeführt wurde, nicht die erzeugten Panels. Verwenden Sie in einem Agent-Panel CMUX_SURFACE_ID und führen Sie cmux tree --json aus; das caller-Objekt in der Ausgabe identifiziert das aufrufende Panel.

#Directories

Path	Purpose
Verzeichnis pro Oberfläche im temporären Systemverzeichnis (kein fester Pfad)	Enthält den aktiven tmux-Shim und wird für diese Oberfläche dem PATH vorangestellt
`~/.cmuxterm/tmux-compat-store.json`	Dauerhafter Speicher für tmux-compat-Puffer, Hooks sowie den Zustand der Split-Platzierung und des Layouts

Die Schlüssel für das Split-Routing sind:

lastSplitSurface — Ordnet jede Workspace-UUID der Surface-UUID zu, die durch den letzten Split erstellt wurde. Sie liefert den Startwert für den Agenten-Spaltenanker, der bestimmt, wo der nächste main-vertical-Split landet.
mainVerticalLayouts — Ordnet jede Workspace-UUID mainSurfaceId (der Haupt- oder Leader-Oberfläche) und lastColumnSurfaceId (der untersten Oberfläche in der Agentenspalte) zu. Nachfolgende Teammate-Splits zielen auf diese Spalte und werden nach unten gestapelt.

Prüfen Sie diese Routing-Schlüssel, wenn ein Teammate-Panel als Tab hinter einer vorhandenen Oberfläche statt als Split daneben erscheint.

#Supported tmux commands

The shim translates these tmux commands into cmux operations:

new-session, new-window → creates a new cmux workspace
split-window → splits the current cmux pane
send-keys → sends text to a cmux surface
capture-pane → reads terminal text from a cmux surface
select-pane, select-window → focuses a cmux pane or workspace
kill-pane, kill-window → closes a cmux surface or workspace
list-panes, list-windows → lists cmux panes or workspaces