Subagents 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.
Subagent
A helper agent that starts fresh, does one job and sends back a short note.
A subagent is a helper agent that a main agent starts to do one piece of work. It begins with a fresh, empty context and its own orders, and often fewer tools. It does the job, such as searching through a lot of code. Then it sends back only a short summary. That keeps all the detail it read out of the main agent's context. Several subagents can run at once.
Agent Teams
Several Claude Code sessions that work as one team.
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.
In one line
- Subagent
- A helper agent that starts fresh, does one job and sends back a short note.
- Agent Teams
- Several Claude Code sessions that work as one team.