Answer: You can specify teammates and models directly in your prompt, for example by asking Claude to spawn a set number of teammates and naming the model for each. Claude Code picks each teammate's model from the first applicable source: the model named in the spawn prompt, then the subagent definition's model, then CLAUDE_CODE_SUBAGENT_MODEL, then the lead's current model. Status: Confirmed Entry: tool/claude-code/agents-and-automation/specify-teammates-models Revision: 3 Digest: sha256:7610e7eaa0586f77 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:03:11Z Last changed: 2026-11-18T12:13:34Z (Force variable: — → CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1) Last verified: 2026-11-20T12:17:50Z Next check: 2026-11-21T12:17:50Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Example prompt | Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. | [1] | 2026-11-20 First model source | The model your spawn prompt names for that teammate. | [1] | 2026-11-20 Second model source | the definition's `model`, where `inherit` selects the lead's model | [1] | 2026-11-20 Third model source | `CLAUDE_CODE_SUBAGENT_MODEL` | [1] | 2026-11-20 Fourth model source | The lead's current model. | [1] | 2026-11-20 Force variable | CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 | [1] | 2026-11-20 Force variable version requirement | v2.1.257 | [1] | 2026-11-20 Removed setting | teammateDefaultModel | [1] | 2026-11-20 Sources: [1] Anthropic. "Orchestrate teams of Claude Code sessions". https://code.claude.com/docs/en/agent-teams.md Role: primary. Accessed: 2026-11-20T12:17:50Z Quote: "Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate." (Supports: Example prompt) Quote: "The model your spawn prompt names for that teammate." (Supports: First model source) Quote: "the definition's `model`, where `inherit` selects the lead's model." (Supports: Second model source) Quote: "`CLAUDE_CODE_SUBAGENT_MODEL`](https://code.claude.com/docs/en/model-config#environment-variables), when it's set to anything other than `inherit`." (Supports: Third model source) Quote: "The lead's current model." (Supports: Fourth model source) Quote: "If you set [`CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1`]" (Supports: Force variable) Quote: "Requires Claude Code v2.1.257 or later." (Supports: Force variable version requirement) Quote: "`teammateDefaultModel` was removed in v2.1.234; Claude Code ignores a leftover value." (Supports: Removed setting) Published: 2026-11-20T03:07:14Z Snapshot SHA-256: 385746eb7ee35908f790bba7d9d69a0613661e1af32a7de07d17f1376ac8e405 (captured 2026-11-18T12:13:32Z) 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]. On this check the text of [1] was unchanged since 2026-11-18T12:13:34Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:17:50Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:17:50Z Last attempt: 2026-11-20T12:17:50Z Notes and limitations: Extracted automatically from a single official source (section "Specify teammates and models"). Related: https://latestn.com/tool/claude-code/agents-and-automation/streamevent-reference What StreamEvent types does the Claude Code Agent SDK emit when streaming? https://latestn.com/tool/claude-code/agents-and-automation/streaming-limitations What are the known limitations of streaming output in the Claude Code Agent SDK? https://latestn.com/tool/claude-code/agents-and-automation/structured-output How do I get structured output from Claude Code programmatically? https://latestn.com/tool/claude-code/agents-and-automation/set-up-first-hook How do I set up a hook in Claude Code to run a shell command automatically? https://latestn.com/tool/claude-code/agents-and-automation/setting-sources-not-controlled Which settings does settingSources in the Claude Code SDK not control? https://latestn.com/tool/claude-code/agents-and-automation/single-message-input-limitations What are the limitations of single message input in the Claude Agent SDK? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-18T12:13:34Z | changed | Force variable: — → CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 | [1] 2026-11-18T12:13:34Z | changed | Third model source: — → `CLAUDE_CODE_SUBAGENT_MODEL` | [1] 2026-11-14T12:13:31Z | changed | Removed setting: — → teammateDefaultModel | [1] 2026-11-14T12:13:31Z | changed | Force variable version requirement: — → v2.1.257 | [1] 2026-11-14T12:13:31Z | changed | Fourth model source: — → The lead's current model. | [1] 2026-11-14T12:13:31Z | changed | Second model source: — → the definition's `model`, where `inherit` selects the lead's model | [1] 2026-11-14T12:13:31Z | changed | First model source: — → The model your spawn prompt names for that teammate. | [1] 2026-11-14T12:13:31Z | changed | Example prompt: — → Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. | [1] 2026-11-14T12:13:31Z | changed | removed setting: teammateDefaultModel → — | [1] 2026-11-14T12:13:31Z | changed | force variable version requirement: v2.1.257 → — | [1] 2026-11-14T12:13:31Z | changed | fallback model: The lead's current model. → — | [1] 2026-11-14T12:13:31Z | changed | subagent definition model: the definition's `model`, where `inherit` selects the lead's model → — | [1] 2026-11-14T12:13:31Z | changed | model selection order: The model your spawn prompt names for that teammate. → — | [1] 2026-11-14T12:13:31Z | changed | example prompt: Spawn 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate. → — | [1] 2026-11-13T03:03:11Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/agents-and-automation/specify-teammates-models/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/agents-and-automation/specify-teammates-models POST: https://latestn.com/dispute/tool/claude-code/agents-and-automation/specify-teammates-models with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/agents-and-automation/specify-teammates-models?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I specify teammates and models for a Claude Code agent team? Revision 3, last verified 2026-11-20T12:17:50Z. https://latestn.com/tool/claude-code/agents-and-automation/specify-teammates-models (accessed 2026-11-21T10:02:08Z). @misc{LatestN_tool_claude_code_agents_and_automation_specify_teammates_models_r3, title = {How do I specify teammates and models for a Claude Code agent team?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/agents-and-automation/specify-teammates-models}}, note = {Revision 3; digest sha256:7610e7eaa0586f77; last verified 2026-11-20T12:17:50Z; accessed 2026-11-21T10:02:08Z} } 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/agents-and-automation/specify-teammates-models