Skip to content
BENIBIX Learn

--teammate-mode Flag

Also known as claude --teammate-mode, teammateMode

It sets how agent team members show on your screen.

Think of it like

It is like you say if your team sits at one big table. Or each kid gets a room.

Example

Jack runs a team of three teammates and wants to watch each one work. He starts with --teammate-mode tmux, and each gets its own pane.

Why it matters

Seeing each teammate's work side by side makes it easy to spot one that is stuck.

Definition

--teammate-mode sets how the teammates in an agent team show up on your screen. in-process, the default, keeps them all in your one terminal. tmux and iterm2 give each teammate its own pane. auto picks one for you. The flag wins over the teammateMode setting, for this session only.

Example code

bash
claude --teammate-mode tmux
Give each teammate its own pane.
--teammate-mode picks how these teammates are laid out on the screen.

Common mistake

Thinking it changes what teammates do. It only changes how they are shown.

Key takeaways

  1. 1
    in-process. One terminal, the default.
  2. 2
    tmux or iterm2. A pane each.
  3. 3
    This session only. Beats the setting.

Learn it properly