LLM推論初出 9/11 13:13
CLAUDE_CODE_SUBAGENT_MODELだけではpin済みsubagentのモデルを変えられない
https://zenn.dev/topics/ai/feed·2026/9/11
AI要約
Claude Codeにおいて、環境変数だけではpin済みのsubagentのモデルを上書きできない問題について解説。frontmatterで明示的にモデルが指定されている場合、環境変数CLAUDE_CODE_SUBAGENT_MODELの設定だけでは意図したモデルに切り替わらないことを検証結果と共に示している。
AI要点
- Claude Codeにおいて、.claude/agents/*.mdのfrontmatterでモデルを固定した場合、環境変数CLAUDE_CODE_SUBAGENT_MODELだけでは上書きされない。
- v2.1.251以降、CLAUDE_CODE_SUBAGENT_MODELはsubagentのデフォルトモデル設定のみとなり、frontmatter指定が優先される設計に変更された。
- v2.1.257以降で追加されたCLAUDE_CODE_SUBAGENT_MODEL_FORCE=1を設定すれば環境変数が優先されるはずだが、検証では確証が得られなかった。
- 古い情報（v2.1.251以前）は、環境変数が常に上書きするという挙動を前提としており、現在の挙動と異なっている点に注意が必要である。
- コスト削減のためにsubagentのモデルをhaikuに固定したい場合、frontmatterでの明示的なモデル指定が重要となる。
なぜ重要か
Claude Codeのsubagentモデル指定において、環境変数とfrontmatterの優先順位が変更され、特に固定済みのsubagentモデルが意図せず高価なまま実行されるリスクがある。これは、コスト管理と予測可能性の観点から、開発者が最新の挙動を理解し、適切な設定を行う必要性を示している。