Skip to content
← Back to release · 2.1.283
New features / v2.1.283

Add availableModelsMatch exact matching

CHANGELOG · original

Added availableModelsMatch managed setting: with "exact", an availableModels entry allows only the model version it names, so new releases stay blocked until listed
Open official changelog ↗

Documentation

Documentation excerpt

availableModelsMatch

Choose how 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.

  • Scope: Managed. Claude Code ignores the key in user, project, and local settings and in --settings, with a warning
  • Type: string, one of:
    • "prefix": a model ID entry permits its version and any model ID that extends it with another segment
    • "exact": a model ID entry permits only the version it names, so "claude-opus-5" permits Opus 5 but not claude-opus-5-5. An entry such as "claude-opus-4-5" also permits its dated Anthropic model ID claude-opus-4-5-20251101. A family alias such as "opus" still permits the whole family, and best, opusplan, and default entries are ignored
  • Default: "prefix"

This example permits Opus 5 and Sonnet 5 and no later release of either:

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

With "exact", the Default option is also limited to the listed models whenever the list names at least one model or family. See Block specific models or versions.

Documentation snapshot · 2026-11-20

Change details