Agent Teams - Claude Code
Coordinate multiple Claude Code instances with a shared task list.
Agent Teams is the experimental multi-agent mode where several Claude Code instances work together with a shared task list and shared state.
What it does
A team has a lead (coordinator) and teammates (workers). The lead decomposes the job, assigns tasks, and synthesizes results. Teammates claim tasks, work in parallel, and communicate directly when needed. You see their work in panes if you like. It's designed for jobs that genuinely benefit from parallelism - audits, broad refactors, large research.
When to use it
- Tasks with many independent subtasks that can run in parallel.
- Codebase-wide audits or refactors.
- Research spanning many files or sources.
- Any time sequential delegation would waste wall-clock time.
Gotchas
- Agent Teams is experimental. Expect rough edges and breaking changes.
- More agents means more cost. Measure the speedup versus the bill.
- Coordination overhead can swamp the benefit on small jobs. Use for genuinely parallel work.
Official docs: https://code.claude.com/docs/en/agent-teams.md
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Newsletter
Get the weekly deep dive
Tutorials on Claude Code, AI agents, and dev tools, delivered free every week.
Was this helpful?
Related Guides
Related Tools
Claude Code
Anthropic's agentic coding CLI. Runs in your terminal, edits files autonomously, spawns sub-agents, and maintains memory...
View Tool
Claude Opus 4.7
Anthropic's flagship reasoning model. Best-in-class for coding, long-context analysis, and agentic workflows. 1M token c...
View Tool
Conductor
Mac app for running parallel Claude Code, Codex, and Cursor agents in isolated workspaces. Watch every agent work at onc...
View ToolAgentCanvas
A hosted infinite canvas your headless AI agents drive over MCP. Any MCP-speaking agent - Claude Code, Codex, Cursor, or...
View ToolRelated Videos
Zed: The Open Source Agentic IDE - Use Claude Code, Codex & Gemini CLI in one place
Check out Zed here! https://zed.dev In this video, we dive into Zed, a robust open source code editor that has recently introduced the Agent Client Protocol. This new open standard allows...
Claude Code NEW Sub Agents in 7 Minutes
Leveraging Anthropic's Subagent for Claude Code: A Step-by-Step Guide In this video, we explore Anthropic's newly released subagent feature for Cloud Code, which allows developers to create...
Open Design: Turn Websites into Design Assets for Cursor & Claude Code
Open Design: Open-Source n8n App That Turns Any Website into a Brand Kit, Design System, HTML + Images The video introduces Open Design, an MIT-licensed full-stack template that combines AI and n8n a
Related Posts
Claude Outages Are a Workflow Design Problem
Claude outages and 529 overloads expose whether your AI coding workflow has checkpoints, receipts, model-switch paths, a...
Claude Opus 4.8 Is an Agent Honesty Release
Claude Opus 4.8 looks like a benchmark bump, but the developer story is better honesty, dynamic workflows, and effort co...
Anthropic Sonnet 4.5 in Claude Code
Anthropic's Claude Sonnet 4.5 isn't just another model increment. The company claims they've observed it maintaining foc...
Clean Code Makes AI Agents 34% More Efficient - New Research
A controlled study of 660 Claude Code trials shows clean codebases reduce token usage by 7-8% and file revisitations by...
Does Code Cleanliness Affect AI Coding Agents?
A new SonarSource study finds clean code doesn't boost agent pass rates - but it cuts token usage by 8% and file revisit...
Safari MCP Server Developer Guide 2026
Apple's Safari MCP server lets AI coding agents inspect pages, capture screenshots, evaluate JavaScript, and run accessi...
