Skip to content
BENIBIX Learn

Agent Teams

AI⌨️ Claude CodeClaude Code Concepts

Also known as Claude Code agent teams, Teammates, Team lead

Several Claude Code sessions that work as one team.

Think of it like

It is like a group project. Each kid does one part, and they pass notes to each other.

Example

Jack asks a team lead to rebuild his settings page. It gives the layout to one teammate and the tests to another, and they message each other as they go.

Why it matters

A big job can be split up. Each agent keeps a clear head, and no one agent holds it all.

Definition

Agent teams are several Claude Code sessions that work together, run by one team lead. They share a task list, and each teammate can send messages to the others. Each teammate has its own context window, and you can talk to any of them directly. That is the difference from subagents, which live inside one session and only report back to it. Agent teams are an early feature and are off by default. You turn them on with an environment variable.

Example code

bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Turn agent teams on before you start Claude Code.
A lead and teammates around one shared task list.

Common mistake

Using a team for a small task. Each teammate costs its own tokens, so a single session is cheaper for simple work.

Key takeaways

  1. 1
    Several sessions. One team lead.
  2. 2
    Shared task list. And messages.
  3. 3
    Off by default. An early feature.

Compare

Learn it properly