# Agent Teams

> Several Claude Code sessions that work as one team.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** Claude Code agent teams, Teammates, Team lead

## Think of it like

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

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

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.

## Example code

```bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
```

Turn agent teams on before you start Claude Code.

## Why it matters

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

## Common mistake

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

## Three principles

- **Several sessions.** One team lead.
- **Shared task list.** And messages.
- **Off by default.** An early feature.

## Related terms

- [Subagent](https://learn.benibix.com/term/ai/subagent)
- [Multi-Agent System](https://learn.benibix.com/term/ai/multi-agent-system)
- [Worktree Isolation](https://learn.benibix.com/term/ai/worktree-isolation)
- [Claude Code Session](https://learn.benibix.com/term/ai/claude-code-session)

## Told apart from

- [Subagents vs Agent Teams](https://learn.benibix.com/compare/subagent-vs-agent-teams): People often think agent teams are just more subagents. A subagent lives inside one session. It does one job in its own context and sends a summary back to the main agent, and you do not talk to it. Agent teams are separate sessions. They share a task list, message each other, and you can talk to each one directly.

## Taught in

- [Claude Code Subagents](https://learn.benibix.com/learn/ai-claude-code/claude-code-subagents): Claude Code, 15/16

![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/agent-teams
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-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
