Follow Discord
Sweep 10 Nov 2026 · 02:18Z Build v2.1.322 539 read Stable v2.1.311 Latest v2.1.322 Next v2.1.322 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Code CLI 10 Nov 2026
One change · claude-code

Plugin loading reference changedplugins/loading

Nearest release: v2.1.322, published 15 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 10 Nov 2026 17:51 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 10 Nov 2026 18:07 UTC.

Upstream edited
Recorded here
Lines+14added
Lines−0removed
From line 169 where the diff opens
First seen 25 Sep 2026 this site's first read of the page
Recorded edits20to this page, all time

### Enabled in an `--add-dir` directory but not loaded

The whole hunk

from line 169, old and new numbered
/
lines
from line 169
169169 
170170To opt out of a project-enabled plugin on your machine, set the id to `false` in `.claude/settings.local.json`, which has higher precedence than the project file.
171171 
172### Enabled in an `--add-dir` directory but not loaded
173 
174Claude Code reads an `enabledPlugins` entry of `true` in one of the added directory's files only when that file's setting sources are on:
175 
176* **`.claude/settings.json`**: `project`
177* **`.claude/settings.local.json`**: `project` and `local`
178 
179Check which setting sources the session loads. You set them with [`--setting-sources`](https://code.claude.com/docs/en/cli-reference#cli-flags). In the CLI, `user`, `project`, and `local` are all on by default.
180 
181For example, if you run `claude --setting-sources user --add-dir ./shared` in your shell, Claude Code reads neither file in `./shared`. Pass the flag for the file that holds the `true`:
182 
183* **`settings.json`**: `--setting-sources user,project`
184* **`settings.local.json`**: `--setting-sources user,project,local`
185 
172186### Enabled in project settings but not installed
173187 
174188By default, a plugin enabled only in your project's `.claude/settings.json` doesn't load at session start until you install it on your machine. With the marketplace on your machine, the `/plugin` **Errors** tab shows [`Plugin "<name>" is enabled in project settings but isn't installed here`](https://code.claude.com/docs/en/plugins/troubleshooting#plugin-is-enabled-in-project-settings-but-isnt-installed-here) or [`Plugin "<name>" not cached at <path>`](https://code.claude.com/docs/en/plugins/troubleshooting#plugin-not-cached-at).
Feedback