[DOCS] Ambiguity regarding default model behavior for Subagents

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/sub-agents

Section/Topic

Configure subagents > Choose a model

Current Documentation

Under the Choose a model section, the documentation currently states regarding the model field:

Omitted: If not specified, uses the default model configured for subagents (sonnet)

What's Wrong or Missing?

The documentation appears to contradict recent updates found in the Changelog.

The text implies that if the model field is omitted, it defaults to a hardcoded sonnet model. However, the Changelog (specifically v2.1.3) mentions a fix: "Fixed subagents sometimes not inheriting the parent's model by default".

This implies that the intended behavior for an omitted model field is actually inheritance from the parent session, not a static default to Sonnet. This creates ambiguity for developers trying to predict which model a subagent will use if configuration is left blank.

Suggested Improvement

Please verify the current behavior in the latest version of Claude Code.

If inheritance is indeed the intended default behavior following the 2.1.3 fix, the documentation should be updated to:

Omitted: If not specified, the subagent inherits the model used by the main conversation (parent session).

If sonnet is still used as a fallback only when inheritance fails, this distinction should be clarified.

Impact

High - Prevents users from using a feature

Additional Context

Relevant Changelog Entry (v2.1.3/2.1.0):

"Fixed subagents sometimes not inheriting the parent's model by default"

Source: Claude Code CHANGELOG