Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Subagents, agent view, agent teams, and worktrees each parallelize work in a different way. The right one depends on whether you want to stay in each conversation yourself, hand tasks off and check back later, or have Claude coordinate a group of workers for you.
ApproachWhat it gives youUse it when
SubagentsDelegated workers inside one session that do a side task in their own context and return a summaryA side task would flood your main conversation with search results, logs, or file contents you won’t reference again
Agent viewOne screen to dispatch and monitor sessions running in the background, opened with claude agents. Research previewYou have several independent tasks and want to hand them off, check status at a glance, and step in only when one needs you
Agent teamsMultiple coordinated sessions with a shared task list and inter-agent messaging, managed by a lead. Experimental and disabled by defaultYou want Claude to split a project into pieces, assign them, and keep the workers in sync
WorktreesSeparate git checkouts so parallel sessions never touch each other’s filesYou’re running several sessions yourself, or your subagents edit overlapping files
/batchA planned split of one large change into 5 to 30 worktree-isolated subagents that each open a pull requestA repo-wide migration or mechanical refactor you can describe in one instruction
In every approach the workers are Claude sessions. To involve a different tool, expose it to Claude as an MCP server. You can combine these approaches. Agent view automatically moves each dispatched session into its own worktree when it needs to edit files, and a session you’re working in can spawn subagents that each get their own worktree.
Running several sessions or subagents at once multiplies token usage. See Costs for usage and rate-limit details.

Choose an approach

The right approach depends on who coordinates the work, whether the workers need to communicate, and whether they edit the same files:
  • Who coordinates the work? If you want Claude to delegate and collect results inside one conversation, use subagents. If you’re handing off independent tasks and checking back on them, use agent view. If you want Claude to plan, assign, and supervise a group of workers, use agent teams, which are experimental and disabled by default.
  • Do the workers need to talk to each other? Subagents report results back to the conversation that spawned them, and agent view sessions report only to you. Teammates in an agent team share a task list and message each other directly.
  • Do the tasks touch the same files? Isolate the work with worktrees. Subagents and sessions you run yourself can each use a separate worktree. Agent teams don’t isolate teammates in worktrees, so partition the work so each teammate owns a different set of files.

Check on running work

The command for checking on running work depends on which approach you used:
  • For background sessions, claude agents opens agent view: one screen showing every session, its state, and which ones need your input.
  • For subagents in the current session, /agents opens a panel with a Running tab listing live subagents and a Library tab where you create and edit custom subagents. Despite the similar name, this is separate from claude agents.
  • For anything running in the background of the current session, /tasks lists each item and lets you check on, attach to, or stop it.
For a desktop view of all your sessions, see parallel sessions in the desktop app.

Learn more

Each guide below covers setup and configuration for one approach: