You'll noticeTier: how much it should matter to you
1Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
UpdaterArea: what it touches
Bug FixesKind: in v2.1.277,
Bug FixesSection of the release
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.
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 sinceAnthropic's documentation has since written up minimumVersion, on Set up Claude Code for your organization.| [Version floor](/docs/en/settings-reference#minimumversion) | Prevent auto-update from installing below an org-wide minimum | `minimumVersion` |admin-setupsee the edit
Confirmed sinceAnthropic'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-usagesee 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…
