Orchestrate teams of Claude Code sessions changedagent-teams
Nearest release: v2.1.302, published 3 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 16 Oct 2026 20:20 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 16 Oct 2026 20:37 UTC.
Upstream edited
Recorded here
Lines+5added
Lines−5removed
From line
205
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits39to this page, all time
The whole hunk
from line 205, old and new numbered
/
from line 205
205205
206206The lead sends a shutdown request. The teammate can approve, exiting gracefully, or reject with an explanation.
207207
208The team's shared directories are cleaned up automatically when the session ends, so there's no separate cleanup step. See [Architecture](#architecture) for which directories are removed and which persist for resumed sessions.
208The team's shared directories are cleaned up automatically when the session ends, so there's no separate cleanup step. See [Architecture](#architecture) for which directories are removed and which stay on disk.
209209
210210### Enforce quality gates with hooks
211211
from line 244
244244
245245Teams and tasks are stored locally under a session-derived name. The name is `session-` followed by the first eight characters of the session ID:
246246
247* **Team config**: `~/.claude/teams/{team-name}/config.json`
248* **Task list**: `~/.claude/tasks/{team-name}/`
247* **Team config**: `~/.claude/teams/{team-name}/config.json`. Claude Code removes the team config directory when the session ends.
248* **Task list**: `~/.claude/tasks/{team-name}/`. This directory stays on disk after the session ends. To change [how long Claude Code keeps it](/docs/en/claude-directory#cleaned-up-automatically), set [`cleanupPeriodDays`](/docs/en/settings-reference#cleanupperioddays).
249249
250Claude Code generates both of these automatically at session startup and updates them as teammates join, go idle, or leave. The team config directory is removed when the session ends. The task list directory persists locally and is never uploaded, so resumed sessions keep their tasks. Retention is governed by the same [`cleanupPeriodDays`](/docs/en/settings-reference#cleanupperioddays) you already control for session transcripts, following the [retention sweep rules](/docs/en/claude-directory#cleaned-up-automatically).
250Claude Code generates both of these automatically at session startup and updates them as teammates join, go idle, or leave.
251251
252252The team config holds runtime state such as session IDs and tmux pane IDs, so don't edit it by hand or pre-author it: your changes are overwritten on the next state update.
253253
No line in this hunk matches that.