What
An administrator can now supply an ordered options list of {model, label?, description?} rows that appear in /model, and set replaceBuiltInOptions to hide the built-in lineup, gateway-discovered models and ANTHROPIC_CUSTOM_MODEL_OPTION rather than add to them. It is honored from managed settings, --settings/SDK and user settings only, never from a project checkout, and the highest-precedence source wins outright with no merging.
Details
- Rows that fail validation are dropped one at a time with a warning; the rest of the file still applies.
- Consumed where the picker's rows are assembled, so it takes effect in the
/modelUI directly. - Ships alongside
modelPricing, which prices usage at contracted rates via amultiplierin (0, 1] and per-modeloverridesand is restricted to managed sources. - Neither key exists in 2.1.241, and no flag gates either: writing the setting is enough.
Evidence
Strings lifted out of the shipped bundle, so the claim above can be checked against them.
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 ANTHROPIC_CUSTOM_MODEL_OPTION, on Model configuration.
export ANTHROPIC_CUSTOM_MODEL_OPTION="my-gateway/claude-opus-5-5"model-config see the edit
Confirmed since
Anthropic's documentation has since written up modelPicker, on All settings.
| Read from the highest-priority source only | Reads the key only from the highest-priority source that carries a policy key, so a lower source's value is ignored even when the highest source sets none | [`apiKeyHelper`](#apikeyhelper), [`…settings-reference see the edit
Confirmed since
Anthropic's documentation has since written up /model, on All settings.
Cap the [effort level](/docs/en/model-config#adjust-effort-level) a session can use, leaving lower levels available. Any higher level runs at the cap instead, including one from `/effort`, the `/model` picker, `--effort`, [`CLAUDE_CODE_EFF…settings-reference see the edit
Added since
A small documentation edit on Agent SDK reference - TypeScript touched a line naming /model after this was published.
`effortLevel` accepts an [effort level](/docs/en/model-config#adjust-effort-level) name. It also accepts `"ultracode"`, which requests `xhigh` effort with [ultracode](/docs/en/workflows#let-claude-decide-with-ultracode) on. `applyFlagSetti…agent-sdk/typescript see the edit
Two sources agreeTwo things we can check say the same as this entry.
Anthropic's documentation agrees
A small documentation edit on Agent SDK reference - TypeScript touched a line naming /model after this was published.
The name it cites is new in this build
New in this build: modelPicker