Select and Verify a Claude Code Subagent Model
A project subagent can inherit the main conversation's model or request a model by name. Account access and environment overrides can affect the choice, so test the actual assignment before comparing performance.
Worked example
Subagent that inherits the active model
--- name: label-check description: Check accessibility labels in one named component. model: inherit tools: Read, Grep, Glob --- Read the supplied component. Report the file and a short observation about each label that needs review.
Steps
- Create .claude/agents/label-check.md with the sample and run it on one small test fixture. Start a fresh session if you add the agent from outside the active conversation.
- Run /tasks while the subagent is active and record the displayed model if your client supports that detail. For the first run, keep the main model and set model to inherit.
- Switch the subagent model field to a model your account can use and repeat the same task. Review settings for CLAUDE_CODE_SUBAGENT_MODEL or its force override if the displayed model differs from what you expected.
What to check
- Use the same input and tool permissions in both runs if you compare models. For a reproducibility requirement, consult the current full model ID instead of relying on an alias that can move.
- Verify the task model metadata when available. A model's self-description is not a reliable way to identify the runtime model.