[DOCS] Settings docs missing `--add-dir` interaction with `enabledPlugins` and `extraKnownMarketplaces`

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

"Plugin settings" section (enabledPlugins and extraKnownMarketplaces) and --add-dir documentation

Current Documentation

The enabledPlugins documentation describes scoping to user/project/local settings files:

Controls which plugins are enabled. Format: "plugin-name@marketplace-name": true/false

The extraKnownMarketplaces documentation describes it as a repository-level settings feature:

Defines additional marketplaces that should be made available for the repository. Typically used in repository-level settings to ensure team members have access to required plugin sources.

The --add-dir documentation across multiple pages describes it for file access, skills loading, and CLAUDE.md loading. None mention plugin/marketplace settings.

What's Wrong or Missing?

Claude Code v2.1.45 added support for reading enabledPlugins and extraKnownMarketplaces from --add-dir directories. This means when a user adds a directory via --add-dir (or the additionalDirectories setting), Claude Code now reads .claude/settings.json from those directories and picks up plugin and marketplace configuration.

This interaction is undocumented:

• The --add-dir docs don't mention that plugin settings are loaded from additional directories
• The enabledPlugins docs don't mention --add-dir as a source for plugin configuration
• The extraKnownMarketplaces docs don't mention --add-dir as a source for marketplace definitions

Suggested Improvement

Document this interaction in two locations:

A. In the enabledPlugins and extraKnownMarketplaces sections of the settings page, add a note that these settings are also read from directories added via --add-dir or the additionalDirectories setting.

B. In the --add-dir / additionalDirectories documentation, expand the list of what gets loaded from additional directories to include plugin settings (enabledPlugins, extraKnownMarketplaces) alongside the existing items (file access, skills, CLAUDE.md).

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | enabledPlugins and extraKnownMarketplaces sections — no mention of --add-dir |
| https://code.claude.com/docs/en/cli-reference | --add-dir flag description — no mention of plugin settings |
| https://code.claude.com/docs/en/memory | --add-dir CLAUDE.md loading — no mention of plugin settings |
| https://code.claude.com/docs/en/permissions | --add-dir scope extension — no mention of plugin settings |

Total scope: 4 pages affected

Source: Changelog v2.1.45 — "Added support for reading enabledPlugins and extraKnownMarketplaces from --add-dir directories"

Related issues (not duplicates):

• #23404 — --add-dir docs missing .claude/skills/ loading behavior (different scope: skills vs plugins)
• #13097 — extraKnownMarketplaces trust dialog in CI/headless mode (different scope: trust dialog vs --add-dir)