他の方法でモデルが割り当てられていないサブエージェント、エージェントチームのチームメイト、ワークフローエージェントの既定モデル。haiku のようなエイリアスまたは完全なモデル名を受け付ける。これより優先される 2 つのソースがある。Claude がエージェントをスポーンするときに渡すモデルと、inherit を含むエージェント定義内の model フィールドである。それを変更するには CLAUDE_CODE_SUBAGENT_MODEL_FORCE を設定する。完全な順序は Choose a model を参照。inherit に設定するのは未設定のままにするのと同じ。v2.1.251 より前では、この変数は呼び出しごとのモデルと定義の model フィールドの両方を上書きしていた。
The default model for subagents, agent team teammates, and workflow agents that aren't assigned a model another way. Accepts an alias such as haiku or a full model name. Two sources take precedence over it: a model Claude passes when it spawns the agent, and a model field in the agent's definition, including inherit. To change that, set CLAUDE_CODE_SUBAGENT_MODEL_FORCE. See Choose a model for the full order. Setting it to inherit is the same as leaving it unset. Before v2.1.251, this variable overrode both the per-invocation model and the definition's model field
CLAUDE_CODE_SUBAGENT_MODEL_FORCE やエージェント自身の model)を表示するようにした。CLAUDE_CODE_SUBAGENT_MODEL_FORCE or an agent's own model)CLAUDE_CODE_SUBAGENT_MODEL_FORCE を追加した。これを設定すると CLAUDE_CODE_SUBAGENT_MODEL（またはメインモデル）がすべてのサブエージェントに適用され、スポーン単位やエージェント定義のモデル上書きが無視されるCLAUDE_CODE_SUBAGENT_MODEL_FORCE to apply CLAUDE_CODE_SUBAGENT_MODEL (or the main model) to every subagent, ignoring per-spawn and agent-definition model overrides変更後
サブエージェント、エージェントチームのチームメイト、ワークフローエージェントのモデルを、定義ファイルやスポーン時の指定に優先されても確実に一つに統一できるようになり、コスト管理やモデル構成の一貫性を強制したい管理者・利用者のニーズに応える。
CLAUDE_CODE_SUBAGENT_MODEL の動作を、すべてをオーバーライドするのではなくデフォルトのサブエージェントモデルを設定する形に変更した。エージェント定義の model: やスポーン時の明示的なモデル指定が優先されるCLAUDE_CODE_SUBAGENT_MODEL to set the default subagent model rather than override everything: an agent definition's model: and an explicit per-spawn model now take precedence over it変更後
環境変数がデフォルトのサブエージェントモデルとして機能するようになり、エージェント定義の model: フィールドやスポーン時に明示的に指定したモデルが優先される。そのため、CLAUDE_CODE_SUBAGENT_MODEL を設定しながらも、個別のエージェントごとのモデル指定を活かした運用ができる。
CLAUDE_CODE_SUBAGENT_MODELが、エージェントチームによって生成されたチームメイトプロセスに適用されない問題を修正しました。CLAUDE_CODE_SUBAGENT_MODEL not applying to teammate processes spawned by agent teams変更後
チーム全体で特定のモデル(安価なモデルや高性能なモデルなど)を強制的に使い分けることができ、コスト管理や精度の制御が確実になります。
CLAUDE_CODE_SUBAGENT_MODEL が子プロセスに転送されない問題が修正されました。CLAUDE_CODE_SUBAGENT_MODEL not being forwarded to child processes in multi-agent sessions変更後
サブエージェントに安価なモデルを指定することでコストを抑えるといった、モデルの使い分け設定が確実に反映されるようになります。