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

Geçerli yüzeyin geçici shim dizininde bir tmux shim'i oluşturur. Yol, yüzey UUID'sini içerir ve her panelde ve her önyüklemede değişir; bu nedenle sabit bir yol verilemez
Claude Teams başlatma oturumunda tmux'u simüle etmek için TMUX ve TMUX_PANE'i ayarlar
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 yalnızca CMUX_CLAUDE_TEAMS_CMUX_BIN ayarlandığında cmux'a yönlendirir; aksi halde bir sonraki gerçek tmux çalıştırılabilirine şeffaf biçimde geçer. Bu nedenle which tmux Claude Teams yakalamasının etkin olup olmadığını göstermez.

#Environment variables

Variable	Purpose
`TMUX`	cmux claude-teams komutunu çalıştıran oturum için sentetik tmux soket yolu
`TMUX_PANE`	cmux claude-teams komutunu çalıştıran oturum için sentetik tmux bölme tanımlayıcısı; oluşturulan ajan panellerinde boştur
`CMUX_SURFACE_ID`	Geçerli yüzeyin UUID'si; oluşturulan bir ajan panelinde bu değeri yüzey tanımlayıcısı olarak kullanın
`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

Sentetik TMUX, TMUX_PANE ve ilgili tmux uyumluluk değerleri, oluşturulan panelleri değil cmux claude-teams komutunu çalıştıran oturumu açıklar. Bir ajan panelinden CMUX_SURFACE_ID kullanın ve cmux tree --json çalıştırın; çıktının caller nesnesi çağıran paneli tanımlar.

#Directories

Path	Purpose
Sistemin geçici dizini altında yüzey başına dizin (sabit yol yok)	Etkin tmux shim'ini içerir ve o yüzey için PATH'in başına eklenir
`~/.cmuxterm/tmux-compat-store.json`	tmux-compat arabellekleri, kancaları ve bölme yerleşimi/düzeni durumu için kalıcı depolama

Bölme yönlendirme anahtarları şunlardır:

lastSplitSurface — Her çalışma alanı UUID'sini son bölmenin oluşturduğu yüzey UUID'sine eşler. Bir sonraki main-vertical bölmenin nereye yerleşeceğini belirleyen ajan sütunu dayanağını başlatır.
mainVerticalLayouts — Her çalışma alanı UUID'sini mainSurfaceId (ana veya lider yüzey) ve lastColumnSurfaceId (ajan sütunundaki en alt yüzey) ile eşler. Sonraki takım arkadaşı bölmeleri bu sütunu hedefler ve aşağı doğru yığılır.

Bir takım arkadaşı paneli mevcut bir yüzeyin yanında bölme olarak değil arkasında sekme olarak göründüğünde bu yönlendirme anahtarlarını inceleyin.

#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