環境変数

CLAUDE_CODE_SUBAGENT_MODEL_FORCE

サブエージェント、エージェントチームのチームメイト、およびワークフロー エージェントのデフォルト モデルを設定します。別途モデルが割り当てられていない場合に使用されます。エイリアス（haiku など）または完全なモデル名を受け付けます。

使い方・用途

  • サブエージェントやチームメイトに対して、プロジェクト全体で一貫したモデルを強制的に適用する
  • エージェント定義の model フィールドや個別の起動時の指定よりも優先される
  • 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

関連ドキュメント

関連する変更履歴

v2.1.257(1件)

Added
SettingsSub-agents
サブエージェントに対して CLAUDE_CODE_SUBAGENT_MODEL（またはメインモデル）を強制的に適用する環境変数 CLAUDE_CODE_SUBAGENT_MODEL_FORCE を追加しました。
英語原文を表示
Added 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

変更前

サブエージェントのモデルは、個別の起動時の指定やエージェント定義の model フィールドによって上書きされることがありました。

変更後

この環境変数を設定すると、サブエージェント、チームメイト、ワークフローエージェントすべてに対して、個別の起動時の指定やエージェント定義のモデル設定を無視して、指定されたモデルが適用されるようになります。

ユーザーへの恩恵

プロジェクト全体で一貫したモデルをサブエージェントに適用できるようになり、設定の管理が容易になります。

関連ドキュメント