AI Briefing
KO

Claude Code Subagent Model Behavior Changed

·2026.07.27 04:12

Key point

Claude Code's subagents have changed from using the existing Haiku model to inheriting the main session's model.

Details

Following the Claude Code v2.1.198 update, the model behavior of Subagents has changed.

Previously, subagents ran on the lower-cost Haiku model to reduce token consumption, but now, without a separate configuration, they inherit the main conversation session's model as-is (Inherit). For example, if a user is running a session with the Opus model, the subagent will also operate on the Opus model.

Key Changes and Solutions:

  • Model Inheritance: The subagent's model field is set to inherit by default.
  • Cost Management: To prevent subagents from using high-cost models, you need to set the CLAUDE_CODE_SUBAGENT_MODEL=haiku environment variable, or specify model: haiku in the specific agent's frontmatter.
  • Resolution Order: Applied in the order of environment variable → model parameter at invocation → subagent frontmatter → main conversation model.

This summary was generated automatically by AI. Check the original for the author's claims and context. Copyright belongs to the original author.

Our guide explains how the AI works. Report summary errors, attribution issues, or removal requests via Contact.