結論：workflowの再現性と他agentの自由度を分ける
Claude Code公式changelog 2.1.296（2026年10月9日）は、CLAUDE_CODE_WORKFLOW_SUBAGENT_MODELを追加し、workflow agentを一つのモデルで実行できると説明しています。公式のsettingsガイドとsubagentsガイドを併読し、環境変数の設定場所、workflowの起動条件、通常subagentとの違いを確認します。
workflowが定型の検査・変換・テストを繰り返すなら、モデルを固定すると比較条件と費用の説明がしやすくなります。一方、探索や例外対応を行うsubagentまで同じモデルへ寄せると、必要な能力と費用のバランスを失います。既存のAgent toolのeffort設計は一回の作業深度、本稿はworkflow agentのモデル責任分界へ絞ります。
モデル固定の適用範囲を比較する
| 設計 | 利点 | 注意点 |
|---|---|---|
| workflowだけ固定 | 反復処理の結果と費用を比較しやすい | 対象workflowを確実に識別する |
| 全subagentを固定 | 構成が単純 | 探索・レビューの品質を下げる可能性 |
| モデルを都度選択 | 業務ごとに能力を最適化 | 費用と結果の再現性が下がる |
| 人が承認して切替 | 例外時に説明しやすい | 待ち時間と運用負荷が増える |
環境変数へモデル名を入れれば適切なモデル選定が完了するわけではありません。利用中の契約、gateway、モデル提供条件、context、tool互換性を確認し、指定が無効な場合の表示とfallbackを実機で記録します。公式が明記していない値や推奨を推測して、固定の安全値として配布しないでください。
導入前に行う8手順
- workflowを開始・終了・失敗のイベントで定義し、通常subagentと区別します。
- 各agentの役割、必要な能力、入力、出力、外部toolを台帳にします。
- 固定候補のモデル、利用地域、契約、context、料金を公式ページで確認します。
- 設定をuser・project・CIのどこへ置くか決め、秘密情報と混在させません。
- 2.1.296以上で環境変数が読み込まれることと、対象agentの表示を確認します。
- 同一workflowを設定なし・固定ありで複数回実行し、成功率と出力差を記録します。
- 失敗、timeout、モデル利用不可、tool不一致が起きた際の停止と再実行を試します。
- 品質、費用、時間、確認者の合格条件を満たした後にCIやチームへ広げます。
試験データは実顧客情報ではなくfixtureを使い、push、削除、外部通知を自動で実行しないよう権限を絞ります。モデルが変わると、同じpromptでも拒否、出力形式、tool引数、要約の粒度が変わる可能性があります。結果だけでなく、設定、version、モデル名、ログを一緒に保存してください。
費用と品質を同じ判断にする
評価票には1workflowあたりの入力・出力token、cache利用、リトライ、完了時間、テスト成功率、レビュー差戻し率を記録します。単価が低くても失敗が増えれば再実行と人手確認で高くなります。反対に高いモデルで全工程を回すと、定型作業へ過剰な能力を使うことがあります。
workflow agentが作った成果物を他のsubagentやmainが採用する場合は、境界を明示します。誰がmodelを選び、誰が出力を検証し、どの条件で停止するかを決めます。モデル名だけをログに残すのではなく、設定の出所、実行時version、入力のhash、承認者を残すと、後日の再現性が上がります。
モデル選択の評価では、平均値だけでなく失敗の分布を見ます。夜間にだけtimeoutが増える、特定のtool呼び出しで差戻しが増える、長い入力で出力形式が崩れるなど、条件別の差を分けると、workflowだけモデルを固定する意味が明確になります。運用開始後も月一回は設定と実測を照合してください。
固定モデルは「変更しない」という意味ではありません。新しいversionや料金、提供基盤の変更があれば、同じ評価票で再測定し、継続、変更、停止を承認します。自動更新に任せず、変更理由と適用日を記録すると、予算と品質の責任者が追跡できます。
切替後の監査ログを残す
モデル固定の効果を説明するには、設定値だけでなく実行結果を追跡します。workflow名、実行時version、agent名、model ID、入力のhash、終了理由、レビュー結果を一つのrun IDへ結び付けます。出力本文に機密情報がある場合は、ログへ丸ごと複製せず、許可されたartifactと参照IDだけを保存します。
モデルが利用できない時に無言で別モデルへfallbackすると、品質と費用の比較が崩れます。fallbackを許すなら、対象モデル、許可条件、通知先、再レビューの要否を明示します。許さないならworkflowを停止し、担当者が原因を確認して再開する経路を用意します。自動化の速さより、間違ったモデルで完了したことを見逃さないことを優先してください。
企業運用チェックリスト
- 2.1.296以上で環境変数の対象範囲を確認した
- workflow agentと通常subagentの役割が分かれている
- 設定の正本、適用scope、rollback方法がある
- model ID、契約、gateway、利用地域を公式readbackした
- 設定なし・固定ありを同じfixtureで比較した
- 失敗、timeout、利用不可、tool不一致を試験した
- 費用、時間、成功率、差戻し率を記録した
- mainまたは人の最終確認者と停止条件が決まっている
最初は一つの読み取り専用workflowだけを固定し、結果が安定してから書き込みを含む処理へ進みます。無料診断では、agentごとのモデル、権限、費用上限、検証者、停止条件を比較表にできます。無料診断（60秒）で、設定を広げる前の評価票を作成してください。
FAQ
- 環境変数はすべてのsubagentを変えますか？
- 公式の説明はworkflow agentを一つのモデルで実行するための変数です。通常subagentへの影響は決めつけず、実機で対象範囲を確認します。
- 安いモデルへ固定すれば費用は下がりますか？
- 必ずではありません。失敗、再実行、人の確認を含む総費用で比較します。期間を区切って再測定します。
- workflowのモデル設計を相談できますか？
- できます。agent別の役割、モデル、上限、確認者、停止条件を無料診断（60秒）で整理します。小さな読み取り専用workflowから始める判断も支援します。