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 notclaude-opus-5-5. An entry such as"claude-opus-4-5"also permits its dated Anthropic model IDclaude-opus-4-5-20251101. A family alias such as"opus"still permits the whole family, andbest,opusplan, anddefaultentries 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