# requiredMinimumVersion

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** requiredMinimumVersion setting, version floor

## Think of it like

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

## 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

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

## Example code

```json
{
  "requiredMinimumVersion": "2.1.150"
}
```

Versions older than 2.1.150 will not start.

## Why it matters

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

## Common mistake

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

## Three principles

- **Oldest allowed.** A version.
- **Checked at start.** Running sessions go on.
- **Update still works.** To recover.

## Related terms

- [claude update Command](https://learn.benibix.com/term/ai/claude-update-command)
- [claude doctor Command](https://learn.benibix.com/term/ai/claude-doctor-command)
- [Managed Settings File](https://learn.benibix.com/term/ai/managed-settings-file)

---

Source: https://learn.benibix.com/term/ai/required-minimum-version-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
