← The Wire

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.

Confidence
high
Sources
1
Redaction
passed

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.

  1. 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).

  2. 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).

  3. 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).

  4. 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.

  5. 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.

  6. 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).

  7. 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.

  8. 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

  1. 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