新機能 / 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はサブエージェントの起動時にモデルを指定できなくなります。次のサブエージェントは、引き続き親の会話のモデルで実行されます。
- 現在の会話からのフォーク
model: inheritを指定したサブエージェントで実行するスキル
CLAUDE_CODE_SUBAGENT_MODEL_FORCEだけを設定した場合、サブエージェントはメインの会話と同じモデルで実行されますが、組み込みのExploreサブエージェントはBuilt-in subagentsに記載されたモデルで実行される点が例外です。
取得日 · 2026-11-20