Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.277 ·

minimumVersion / requiredMaximumVersion / update target now semver-validated

Version-enforcement settings and update targets are now checked for valid semver before being used

TierYou'll noticehow much it should matter to you
Useful1my rating, 1 to 5
Signal1worth watching, 1 to 5
AreaUpdaterwhat it touches
KindBug Fixesin v2.1.277,
You'll notice

Version-enforcement settings and update targets are now checked for valid semver before being used

What

The code that decides whether the current build of Claude Code is blocked from updating now validates the version numbers it's working with. This applies to the update target itself, as well as to the minimumVersion and requiredMaximumVersion organization policy settings (minimumVersion keeps auto-updates from installing anything below a set version; requiredMaximumVersion refuses to start on a version newer than an organization allows). If any of these values isn't a properly formed version number, Claude Code now logs the raw value (truncated) and simply ignores that setting instead of trying to act on bad data.

Why

Previously, a malformed version string in one of these settings could have caused the version-enforcement logic to misbehave in unpredictable ways. Now a bad value is safely ignored and logged, so a typo in an organization's policy configuration won't silently break update or startup behavior.

Read from
Names in the bundleminimumVersionrequiredMaximumVersion
Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Confirmed since Anthropic's documentation has since written up requiredMaximumVersion, on Monitoring. * `"version_below_minimum"`: this version of Claude Code is below [`requiredMinimumVersion`](/docs/en/settings-reference#requiredminimumversion) or above [`requiredMaximumVersion`](/docs/en/settings-reference#requiredmaximumversion) monitoring-usage see the edit
How sure we are
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agreesAnthropic's documentation has since written up requiredMaximumVersion, on Monitoring.
Anthropic's release notes agreeFixed update checks erroring every 30 minutes, and claude update hanging when a minimum or maximum version is set, if a proxy returns an…

See this entry in the whole of v2.1.277 →