Multiple full Claude sessions.Talking to each other.Self-coordinating.

Agent Teams - Multiple Claude Sessions Talking to Each Other

Multiple full Claude sessions.Talking to each other.Self-coordinating.

Subagents vs Agent Teams

These are not the same thing. Most people confuse them. Here is the difference that matters.

Subagents

• Fan-out from one parent session
• Return results only, no peer comms
• Parent decides, children execute
• Cheaper: lightweight spawned processes
• One-way: parent sends task, child returns result
• Good for parallelizable, independent tasks

Agent Teams

• Each teammate is a full Claude session
• Talk to each other directly (peer-to-peer)
• Self-coordinate through shared task list
• Can challenge, review, build on each other's work
• Higher cost: each teammate = full instance
• Good for complex, interdependent work

How to Enable Agent Teams

Agent teams require an experimental flag. This means the feature is functional but the API may change without warning in future releases.

What "experimental" means

How Agent Teams Actually Work

This is the mental model. You talk to the lead session. The lead assigns work to teammates. Teammates talk to each other. Everyone sees the shared task list.

Actual Prompts That Work

The key pattern: define each teammate's role, scope, and the lead's coordination responsibility. Be explicit about who does what.

Moving Between Teammates

Once your team is running, you need to know how to talk to each member and monitor their work.

The Task List

The shared task list is the coordination layer. It is visible to every teammate. It is how agents self-organize without constant human intervention.

Teams vs Subagents: When to Use Which

Click through the questions to get a recommendation.

What Agent Teams Actually Cost

No sugarcoating. Each teammate is a full Claude instance. A 4-person team costs roughly 4x what a single session costs. Here is when that is worth it.

5 Ready-to-Use Team Configurations

Copy, adapt to your codebase, run. Each is a complete prompt.

Quiz: Agent Teams

Want this running in your business, not just your terminal? Our Claude Code development agency ships it for you, or book a free consultation to scope your setup.

Day 24: Agent Swarms

Day 26: Best Prompts Directory