Answer: Agent teams are experimental and have several limitations, including no session resumption with in-process teammates, task status lag, slow shutdown, one team per session, no nested teams, no background subagents from in-process teammates, a fixed lead, no per-teammate permission modes at spawn, and split panes requiring tmux or iTerm2. Status: Confirmed Entry: tool/claude-code/agents-and-automation/agent-teams-limitations Revision: 1 Digest: sha256:8eeae08e27091e9b (changes whenever the content changes) Timeline: Created: 2026-11-13T03:03:11Z Last changed: 2026-11-13T03:03:11Z Last verified: 2026-11-20T12:17:51Z Next check: 2026-11-21T12:17:51Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of experimental status | experimental | [1] | 2026-11-20 session resumption | No session resumption with in-process teammates | [1] | 2026-11-20 task status | Task status can lag | [1] | 2026-11-20 shutdown | Shutdown can be slow | [1] | 2026-11-20 teams per session | One team per session | [1] | 2026-11-20 nested teams | No nested teams | [1] | 2026-11-20 lead | Lead is fixed | [1] | 2026-11-20 split panes | Split panes require tmux or iTerm2 | [1] | 2026-11-20 Sources: [1] Anthropic. "Orchestrate teams of Claude Code sessions". https://code.claude.com/docs/en/agent-teams.md Role: primary. Accessed: 2026-11-20T12:17:51Z Quote: "Agent teams are experimental." (Supports: experimental status) Quote: "**No session resumption with in-process teammates**: `/resume` and `/rewind` do not restore in-process teammates." (Supports: session resumption) Quote: "**Task status can lag**: teammates sometimes fail to mark tasks as completed, which blocks dependent tasks." (Supports: task status) Quote: "**Shutdown can be slow**: teammates finish their current request or tool call before shutting down, which can take time." (Supports: shutdown) Quote: "**One team per session**: a session has exactly one team, scoped to that session." (Supports: teams per session) Quote: "**No nested teams**: teammates cannot spawn their own teammates." (Supports: nested teams) Quote: "**Lead is fixed**: the main session is the lead for its lifetime." (Supports: lead) Quote: "**Split panes require tmux or iTerm2**: the default in-process mode works in any terminal." (Supports: split panes) Published: 2026-11-20T03:07:14Z Snapshot SHA-256: 385746eb7ee35908f790bba7d9d69a0613661e1af32a7de07d17f1376ac8e405 (captured 2026-11-18T12:13:32Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-18T12:13:34Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:17:51Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:17:51Z Last attempt: 2026-11-20T12:17:51Z Notes and limitations: Extracted automatically from a single official source (section "Limitations"). Related: https://latestn.com/tool/claude-code/agents-and-automation/allow-specific-skills How do I allow only specific skills in a Claude Agent SDK session? https://latestn.com/tool/claude-code/agents-and-automation/append-to-claude-code-preset How do I append extra instructions to the claude_code preset system prompt in Claude Code? https://latestn.com/tool/claude-code/agents-and-automation/ask-claude-to-write-mod How do I ask Claude to write a Claude Code mod for me? https://latestn.com/tool/claude-code/agents-and-automation/agent-sdk-capabilities What is the Claude Code Agent SDK and what can it do? https://latestn.com/tool/claude-code/agents-and-automation/agent-sdk-demo-applications Where can I find Claude Code Agent SDK demo applications I can clone? https://latestn.com/tool/claude-code/agents-and-automation/agent-sdk-vs-cli-client-sdk What is the difference between the Claude Code Agent SDK, the CLI, and the Client SDK? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-13T03:03:11Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/agents-and-automation/agent-teams-limitations/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/agents-and-automation/agent-teams-limitations POST: https://latestn.com/dispute/tool/claude-code/agents-and-automation/agent-teams-limitations with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/agents-and-automation/agent-teams-limitations?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). What are the limitations of Claude Code agent teams? Revision 1, last verified 2026-11-20T12:17:51Z. https://latestn.com/tool/claude-code/agents-and-automation/agent-teams-limitations (accessed 2026-11-21T10:03:09Z). @misc{LatestN_tool_claude_code_agents_and_automation_agent_teams_limitations_r1, title = {What are the limitations of Claude Code agent teams?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/agents-and-automation/agent-teams-limitations}}, note = {Revision 1; digest sha256:8eeae08e27091e9b; last verified 2026-11-20T12:17:51Z; accessed 2026-11-21T10:03:09Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/agents-and-automation/agent-teams-limitations