Skip to content
BENIBIX Learn

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.

AI🤖 AI Agents

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.

Example
Jack's coding agent needs to know where logins are handled. It starts a subagent that reads 40 files and returns a five-line answer.
Why it matters
It stops long tasks from filling the main context with detail that is only needed once.
Full entry
AI⌨️ Claude Code

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.

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.
Full entry

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.