# --teammate-mode Flag

> It sets how agent team members show on your screen.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** claude --teammate-mode, teammateMode

## Think of it like

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

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

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.

## Example code

```bash
claude --teammate-mode tmux
```

Give each teammate its own pane.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [Agent Teams](https://learn.benibix.com/term/ai/agent-teams)
- [--tmux Flag](https://learn.benibix.com/term/ai/tmux-flag)

## Taught in

- [Cloud and Server Commands](https://learn.benibix.com/learn/ai-claude-code-commands/cloud-and-server-commands): Claude Code Commands, 17/17

![A team lead and three teammates share one task list, and the teammates can message each other.](https://learn.benibix.com/diagrams/cc-agent-teams.svg)

---

Source: https://learn.benibix.com/term/ai/teammate-mode-flag
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
