Public story · 2026-06-30 · high
Claude Code agent teams start with a blank slate
Turning on the flag lets one orchestrator spawn teammates that share the file system, not your chat history.
Why now: The feature is still gated behind an experimental flag, which is exactly the moment a gotcha this easy to miss costs someone the most.
Story
Enabling CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS in settings.json lets a Claude Code session spawn teammates that work in parallel instead of one after another, per the docs. One orchestrator hands out pieces of a job and several agents run at once. The catch: each teammate starts with none of the context from the chat that spawned it.
No shared memory. Each teammate reads CLAUDE.md and whatever MCP tools are configured, and nothing else, according to the docs. It doesn't know what you and the orchestrator already worked out. Any file path, constraint, or decision you already settled has to go straight into the spawn prompt.
Teammates coordinate with each other through the file system, not shared chat. That's a different way of working than one long conversation, where everything said earlier stays in view. Writing a spawn prompt that carries the full context a teammate needs is its own skill, separate from describing what to build.
Tokens scale per teammate, so it's not something to leave running by default. The docs reserve it for research, review, and building new modules, jobs with a clear brief and a clear finish line.
Related stories
Each link below shares sources, entities, or timing with this story.
Shared entities / Same source / Shared topic / Earlier coverage
Skills You Can Learn Today
Both cover Enable, MCP; cite the same source (per the docs); overlapping topics (claude, code, context, team).
Shared entities / Same source domain / Shared topic / Earlier coverage / Tension
10 actionable skills from today's findings:
Both cover CLAUDE, MCP; reported by the same outlet (code.claude.com); overlapping topics (agent, claude, code, context).
Shared entities / Same source / Shared topic / Earlier coverage
Skills to Practice Today
Both cover Claude, MCP; cite the same source (per the docs); overlapping topics (agent, claude, code).
Shared entities / Shared topic / Earlier coverage
Deploy Claude Code Agent Teams with Delegate Mode
Both cover CLAUDE, Enable; overlapping topics (agent, claude, code, enable, file); earlier CLAUDE coverage from 2026-03-02.
Shared entities / Shared topic / Earlier coverage / Tension
The Claude Code Field Guide Hit 53,400 Stars. Here's Why That Matters.
Both cover Claude, MCP; overlapping topics (agent, claude, code, prompt); earlier Claude coverage from 2026-05-17.
Shared entities / Same source domain / Shared topic / Earlier coverage
The Terminal Is the New IDE. Every Major Lab Agrees.
Both cover Claude, MCP; reported by the same outlet (code.claude.com); overlapping topics (agent, claude, code).
Shared entities / Shared topic / Earlier coverage
10 Skills of the Day
Both cover CLAUDE, MCP; overlapping topics (agent, claude, code, context, file); earlier CLAUDE coverage from 2026-03-25.
Shared entities / Same source domain / Shared topic / Earlier coverage
Lazy-Load MCP Definitions Cuts Token Overhead 85% — 51K to 8.5K Tokens Automatically
Both cover CLAUDE, MCP; reported by the same outlet (code.claude.com); overlapping topics (claude, code, context).
Source trail
Entities
Claim evidence
- Claude Code agent teams start with a blank slate
Provenance
- Canonical issue
- 2026-06-30
- AI generated
- yes
- Story unit
- 2026-06-30-run-claude-code-agent-teams-by-writing-all-shared-context-into-the-spawn-prompt
- Labels
- source-backed, canonical briefing excerpt