Parallel Waters

A field guide for people who explain Claude Code

Where should this work flow?

Claude Code can put more than one Claude to work at once — but "run agents in parallel" is really four different features, and the right one depends on the shape of the work. This guide routes you by the question you're actually asking, not by feature name.

First, the picture

Think of a Claude Code session as a river: one channel with finite capacity — everything Claude reads flows through it, and the channel is only as big as the session's working memory. Every parallel-work feature is a different way of adding channels:

Two tools support all of the above without running agents: worktrees (levees — separate copies of the code so parallel work never floods the same files) and cross-session messaging (signals — one session passing a finding to another).

Navigation chartwhere should this work flow?NYour taskheadwatersWork deliveredthe mouthWould the side work drownyour conversation?Several independent tasksto hand off?Do the workers need totalk to each other?Bigger than oneconversation can hold?Subagentsside channel — rejoinswith the answerAgent viewthe braids — many channels,watched from the bankAgent teamstwin channels, one crew⚑ experimental · off by defaultWorkflowsthe canal — engineered,rerunnablelevees ·worktreessignals · cross-sessionmessagingscale · one context window
The chart is a picture of the routing table below it — every landing is a link.

The routing questions

Start from your situation; the feature is the answer.

ROUTE 01"Part of this job would drown my conversation."

Test runs, log digs, doc fetches — side work that produces pages you'll never look at again. A subagent does it in its own memory and returns only the summary, so your conversation stays clear.

Subagents — deep dive →

ROUTE 02"I have several independent tasks and don't want to babysit them."

Hand each off as its own background session and watch them all from one screen. Agent view (opened with claude agents) shows what's running, what's done, and which session needs you. In research preview.

Agent view — official docs →

ROUTE 03"The parallel workers need to talk to each other."

Reviewers with different lenses, investigators testing rival theories — agent teams give you a lead session plus teammates that share a task list and message each other. Experimental and off by default.

Agent teams — official docs →

ROUTE 04"This job is bigger than one conversation can coordinate."

A 500-file migration, a whole-codebase audit, research worth cross-checking. A dynamic workflow moves the plan into a script that runs dozens to hundreds of workers in the background — and can verify their findings against each other.

Dynamic workflows — deep dive →

ROUTE 05"Won't the parallel pieces collide in the same files?"

Not if you separate them. A worktree gives each session or subagent its own copy of the code. Agent view does this automatically; agent teams don't — there, each teammate owns different files.

Worktrees — official docs →

ROUTE 06"One of my sessions knows something another one needs."

Cross-session messaging lets one session pass a finding, a status, or a warning to another — instead of you re-explaining it in the other terminal.

Cross-session messaging — official docs →

ROUTE 07"What is all of this going to cost?"

More Claudes means more usage — every approach multiplies it, against the same plan limits. The honest comparison is relative, not absolute.

Cost notes ↓

The approaches, side by side

Chart No. 1 — Four ways to add channels

condensed from the official comparison table
ApproachWhat it gives youReach for it whenWho steers
SubagentsHelpers inside one session that do a side task privately and return a summaryA side task would flood your conversation with output you won't rereadClaude, inside one conversation
Agent viewOne screen to dispatch and monitor background sessions. Research previewSeveral independent tasks you want to hand off and check at a glanceYou — hand off, check back later
Agent teamsCoordinated sessions with a shared task list and messaging, managed by a lead. Experimental, off by defaultYou want Claude to split a project, assign pieces, and keep workers in syncA lead Claude session
Dynamic workflowsA rerunnable script, written by Claude, that runs many workers and can cross-check their resultsA job outgrows a handful of helpers, or findings need verifyingA script holds the plan

To see the difference in practice, One task, three ways runs the same PR review three ways — with where each one breaks down.

The supporting tools

Neither runs agents. They keep the channels from interfering.

Worktrees — levees

A separate working copy of the code per session or helper, so parallel edits never collide. Needs a git repository.

Official docs →
Cross-session messaging — signals

Sessions pass short text messages — never files or history — and a message can't approve anything or change the receiving session's settings.

Official docs →

What it costs, honestly

Running several Claudes at once multiplies usage, against the same plan limits — the docs' own example: ten parallel sessions use quota roughly ten times as fast as one. The relative ordering they support:

The docs publish no per-approach dollar figures, so neither do we. Their budget-level number — roughly $13 per developer per active day, enterprise average — covers all Claude Code use, not any one approach.