settings.json

availableModelsMatch

型string既定値prefix記述場所管理者設定のみ

availableModels のエントリがモデル ID と一致させる方法を選択する。デフォルトではモデル ID のエントリはそれを拡張する後続バージョンも許可するため、"claude-opus-5" は Opus 5.5 を許可する。"exact" を指定すると、各モデル ID のエントリは指定されたバージョンのみを許可するため、そのモデルの新しいバージョンはリストに追加するまでブロックされ続ける。Claude Code v2.1.283 以降が必要

取りうる値

prefix既定モデル ID のエントリは、そのバージョンおよび別のセグメントで拡張されるモデル ID を許可する
exactモデル ID のエントリは、そのバージョンの日付付き ID を含め、指定されたバージョンのみを許可する。たとえば "claude-opus-5" は Opus 5 を許可するが claude-opus-5-5 は許可しない。"opus" のようなファミリーエイリアスは引き続きファミリー全体を許可し、best、opusplan、default のエントリは無視される

記述例

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

使い方・用途

  • デフォルト値は prefix
  • prefix モデル ID のエントリはそのバージョンと、セグメントを追加して拡張されるモデル ID も許可する
  • exact モデル ID のエントリは指定バージョンのみを許可し、新しいバージョンはリストに追加するまでブロックされる。opus のようなファミリーエイリアスはファミリー全体を許可し、best、opusplan、default のエントリは無視される
英語原文(公式ドキュメントより)

Choose how [availableModels](#availablemodels) entries match model IDs. By default a model ID entry also permits later versions that extend it, so "claude-opus-5" permits Opus 5.5. With "exact", each model ID entry permits only the version it names, so a newer version of that model stays blocked until you list it. Requires Claude Code v2.1.283 or later.

関連ドキュメント

関連する変更履歴

v2.1.283(1件)

Added
PermissionsSettings
availableModelsMatch マネージド設定を追加: exact の場合、availableModels のエントリは指定したバージョンだけを許可し、明示的にリストに追加されるまで新しいリリースはブロックされたままになる
英語原文を表示
Added availableModelsMatch managed setting: with "exact", an availableModels entry allows only the model version it names, so new releases stay blocked until listed

変更前

以前はバージョン接頭辞は後続のバージョンもまとめて許可していたため、新しいリリースは自動的に許可され、管理者が明示的に拒否しない限り使えた

変更後

availableModelsMatch マネージド設定の新しい値 exact を使うと、availableModels のエントリはバージョン接頭辞や完全なモデル ID で指定したバージョンそのものだけを許可する

ユーザーへの恩恵

新しいモデルバージョンの使用を明示的にリストに追加するまでブロックでき、モデル選択の管理をより厳密に行える

関連ドキュメント