Claude Tips mascot
Claude Tips & Tricks
Claude Code intermediate

Use Claude Squad for Multi-Agent Sessions

Run multiple Claude Code agents in managed workspaces with Claude Squad, so each agent works on a separate task without stepping on the others.

Claude Squad manages multiple Claude Code instances, each in its own git worktree, with a single UI to monitor them all.

Install

go install github.com/smtg-ai/claude-squad@latest

Or via Homebrew:

brew install smtg-ai/tap/claude-squad

Basic Usage

# Launch with a managed TUI
claude-squad

# Create a new agent with a task
claude-squad new --task "Add user settings API endpoint"
claude-squad new --task "Write integration tests for auth"
claude-squad new --task "Update API docs"

Each agent gets its own worktree and context. You switch between them in the TUI.

Why Not Just tmux?

FeaturetmuxClaude Squad
Isolated git branchesManual setupAutomatic
Session monitoringTab between panesSingle dashboard
PR creationManualBuilt-in
Worktree cleanupManualAutomatic

When to Use

  • Working on 2-3 independent tasks simultaneously
  • Each task needs its own branch and isolated changes
  • You want to review and merge each task separately

Tip

Combine with the agent manager mindset. Give each agent a clear goal and constraints, then let them work while you review outputs in the dashboard.