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

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

See the Claude Code tool profile

References