#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.

Kreira tmux shim u privremenom shim direktoriju trenutne površine. Putanja sadrži UUID površine i mijenja se za svaki panel i pri svakom pokretanju sistema, pa se ne može navesti fiksna putanja
Postavlja TMUX i TMUX_PANE radi simuliranja tmuxa za sesiju pokretanja Claude Teams
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

Shim usmjerava na cmux samo kada je postavljen CMUX_CLAUDE_TEAMS_CMUX_BIN; u suprotnom transparentno prosljeđuje poziv sljedećoj stvarnoj tmux izvršnoj datoteci. Zato which tmux ne pokazuje da li je Claude Teams presretanje aktivno.

#Environment variables

Variable	Purpose
`TMUX`	Sintetička putanja tmux socketa za sesiju koja je pokrenula cmux claude-teams
`TMUX_PANE`	Sintetički identifikator tmux panela za sesiju koja je pokrenula cmux claude-teams; prazan je u novostvorenim agentskim panelima
`CMUX_SURFACE_ID`	UUID trenutne površine; koristite ga kao identifikator površine unutar kreiranog agentskog panela
`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

Sintetičke vrijednosti TMUX, TMUX_PANE i povezane tmux-kompatibilne vrijednosti opisuju sesiju u kojoj je pokrenut cmux claude-teams, a ne kreirane panele. Iz agentskog panela koristite CMUX_SURFACE_ID i pokrenite cmux tree --json; objekt caller u izlazu identificira panel koji je pozvao komandu.

#Directories

Path	Purpose
Direktorij za svaku površinu unutar sistemskog privremenog direktorija (nema fiksne putanje)	Sadrži aktivni tmux shim i dodaje se na početak PATH-a za tu površinu
`~/.cmuxterm/tmux-compat-store.json`	Trajna pohrana za tmux-compat buffere, hookove i stanje položaja/rasporeda podjela

Ključevi za rutiranje podjela su:

lastSplitSurface — Mapira UUID svakog radnog prostora na UUID površine kreirane posljednjom podjelom. Postavlja početno sidro kolone agenata koje određuje gdje će završiti sljedeća main-vertical podjela.
mainVerticalLayouts — Mapira UUID svakog radnog prostora na mainSurfaceId (glavnu ili vodeću površinu) i lastColumnSurfaceId (najnižu površinu u koloni agenata). Naredne teammate podjele ciljaju tu kolonu i slažu se prema dolje.

Provjerite ove ključeve rutiranja kada se teammate panel pojavi kao kartica iza postojeće površine umjesto kao podjela pored nje.

#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