value
A Claude Code settings key, read out of the shipped bundle. It has been in the build since v2.1.309, including the newest one read.
The --cloud and --remote flags no longer get special early handling and go straight to the normal parser.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.221.
In the changelogs
33Releases whose published page names value.
-
v2.1.307
Shell command checks treat assignment-style arguments to
ddseparatelyWhen checking a shell command before running it, Claude Code now handles assignment-style arguments to
ddunder a separate rulefound in this entry's text
-
v2.1.301
Plugin dialogs can ask for text boxes taller than one line
Text input boxes in plugin-built dialogs now accept a rows setting, a whole number of 1 or more, so they can span several lines
found in this entry's text
-
v2.1.295
Agent SDK passes options so values starting with a dash are not misread
The Agent SDK now passes many options as
--flag=value, so a value starting with a dash is no longer mistaken for another flagfound in this entry's text
-
v2.1.295
Settings-write check takes a second look at commands that use shell variables
Commands that set simple shell variables are re-checked with the values filled in before being held as possibly writing settings
found in this entry's text
-
v2.1.285
Set a bundled MCP server's own options when installing a plugin
The plugin install --config option can now set a bundled .mcpb server's own user_config fields, written as <server>.<key>=<value>
found in this entry's text
-
v2.1.285
Fewer shell permission refusals for NAME=value arguments after some commands
Some allowed shell commands followed by a NAME=value argument no longer fail the permission check as an unsafe variable setting
found in this entry's text
-
v2.1.281
claude agentsview now honours --settings, --managed-settings and setting sourcesclaude agentsnow applies--settings,--managed-settingsand--setting-sourcesfound in this entry's text
-
v2.1.281
Bash path checks now understand cp/mv -t / --target-directory
Bash permission checks now understand
cpandmvwith-tor--target-directoryand check all their files as writesfound in this entry's text
-
v2.1.280
New credential/secret redaction pattern for tool output
A new, broader redaction pattern hides secret keys and tokens found in tool output
found in this entry's text
-
v2.1.277
Env-var-prefix stripping in shell-command normalization now conditional
Shell-command normalization can now skip stripping VAR=value prefixes when matching permission rules
found in this entry's text
-
v2.1.275
Policy manifest gains session.root, prompt.read, ui.panes surface entries
Plugin API policy list adds session.root, prompt.read, and ui.panes as permitted actions
found in this entry's text
-
v2.1.271
Select component gains autoFocus prop
Plugin-pane Select dropdowns can now be given an autoFocus property
found in this entry's text
-
v2.1.260
Legacy string-encoded key/value config values now get a deprecation notice
Legacy string-encoded config values now get flagged for scheduled deprecation.
found in this entry's text
-
v2.1.259
New deny-checked commands: grep/rg/diff/git/cp/mv and generic argument-path extraction
Path deny rules now extract file arguments from more flag shapes and apply to grep, rg, diff, git, cp and mv.
found in this entry's text
-
v2.1.248
Error detail is withheld when a session's output leaves the machine
When your transcript leaves this machine, many error messages print redacted and log detail locally.
found in this entry's text
-
v2.1.246
Prompt input state moved behind one shared draft object
Prompt text, cursor and paste state now live in one shared object; nothing changes for you.
found in this entry's text
-
v2.1.246
Plugin hooks can ask for feature flag values, but the answer is always false
Plugin hooks can ask for feature flag values but every answer comes back false.
found in this entry's text
-
v2.1.235
AskUserQuestion options are now identified by stable keys instead of display text
AskUserQuestion options are now identified by stable keys instead of their displayed text
found in this entry's text
-
v2.1.234
Command-line values that look like flags or URLs are quoted safely
Values that start with a dash or look like URLs are now passed safely as --flag=value.
found in this entry's text
-
v2.1.234
Spawned processes get
--flag=valuewhen the value looks like a flagPrompts and model names starting with a dash are no longer swallowed as options by subagents and background tasks.
found in this entry's text
-
v2.1.233
Windows suspicious-path detection covers flags and NT device paths
On Windows, risky paths hidden inside --flag=value arguments or NT device paths are now caught.
found in this entry's text
-
v2.1.224
Server-supplied CLI arguments are validated on self-hosted runners
Self-hosted runners now reject malformed or blocklisted CLI arguments handed down by the server.
found in this entry's text
-
v2.1.224
Start a cloud session on a self-hosted environment with
--environmentStart a cloud session on your own environment with claude --environment, plus hidden --ref and --on-branch companions.
found in this entry's text
-
v2.1.221
--cloud and --remote pre-parsing
The --cloud and --remote flags no longer get special early handling and go straight to the normal parser.
found in this entry's text
-
v2.1.221
CLI argument rewriting handles values that start with a dash
Flag values starting with a dash are no longer mangled into a separate flag.
found in this entry's text
-
v2.1.221
Background session names starting with "-" survive respawn
Background sessions renamed to something starting with a dash now restart correctly.
found in this entry's text
-
v2.1.212
Resume Session at Flag
found in this entry's text
-
v2.1.197
Alias-to-Canonical-ID Resolution for Persisted Model Preferences
found in this entry's text
-
v2.1.195
/config Inline Key=Value Shortcut
found in this entry's text
-
v2.1.181
/config key=value— Set Settings from the Command Linefound in this entry's text
- v2.1.96
-
v2.1.30
SDK Schema Documentation
found in this entry's text
-
v2.0.10
Environment Variable Parsing for MCP Commands
found in this entry's text
First cited
0No release's published evidence quotes this name. The ledger indexes the Evidence lines of every changelog on this site, so this says nobody here has ever quoted it; it says nothing about how old the name is.
Presence across releases
1Build by build
1One row per release since the first build this name was read out of. Absent means the build was read and the name was not in it, never mined means no bundle for that release was ever archived, and a declared type or a default is only ever what that release's own bundle stated.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.