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

-   Crée un shim tmux dans le répertoire temporaire de shims de la surface actuelle. Son chemin contient l’UUID de la surface et change pour chaque panneau et à chaque démarrage ; aucun chemin fixe ne peut donc être indiqué
-   Définit TMUX et TMUX\_PANE pour simuler tmux dans la session de lancement de 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

Le shim ne route vers cmux que lorsque `CMUX_CLAUDE_TEAMS_CMUX_BIN` est défini ; sinon, il transmet de manière transparente vers le prochain exécutable tmux réel. Ainsi, `which tmux` ne permet pas de savoir si l’interception de Claude Teams est active.

## Environment variables

| Variable | Purpose |
| --- | --- |
| `TMUX` | Chemin synthétique du socket tmux pour la session qui a exécuté cmux claude-teams |
| `TMUX_PANE` | Identifiant synthétique de panneau tmux pour la session qui a exécuté cmux claude-teams ; vide dans les panneaux d’agent créés |
| `CMUX_SURFACE_ID` | L’UUID de la surface actuelle ; utilisez-le comme identifiant de surface dans un panneau d’agent créé |
| `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 |

Les valeurs synthétiques `TMUX`, `TMUX_PANE` et les valeurs de compatibilité tmux associées décrivent la session qui a exécuté `cmux claude-teams`, et non les panneaux créés. Depuis un panneau d’agent, utilisez `CMUX_SURFACE_ID` et exécutez `cmux tree --json` ; l’objet `caller` de la sortie identifie le panneau appelant.

## Directories

| Path | Purpose |
| --- | --- |
| Répertoire propre à chaque surface dans le répertoire temporaire du système (aucun chemin fixe) | Contient le shim tmux actif et est ajouté au début de PATH pour cette surface |
| `~/.cmuxterm/tmux-compat-store.json` | Stockage persistant des buffers et hooks tmux-compat, ainsi que de l’état de placement/disposition des splits |

Les clés de routage des divisions sont :

-   `lastSplitSurface` — Associe chaque UUID d’espace de travail à l’UUID de la surface créée par la dernière division. Il initialise l’ancre de la colonne des agents qui détermine où se place la prochaine division main-vertical.
-   `mainVerticalLayouts` — Associe chaque UUID d’espace de travail à `mainSurfaceId` (la surface principale ou leader) et à `lastColumnSurfaceId` (la surface la plus basse de la colonne des agents). Les divisions suivantes des coéquipiers ciblent cette colonne et s’empilent vers le bas.

Examinez ces clés de routage lorsqu’un panneau de coéquipier apparaît comme un onglet derrière une surface existante au lieu d’une division à côté de celle-ci.

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

Canonical: https://cmux.com/fr/docs/agent-integrations/claude-code-teams

Documentation index: https://cmux.com/llms.txt