Claude CodeのswitchModelsOnFlagとは — 安全分類時の切替を選ぶ設定

switchModelsOnFlagは、/configでSwitch models when a message is flaggedと表示される設定です。未設定またはtrueならフラグが立った時点で自動的にフォールバックモデルへ切り替えます。falseならセッションを止めて、切り替えるか編集して再試行するかを選ばせます。未設定のときは、対話セッションでは初回のフラグ時に自動で切り替えるかを確認されることがあります。

Fable系・Opus 5.5・Sonnet 5.5・Opus 5でリクエストを送ると、安全分類器がフラグを立てて応答モデルが切り替わることがあります。falseにしても選択画面が出ない場面があり、設定の効き方はそこで分かれます。Sonnet 5.5側の切り替え条件はSonnet 5.5がSonnet 5へ切り替わる理由にあります。

switchModelsOnFlagは何を切り替える設定か

switchModelsOnFlagは、分類器がリクエストにフラグを立てたときの挙動を選ぶブール値です。型はBooleanで、既定は未設定です。未設定のときはtrueと同じく自動で切り替わります。Claude Scienceにも同名のトグルがあり、Chat pausedカードの扱いで触れています。

スコープはAny fileで、ユーザー・プロジェクト・ローカル・managed settingsのどのファイルにも書けます。

どちらの値でも、切り替わった後のセッションはフォールバック先のモデルで続きます。元のモデルへ戻すには/modelで手動に切り替えます。

フォールバック先はどのモデルが決めるか

switchModelsOnFlagが選ばせるのは「切り替えるかどうか」だけで、行き先はフラグを立てたモデルとカテゴリで決まります。Claude Codeのドキュメントが挙げる対応は次のとおりです。

カテゴリ別の行き先を持つのはClaude Code v2.1.219以降です。それより前は、フラグが立ったFable 5のリクエストはすべてプロバイダーの既定のOpusモデルで再実行され、Opus 5はフラグを立てる側として扱われていませんでした。 Opus 5の側から見た切り替えの理由と課金はOpus 5のモデル切り替えの解説に、Fable 5側の領域と課金はFable 5のモデル切り替えにあります。

設定はsettings.jsonか/configか--settingsで行う

恒常的に効かせるには、settings.jsonにswitchModelsOnFlagを書きます。

{
  "switchModelsOnFlag": false
}

/configを開いてSwitch models when a message is flaggedを切り替えても同じ設定を変えられます。1回の起動だけ試すなら、--settingsにJSON文字列を渡す方法があります。v2.1.287のclaude --helpでは、--settings <file-or-json>は「設定JSONのパスまたはJSON文字列を追加で読み込む」オプションとして載っています。

claude --settings '{"switchModelsOnFlag": false}'

switchModelsOnFlagを直接指定する専用のコマンドラインフラグは、v2.1.287のclaude --helpにありません。似た名前の--fallback-modelは、過負荷や利用不可のときの代役を指定する別の仕組み(後述のfallbackModel)に対応するフラグです。

複数の設定ファイルに同じキーがあるときは、managed settings、--settings、プロジェクトローカル、共有プロジェクト、ユーザーの順で上位が勝ちます。

環境変数CLAUDE_CODE_DISABLE_REFUSAL_FALLBACKでも止められる

自動切り替えそのものを止める環境変数もあります。環境変数リファレンスでは、CLAUDE_CODE_DISABLE_REFUSAL_FALLBACKに1を設定すると、安全分類器がリクエストにフラグを立てたときの自動モデル切り替えをオフにすると説明されています。switchModelsOnFlagが制御するのと同じ挙動が対象です。

export CLAUDE_CODE_DISABLE_REFUSAL_FALLBACK=1

設定ファイルを書き換えずに、シェルやCIのジョブ単位で切り替えを止めたいときに使える経路です。switchModelsOnFlagのfalseが「止めて選ばせる」設定であるのに対し、この変数は切り替えのオフという位置づけで、環境変数リファレンスは選択画面については何も書いていません。両方を同時に設定したときの優先順位も記載がないため、挙動を固定したい環境ではどちらか一方に寄せておくと確実です。

falseにしても選択画面が出ないのはどんなときか

falseにしたときの画面は、状況によって3通りに分かれます。

switchModelsOnFlagが変えるのは「選べるかどうか」で、フォールバックが成立するかどうかは変えません。行き先が無い・ブロックされているといった条件は、trueでもfalseでも拒否につながります。

-pの挙動は、公式ページでも書き分けがあります。settings referenceは「ダイアログを出せない-p実行ではフラグが立ったリクエストはエラーで終わる」と書き、model-configは「ターンを拒否で終える」と書いています。いずれも一時停止はしません。trueなら-pでもフォールバック先へ切り替えて続行します。

フラグの理由が分からないときの切り分け

フラグは、セッション最初のリクエストで立つことがあります。そこにはCLAUDE.mdの内容やgit statusといったワークスペースの文脈が乗るため、セキュリティや生物系の資料があるリポジトリでは、その文脈だけで分類器に引っかかることがあります。

--safe-modeを含めた切り分けの全体像はClaude Code safe modeでの切り分け方にあります。「safety measures flagged」というエラー文言が出たときの対処はsafety measuresのフラグへの対処で扱っています。

Bedrock・Vertex AI・Foundryではモデルを識別できないと切り替わらない

Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryはモデルidがプロバイダー固有です。Claude Codeが今のモデルとフォールバック先の両方を識別できて初めて、自動切り替えが成立します。識別できないと、trueでも切り替えは起きず、フラグが立ったリクエストは拒否メッセージで終わります。

識別の条件は、フラグを立てる側と行き先で別々です。

• Fable系: モデルidにclaude-fable-5が含まれる、ANTHROPIC_DEFAULT_FABLE_MODELの値と一致する、またはmodelOverridesでマッピングされている
• Opus 5.5・Sonnet 5.5・Opus 5: プロバイダーのモデルidかmodelOverridesのマッピングで認識される
• Opusの行き先: どのモデルが拒否した場合でも、ANTHROPIC_DEFAULT_OPUS_MODELを設定するか、プロバイダーのモデル一覧にOpus 4.8のエントリを残す。どちらもないと、Sonnet 5.5を含むすべてのフラグ元でフォールバックが止まり、拒否で終わる
• Sonnet 5.5の行き先: Opusの設定に加えて、ANTHROPIC_DEFAULT_SONNET_MODELを設定するか、モデル一覧にSonnet 5のエントリを残す

Opusの設定にOpus以外のモデルや、拒否したモデル自身を指定すると、拒否がそのまま残ります。Sonnetの設定にSonnet以外やSonnet 5.5自身を指定した場合も同じです。識別できなかったときは、/modelでモデルを切り替えて再送します。

export ANTHROPIC_DEFAULT_FABLE_MODEL="<プロバイダーのFableのモデルid>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<プロバイダーのOpusのモデルid>"

ANTHROPIC_DEFAULT_OPUS_MODELを設定すると、フォールバックのあるすべてのカテゴリの行き先がそのモデルになります。設定しない場合は、サイバーがOpus 4.8のエントリ、Fable系とOpus 5.5のバイオロジーがOpus 5のエントリへ向かいます。

managed settingsで組織のトグルを固定する

managed settingsは設定の階層の最上位で、ユーザーや--settingsで上書きできません。上書きを許す「例外」の一覧にswitchModelsOnFlagは載っていないため、managedにfalseを置けば、開発者は自分の設定でtrueに戻せません。

セキュリティレビューやバイオロジー関連の作業を扱うチームで、フラグが立ったリクエストを必ず人が確認してから進めたいときの選択肢です。逆に-pの実行が中心の組織では、falseの固定はフラグが立ったターンを拒否で終わらせます。managed settingsの配布方法・availableModelsとの組み合わせはClaude Code組織管理ガイドで扱っています。

fallbackModelとは別の仕組み

名前が似たfallbackModelは、モデルの過負荷や利用不可といった可用性の問題を扱う設定で、安全分類器のフラグとは無関係です。v2.1.287のclaude --helpには、各ユーザーターンの冒頭でまず元のモデルを試し直すと載っています。

引き金が別なので、両方を有効にしても干渉しません。「なぜかモデルが変わった」という場面では、通知の文言がどちらの仕組みによるものかを先に見ると切り分けが早まります。fallbackModelの書き方はClaude Code fallbackModelで過負荷に備えるに、モデル切り替えのフックとの境界はPreModelSwitch・PostModelSwitchフックの解説にあります。

まとめ

値を選ぶ前に、使っているプロバイダーでモデルを識別でき、行き先が許可リストに入っているかが先に決まります。trueかfalseかが効くのは、その条件を満たした後です。