Dokumentationerreichbar
Anthropic, Orchestrate teams of Claude Code sessions
code.claude.com (externe Seite)
Die Herstellerdokumentation zu mehreren Agenten, die als Team zusammenarbeiten. Anders als bei getrennten Worktrees bekommt hier jeder Beteiligte kein eigenes Verzeichnis, weshalb die Seite die Bedingung ausspricht, unter der geteiltes Arbeiten aufgeht: Die Arbeit wird so aufgeteilt, dass jeder andere Dateien besitzt. Sie nennt daneben eine Größenordnung, drei bis fünf Beteiligte, und den Grund dafür, dass die Kosten mit jedem weiteren linear steigen und der Abstimmungsaufwand mit.
geprüft 10.11.2026
Worauf sich diese Seite beruft, wörtlich, abgerufen am 04.08.2026:
Two teammates editing the same file leads to overwrites. Break the work so each teammate owns a different set of files.
bestätigt 10.11.2026Start with 3-5 teammates for most workflows.
bestätigt 10.11.2026One session acts as the team lead, coordinating work, assigning tasks, and synthesizing results.
bestätigt 10.11.2026click into a pane to interact directly. Requires tmux, or i
bestätigt 10.11.2026Term2. Agent teams are experimental and disabled by default.
bestätigt 10.11.2026Teammates work independently, each in its own context window, and communicate directly with each other.
bestätigt 10.11.2026Agent teams add coordination overhead and use significantly more tokens than a single session.
bestätigt 10.11.2026For research, review, and new feature work, the extra tokens are usually worthwhile. For routine tasks, a single session is more cost-effective.
bestätigt 10.11.2026They work best when teammates can operate independently.
bestätigt 10.11.2026Claude Code doesn't ask you to confirm the launch.
bestätigt 10.11.2026so teams can form even when you didn't ask for one
bestätigt 10.11.2026A teammate's model and fast mode are fixed when it spawns.
bestätigt 10.11.2026Task claiming uses file locking to prevent race conditions
bestätigt 10.11.2026Claude Code manages task dependencies automatically
bestätigt 10.11.2026coordinate through messages instead of the shared task list
bestätigt 10.11.2026The lead's conversation history does not carry over.
bestätigt 10.11.2026Teammate permission prompts appear in the lead session, so approve them there yourself.
bestätigt 10.11.2026each teammate has its own context window and consumes tokens independently
bestätigt 10.11.2026Three focused teammates often outperform five scattered ones.
bestätigt 10.11.2026do not restore in-process teammates
bestätigt 10.11.2026a session has exactly one team, scoped to that session
bestätigt 10.11.2026teammates cannot spawn their own teammates. Only the lead can manage the team.
bestätigt 10.11.2026the main session is the lead for its lifetime
bestätigt 10.11.2026unless the call is a fork or passes isolation on the call itself
bestätigt 10.11.2026Claude Code reapplies settings-file env values to the running session when you save
bestätigt 10.11.2026A teammate can't approve a permission prompt or supply consent on your behalf
bestätigt 10.11.2026The same rules apply to a message that arrives from one of your other Claude Code sessions
bestätigt 10.11.2026also works in plan mode until its plan is ready
bestätigt 10.11.2026If you haven’t changed that teammate’s permission mode since it was spawned, Claude Code approves the plan as soon as the request arrives, without the lead reviewing it.
bestätigt 10.11.2026or Manual if that’s plan mode
bestätigt 10.11.2026If you put a running in-process teammate in plan mode by pressing Shift+Tab while viewing its session, the lead reviews that run’s plan instead of Claude Code approving it.
bestätigt 10.11.2026Use the up and down arrow keys in the agent panel to select a teammate
bestätigt 10.11.2026when you’re already running inside a tmux session, or when your terminal is i
bestätigt 10.11.2026Term2 with the it2 CLI installed A task can also depend on other tasks and shows as blocked in the task list until they’re completed.
bestätigt 10.11.2026Teammates don’t self-claim a blocked task, but you or the lead can still assign it.
bestätigt 10.11.2026
02 Die Werkzeuge04 Versionierung22 Teams und Workflows23 Plan vor Code27 Übergabe zwischen Sitzungen