Skip to content
← リリースに戻る · 2.1.257
新機能 / v2.1.257

CLAUDE_CODE_SUBAGENT_MODEL_FORCE

CHANGELOG 原文(英語)

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
公式の変更履歴を開く ↗

日本語での補足

CLAUDE_CODE_SUBAGENT_MODEL_FORCEで、CLAUDE_CODE_SUBAGENT_MODELの指定モデル(未指定ならメインモデル)を全サブエージェントに適用し、起動時や定義内のモデル指定より優先。

ドキュメント

ドキュメントの抜粋(参考訳)

すべてのサブエージェントで同じモデルを使う

すべてのサブエージェント、チームメイト、ワークフローエージェントに同じモデルを適用するには、CLAUDE_CODE_SUBAGENT_MODELをそのモデルに設定し、CLAUDE_CODE_SUBAGENT_MODEL_FORCEを1に設定してください。Claude Code v2.1.257以降が必要です。

たとえば、すべてのサブエージェントでHaikuを使うには、設定ファイルのenvブロックに両方の変数を設定します。

{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

設定が反映されたことを確認するには、サブエージェントの実行中に/tasksを実行してください。サブエージェントの行に、使用中のモデルが表示されます。

CLAUDE_CODE_SUBAGENT_MODEL_FORCEが有効な間、Claude Codeはサブエージェント定義のmodelフィールドを無視します。また、Claudeはサブエージェントの起動時にモデルを指定できなくなります。次のサブエージェントは、引き続き親の会話のモデルで実行されます。

CLAUDE_CODE_SUBAGENT_MODEL_FORCEだけを設定した場合、サブエージェントはメインの会話と同じモデルで実行されますが、組み込みのExploreサブエージェントはBuilt-in subagentsに記載されたモデルで実行される点が例外です。

取得日 · 2026-11-20

変更の詳細