settings.json

availableModels

型string[]記述場所どの設定ファイルでも可

ユーザーが選択可能なモデルを制限します。

記述例

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

使い方・用途

  • 組織内のコスト管理のために、高価なモデルの使用を制限し、許可された特定のモデル(Sonnet や Haiku など)のみを選択肢に表示させたい場合に有効です。
  • 複数の設定レイヤー(ユーザー、プロジェクト、管理)で定義された場合、それらはマージされ、許可リストとして機能します。
英語原文(公式ドキュメントより)

Restrict which models users can select. When defined at multiple settings levels (user, project, etc.), arrays are merged and deduplicated. See https://code.claude.com/docs/en/model-config#restrict-model-selection

関連ドキュメント

関連する変更履歴

v2.1.299(1件)

Fixed
Claude アプリのゲートウェイが、ポリシーの availableModelsMatch: exact や deniedModels によってブロックされるモデルを提供する問題を修正し、400 を返してモデル一覧から除外するようにした
英語原文を表示
Fixed the Claude apps gateway serving models that a policy's availableModelsMatch: exact or deniedModels blocks; it now answers 400 and leaves them out of its model lists

関連ドキュメント

v2.1.295(1件)

Fixed
Claude アプリゲートウェイにサインインしたセッションで、availableModels に列挙された Fable モデルが /model ピッカーに表示されない問題を修正し、該当モデルには同じモデルのために追加された modelPicker 行の代わりに組み込み行を表示するようにした
英語原文を表示
Fixed Fable models listed in availableModels not appearing in the /model picker for sessions signed in to a Claude apps gateway; such a model now shows its built-in row in place of a modelPicker row added for the same model

関連ドキュメント

v2.1.287(1件)

Fixed
Bedrock と Vertex の起動時モデルチェックが強制された availableModels リストを無視し、/model が Opus の 1 行だけに縮小されることがある問題を修正しました。
英語原文を表示
Fixed Bedrock and Vertex startup model checks ignoring an enforced availableModels list, which could collapse /model to one Opus row

関連ドキュメント

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.283(2件)

Added
マネージド設定 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

変更後

管理者は availableModels の許可リストで各モデル ID エントリーが指定されたバージョンだけを許可できるようになり、新しいバージョンのリリースを自分で検証するまでは確実にブロックしたままにできる。

関連ドキュメント

Added
特定のモデルを availableModels が許可していてもブロックできる、マネージド設定 deniedModels を追加した
英語原文を表示
Added deniedModels managed setting to block specific models, even when availableModels allows them

変更後

組織の管理者が deniedModels にモデルを列挙するだけで、特定のモデルやバージョンを確実にブロックできるようになる。

関連ドキュメント

v2.1.176(1件)

Fixed
availableModels 設定の強制力を修正：環境変数によるブロック済みモデルへのリダイレクトを防止し、/fast コマンドでも許可リスト外への切り替えを拒否するようになりました
英語原文を表示
Fixed availableModels enforcement: alias model picks can no longer be redirected to a blocked model via ANTHROPIC_DEFAULT_*_MODEL environment variables, and /fast now refuses to toggle when it would switch to a model outside the allowlist

変更後

組織のポリシーやコスト管理に沿ったモデル運用を確実に徹底できるようになります。

関連ドキュメント

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 モデルを厳格に制御できるようになります。これにより、特定のモデル以外の利用を禁止するコンプライアンス要件の遵守や、想定外のモデル利用によるコスト発生を確実に防ぐことが可能です。

関連ドキュメント

v2.1.174(1件)

Fixed
/advisor ダイアログにおいて、許可リスト(availableModels)でブロックされているはずの保存済みアドバイザーモデルが事前選択されてしまう問題を修正しました。
英語原文を表示
Fixed the /advisor dialog pre-selecting a saved advisor model that is blocked by the availableModels allowlist

変更後

組織のポリシーに反するモデルを誤って使用しようとしてエラーに遭遇する手間が省け、スムーズにアドバイザー機能を活用できます。

関連ドキュメント

v2.1.172(2件)

Fixed
availableModels によるモデル制限が、サブエージェントのオーバーライド、エージェント起動時の選択、およびアドバイザーモデルに適用されていなかった問題を修正。
英語原文を表示
Fixed availableModels restrictions not being applied to subagent model overrides, the agent dispatch model picker, and the advisor model

変更後

企業のコンプライアンスやコスト管理の観点から特定のモデルに限定して利用させたい場合、設定が確実に機能するようになります。

関連ドキュメント

Fixed
availableModels の allowlist に claude-opus-4-8 のような詳細な ID を指定した際、/model 選択画面で 1M コンテキスト対応モデルが隠れてしまう問題を修正。
英語原文を表示
Fixed availableModels allowlists hiding the /model picker's Opus and Sonnet 1M rows when entries use version-specific IDs like claude-opus-4-8

変更後

大規模なコードベースを扱うために 1M コンテキストを活用しつつ、モデルバージョンを固定して運用したいユーザーの利便性が向上します。

関連ドキュメント