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 agent option omitClaudeMd to skip CLAUDE.md instructions for delegated subagents

A new omitClaudeMd option lets a delegated subagent run without CLAUDE.md instructions

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

A new omitClaudeMd option lets a delegated subagent run without CLAUDE.md instructions

What

Agent definitions and the schema used to launch a Task (a delegated subagent, a separate agent Claude Code spawns to handle part of a job) now support a boolean option called omitClaudeMd. When set, the subagent runs without loading the user's, project's, or local CLAUDE.md files, which normally supply project-specific instructions. Managed policy files still apply regardless of this setting.

Why

This gives whoever defines an agent a way to run it with a clean slate, free of project-specific CLAUDE.md instructions that might not be relevant or could conflict with the subagent's own purpose, while still keeping organization-enforced policy in effect.

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
Two sources agreeTwo things we can check say the same as this entry.
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