# availableModels

> A list that limits which models people may pick.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** availableModels setting, allowed models

## Think of it like

It is like a menu with only some dishes on it. You can pick only from what is there.

## Definition

availableModels is a settings key that limits which models people can pick. It holds for the main chat, subagents, skills and the advisor. When IT sets it, it also limits /model, --model and the model key in each person's own files. An ID like claude-opus-5 lets in later ones too, such as Opus 5.5. Left unset, any model is fine.

## Example

Emma's boss wants to keep costs down. IT sets availableModels to Sonnet and Haiku, and the model list shows just those two.

## Example code

```json
{
  "availableModels": ["sonnet", "haiku"]
}
```

Allow only Sonnet and Haiku models.

## Why it matters

It is how a team keeps costs and model choice in line across every machine.

## Common mistake

Listing claude-opus-5 and thinking newer ones are blocked. A listed ID also allows the ones that build on it.

## Three principles

- **Limits the picker.** And --model.
- **Best in managed.** Then it holds.
- **Later versions too.** Unless set exact.

## Related terms

- [model Setting](https://learn.benibix.com/term/ai/model-setting)
- [Managed Settings File](https://learn.benibix.com/term/ai/managed-settings-file)
- [/model Command](https://learn.benibix.com/term/ai/model-command)

## Told apart from

- [model vs availableModels](https://learn.benibix.com/compare/model-setting-vs-available-models-setting): People think model limits which models can be used. It only picks the one a session starts on, and you can switch. availableModels is the list anyone may pick from at all. Set in managed settings, it holds against the model key, the flag and /model.
- [availableModels vs deniedModels](https://learn.benibix.com/compare/available-models-setting-vs-denied-models-setting): People think these are one list said two ways. availableModels names the only models people may pick, and works from any file. deniedModels names models that are blocked even when the first list has them. It only works from managed settings. IT uses it to hold back one new model and leave the rest of the list alone.

---

Source: https://learn.benibix.com/term/ai/available-models-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-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
