Answer: Set the `model` field in the subagent's definition to a model alias (`sonnet`, `opus`, `haiku`, or `fable`), a full model ID such as `claude-opus-5-5` or `claude-sonnet-5`, or `inherit`. When multiple sources set a model, Claude Code uses the per-invocation `model` parameter first, then the definition's `model` field, then `CLAUDE_CODE_SUBAGENT_MODEL`, then the main conversation's model. Status: Confirmed Entry: tool/claude-code/models/choose-subagent-model Revision: 4 Digest: sha256:67af623ad3a9cb1b (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:56Z Last changed: 2026-11-20T12:25:45Z (precedence order: — → 1. The per-invocation `model` parameter) Last verified: 2026-11-20T12:25:45Z Next check: 2026-11-21T12:25:45Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of model field values | `sonnet`, `opus`, `haiku`, or `fable` | [1] | 2026-11-20 full model ID example | claude-opus-5-5 | [1] | 2026-11-20 inherit option | inherit | [1] | 2026-11-20 precedence order | 1. The per-invocation `model` parameter | [1] | 2026-11-20 default behavior | By default, a subagent you define runs on the same model as the conversation that starts it. | [1] | 2026-11-20 Sources: [1] Anthropic. "Create custom subagents". https://code.claude.com/docs/en/sub-agents.md Role: primary. Accessed: 2026-11-20T12:25:45Z Quote: "**Model alias**: `sonnet`, `opus`, `haiku`, or `fable`" (Supports: model field values) Quote: "such as `claude-opus-5-5` or `claude-sonnet-5`" (Supports: full model ID example) Quote: "**`inherit`**: the main conversation's model, or the spawning subagent's model for a [nested subagent]" (Supports: inherit option) Quote: "1. The per-invocation `model` parameter, which Claude can pass when it starts the subagent." (Supports: precedence order) Quote: "By default, a subagent you define runs on the same model as the conversation that starts it." (Supports: default behavior) Published: 2026-11-20T02:51:46Z Snapshot SHA-256: 554874b443a109e88a2c58273dd3ccdd8e74cf6ed0536238fb704dbe0a254b43 (captured 2026-11-20T12:25:44Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. Cross-check: not-available at 2026-11-20T12:25:45Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:25:45Z Last attempt: 2026-11-20T12:25:45Z Notes and limitations: Extracted automatically from a single official source (section "Choose a model"). Related: https://latestn.com/tool/claude-code/models/gateway-model-discovery How does Claude Code discover available models through a gateway? https://latestn.com/tool/claude-code/models/model-aliases What model aliases are available in Claude Code? https://latestn.com/tool/claude-code/models/models-available-under-zdr Which models are available in Claude Code under Zero Data Retention? https://latestn.com/tool/claude-code/models/auto-mode-classifier-model How do I choose or change the classifier model used by auto mode in Claude Code? https://latestn.com/tool/claude-code/models/background-session-model-effort How do I set the model, effort, and permission mode for Claude Code background sessions? https://latestn.com/tool/claude-code/models/choose-advisor-model Which advisor models can I pair with my main model in Claude Code? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T12:25:45Z | changed | precedence order: — → 1. The per-invocation `model` parameter | [1] 2026-11-20T12:25:45Z | changed | full model ID example: — → claude-opus-5-5 | [1] 2026-11-20T12:25:45Z | changed | default behavior: the same model as the conversation that starts it → By default, a subagent you define runs on the same model as the conversation that starts it. | [1] 2026-11-20T12:25:45Z | changed | precedence order 4: The main conversation's model, or the spawning subagent's model for a nested subagent → — | [1] 2026-11-20T12:25:45Z | changed | precedence order 3: CLAUDE_CODE_SUBAGENT_MODEL → — | [1] 2026-11-20T12:25:45Z | changed | precedence order 2: The `model` field in the subagent's definition, including `inherit` → — | [1] 2026-11-20T12:25:45Z | changed | precedence order 1: The per-invocation `model` parameter → — | [1] 2026-11-20T12:25:45Z | changed | model field values: sonnet → `sonnet`, `opus`, `haiku`, or `fable` | [1] 2026-11-17T12:31:48Z | changed | precedence order 4: — → The main conversation's model, or the spawning subagent's model for a nested subagent | [1] 2026-11-17T12:31:48Z | changed | precedence order 3: — → CLAUDE_CODE_SUBAGENT_MODEL | [1] 2026-11-17T12:31:48Z | changed | precedence order 2: — → The `model` field in the subagent's definition, including `inherit` | [1] 2026-11-17T12:31:48Z | changed | precedence order 1: — → The per-invocation `model` parameter | [1] 2026-11-17T12:31:48Z | changed | model field values: — → sonnet | [1] 2026-11-17T12:31:48Z | changed | default behavior: By default, a subagent you define runs on the same model as the conversation that starts it. → the same model as the conversation that starts it | [1] 2026-11-17T12:31:48Z | changed | precedence order: 1. The per-invocation `model` parameter → — | [1] 2026-11-17T12:31:48Z | changed | inherit option: `inherit` → inherit | [1] 2026-11-17T12:31:48Z | changed | full model ID examples: `claude-opus-5-5` or `claude-sonnet-5` → — | [1] 2026-11-17T12:31:48Z | changed | model field options: `sonnet`, `opus`, `haiku`, or `fable` → — | [1] 2026-11-14T12:21:25Z | changed | default behavior: — → By default, a subagent you define runs on the same model as the conversation that starts it. | [1] 2026-11-14T12:21:25Z | changed | precedence order: — → 1. The per-invocation `model` parameter | [1] 2026-11-14T12:21:25Z | changed | full model ID examples: — → `claude-opus-5-5` or `claude-sonnet-5` | [1] 2026-11-14T12:21:25Z | changed | resolution order fourth: The main conversation's model → — | [1] 2026-11-14T12:21:25Z | changed | resolution order third: CLAUDE_CODE_SUBAGENT_MODEL → — | [1] 2026-11-14T12:21:25Z | changed | resolution order second: The subagent definition's `model` frontmatter → — | [1] 2026-11-14T12:21:25Z | changed | resolution order first: The per-invocation `model` parameter → — | [1] 2026-11-14T12:21:25Z | changed | inherit option: inherit → `inherit` | [1] 2026-11-14T12:21:25Z | changed | full model ID example: claude-opus-5-5 → — | [1] 2026-11-14T12:21:25Z | changed | model field options: sonnet → `sonnet`, `opus`, `haiku`, or `fable` | [1] 2026-11-13T03:05:56Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/models/choose-subagent-model/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/models/choose-subagent-model POST: https://latestn.com/dispute/tool/claude-code/models/choose-subagent-model with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/models/choose-subagent-model?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I choose which model a Claude Code subagent runs on? Revision 4, last verified 2026-11-20T12:25:45Z. https://latestn.com/tool/claude-code/models/choose-subagent-model (accessed 2026-11-21T09:54:10Z). @misc{LatestN_tool_claude_code_models_choose_subagent_model_r4, title = {How do I choose which model a Claude Code subagent runs on?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/models/choose-subagent-model}}, note = {Revision 4; digest sha256:67af623ad3a9cb1b; last verified 2026-11-20T12:25:45Z; accessed 2026-11-21T09:54:10Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/models/choose-subagent-model