Skip to content
BENIBIX Learn

requiredMinimumVersion

AI⌨️ Claude CodeConfiguration

Also known as requiredMinimumVersion setting, version floor

The key that stops old versions of Claude Code from starting.

Think of it like

It is like a ride that says you must be this tall to get on. Too short, and you wait.

Example

A bug in old versions let a setting slip past. Emma's IT sets a version floor, and old copies refuse to start.

Why it matters

An old version can lack a fix or a rule the company depends on.

Definition

requiredMinimumVersion is a key for managed settings. It sets the oldest Claude Code version that may start. If the version is older, Claude Code quits at start and tells the person to update. The check runs only at start, so a session that is running goes on. claude update and claude doctor still work below it.

Example code

json
{
  "requiredMinimumVersion": "2.1.150"
}
Versions older than 2.1.150 will not start.

Common mistake

Putting it in a user file. It only works from managed settings, and nothing warns you.

Key takeaways

  1. 1
    Oldest allowed. A version.
  2. 2
    Checked at start. Running sessions go on.
  3. 3
    Update still works. To recover.