prependPlugins
A Claude Code settings key, read out of the shipped bundle. It was in the build from v2.1.268 and was gone by v2.1.284.
Run your organization's mods before every mod a user installs
Anthropic's own wording. Read off All settings, captured 2026-11-06.
In the changelogs
12Releases whose published page names prependPlugins.
-
v2.1.311
Organizations can pin plugin hook code to known fingerprints
Managed settings can now list fingerprints of approved plugin releases, and a hooks plugin loads only from a folder that matches one
found in this entry's text
-
v2.1.311
Remote plugins can now get organization-level status
A remote plugin now gets organization-level status when managed settings name its digests under
pluginDigestsand list it inprependPluginsorappendPluginsfound in this entry's text
-
v2.1.295
New check on plugin settings loaded from machine-level files
Claude Code now checks plugin-related settings that come from settings files users cannot write to
found in this entry's text
-
v2.1.292
Reworked handling of organization plugin ordering, and stricter search errors
How
prependPluginsandappendPluginsare worked out has changed, and file search can now stop with an error when it cannot read its inputfound in this entry's text, named in this entry
-
v2.1.268
Managed plugin hook "seating" can now be driven by a managed
prependPluginslist, not just org tierManaged prependPlugins settings can now force the hooks-modules plugin to load first, not just org tier
found in this entry's text, named in this entry
-
v2.1.268
Managed plugins can pin hook ordering with prependPlugins/appendPlugins
Org admins can now pin specific plugins to run first or last among hooks
found in this entry's text, named in this entry
-
v2.1.268
Security-default hooks module opt-out changed from a boolean to a prependPlugins allowlist
Org opt-out for the built-in security-default hooks now uses a prependPlugins allowlist instead of a simple on/off setting
found in this entry's text, named in this entry
-
v2.1.267
User-writable settings files can no longer set secDefault/prependPlugins/appendPlugins or enable plugins via enabledPlugins
User-writable settings files can no longer set secDefault, prependPlugins, appendPlugins, or enable plugins
found in this entry's text
-
v2.1.267
Managed-policy plugin seating warnings for prepend/append conflicts
New warnings flag when a managed plugin's ordering or a settings key gets silently overridden by managed policy
found in this entry's text
-
v2.1.267
Managed-settings-only
secDefaultflag controls seating of the bundled sec-default pluginA new managed-settings-only flag lets organizations put their bundled sec-default plugin ahead of user-installed plugin hooks
found in this entry's text
-
v2.1.267
New prependPlugins/appendPlugins managed-settings keys
prependPlugins and appendPlugins now fall back to an empty list on malformed values
found in this entry's text
-
v2.1.259
Managed plugin ordering conflict warning
A managed plugin listed in both prepend and append lists now warns about the conflict and is prepended.
named in this entry, found in this entry's text
First cited
8The earliest release whose published evidence quoted prependPlugins was v2.1.259, 2 Sep 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
2 further spans in the ledger name it. The list above is the earliest first and stops at 6.
Presence across releases
2Build by build
48One 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.