Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.271 ·

New omitClaudeMd option for spawned agents

Spawned agents/subagents can now be configured with an 'omitClaudeMd' option

TierUse it nowhow much it should matter to you
Useful3my rating, 1 to 5
Signal2worth watching, 1 to 5
AreaSubagentswhat it touches
KindNew Featuresin v2.1.271,
Use it now

Spawned agents/subagents can now be configured with an 'omitClaudeMd' option

What

The set of recognized configuration keys for launching subagents or skills has gained a new option, omitClaudeMd, alongside existing options like initialPrompt, memory, background, isolation, and observer. It's also now accepted as an optional field in the schema used for launching agents/tasks.

Why

An omitClaudeMd option implies subagents can now be launched without the project's CLAUDE.md file (a file of project-specific instructions for Claude) being included in their context, giving more control over what a spawned agent sees.

Read from
Names in the bundleomitClaudeMd
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up omitClaudeMd, on Explore the .claude directory. | `agents/*.md` | `name`, `description`, `tools`, `disallowedTools`, `model`, `permissionMode`, `maxTurns`, `skills`, `mcpServers`, `hooks`, `memory`, `background`, `effort`, `isolation`, `color`, `initialPrompt`, `omitClaudeMd`, `experime… claude-directory see the edit
Added since A small documentation edit on Create custom subagents touched a line naming omitClaudeMd after this was published. * **CLAUDE.md files**: every level of the [CLAUDE.md hierarchy](/docs/en/memory#how-claude-md-files-load) the main conversation loads, including `~/.claude/CLAUDE.md`, project rules, `CLAUDE.local.md`, managed policy files, and any [`AGENT… sub-agents see the edit
How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhat effect setting omitClaudeMd has, beyond its name, is not stated.
Anthropic's documentation agreesA small documentation edit on Create custom subagents touched a line naming omitClaudeMd after this was published.
Anthropic's release notes agreeAdded omitClaudeMd to agent frontmatter and --agents JSON, letting custom and plugin subagents run without user, project and local CLAUDE.md…

See this entry in the whole of v2.1.271 →

Feedback