settings.json

enforceAvailableModels

型boolean既定値false記述場所どの設定ファイルでも可

availableModelsの許可リストを「Default」モデルの選択肢にも適用します(v2.1.175+)。

記述例

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

使い方・用途

  • 管理設定で利用可能なモデルを制限している際、ユーザーがデフォルト設定を通じて制限対象モデルを使用することを防ぎます。
  • 有効な場合、アカウント既定のモデルが許可リスト外であれば、許可リスト内の最初のモデルがデフォルトとして採用されます。
  • availableModelsが未設定または空の場合は機能しません。
英語原文(公式ドキュメントより)

(Managed settings) Extend the availableModels allowlist to the Default model option (requires v2.1.175+). Requires a non-empty availableModels list; when the account-type default is not in the allowlist, Default resolves to the first allowed entry instead. Has no effect when availableModels is unset or empty. See https://code.claude.com/docs/en/model-config#enforce-the-allowlist-for-the-default-model

関連ドキュメント

関連する変更履歴

v2.1.284(1件)

Added
Claude アプリゲートウェイに起動時の警告を追加した。管理ポリシーの availableModels が空の場合や、model または enforceAvailableModels を設定せずに Claude Code が起動するモデルを除外している場合に警告する。
英語原文を表示
Added Claude apps gateway startup warnings when a managed policy's availableModels is empty, or leaves out the model Claude Code starts on without setting model or enforceAvailableModels

変更後

ポリシーの availableModels が空だったり、model や enforceAvailableModels を設定せずに既定モデルを除外していたりする設定ミスをゲートウェイ起動時に警告で検知できるようになり、開発者がセッション開始時に 400 エラーで悩む前に修正できる。

関連ドキュメント

v2.1.175(1件)

Added
管理設定に enforceAvailableModels が追加されました。これを有効にすると、availableModels の許可リストが「デフォルト」モデルにも適用されるようになり、ユーザーやプロジェクト設定によって管理上の許可リストを拡張することができなくなります。
英語原文を表示
Added enforceAvailableModels managed setting — when enabled, the availableModels allowlist also constrains the Default model (a Default that would resolve to a disallowed model now falls back to the first allowed model), and user or project settings can no longer widen a managed availableModels list

変更後

組織の管理者は、開発者が使用できる AI モデルを厳格に制御できるようになります。これにより、特定のモデル以外の利用を禁止するコンプライアンス要件の遵守や、想定外のモデル利用によるコスト発生を確実に防ぐことが可能です。

関連ドキュメント