Unclear It is not clear what the new directory-related failure reasons check.
What
claude plugin install and claude plugin uninstall now read the install records first (the saved list of which plugins are installed and where from). If those records cannot be read, the command stops with the failure code install_records_unreadable and a message saying the plugin was not installed, or was not uninstalled, instead of carrying on.
Install can also now fail for these reasons:
- "installed-list-held"
- "directory-binding-unreadable"
- "directory-identity-changed"
Uninstall also changed:
- If you give a full
plugin@marketplaceid and that exact id is recorded, it uses that one. - It now works out which other installed copies share the same plugin name from the registry. Before, it treated that list as empty.
Why
This stops installs and removals from building on top of damaged records, which could otherwise leave plugins in a muddled state.
Names in the bundleclaude plugin installclaude plugin uninstall
claude plugin install
Error reference modified, high confidence
When a marketplace is already registered under such a name, its entry stops loading, and `/plugin`, `claude plugin install`, and `claude plugin update` warn:see the edit
claude plugin install
Create and distribute a plugin marketplace modified, high confidence
A third-party marketplace already registered under a reserved name or another spelling of one also stops loading. With a reserved name, you see the [registered from an untrusted source](/docs/en/errors#marketplace-is-registered-from-an-unt…see the edit
claude plugin install
CLI reference modified, high confidence
| `claude plugin` | Manage Claude Code [plugins](/docs/en/plugins/overview). Alias: `claude plugins`. See [plugin reference](/docs/en/plugins/cli-reference#claude-plugin-commands) for subcommands | `claude plugin install code-review@claude…see the edit
claude plugin install
Week 37 · September 7–11, 2026 modified, medium confidence
<div>Pass `--json` to <code>claude plugin install</code>, <code>uninstall</code>, <code>update</code>, <code>enable</code>, or <code>disable</code> to print the result as <a href="/docs/en/plugins/cli-reference#plugin-json-result">one JSON…see the edit
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.
Added since
A small documentation edit on Plugin commands reference touched a line naming claude plugin install after this was published.
Run `claude plugin install --help` in your shell to see every option your version supports.plugins/cli-reference see the edit
Added since
A small documentation edit on Error reference touched a line naming claude plugin uninstall after this was published.
You ran [`claude plugin uninstall`](/docs/en/plugins/cli-reference#plugin-uninstall), or chose **Uninstall** in the `/plugin` **Installed** tab, and the uninstall stopped with a message starting `"<plugin>" was not uninstalled:`. If the te…errors see the edit
Confirmed since
Anthropic's documentation has since written up claude plugin install, on Claude Code changelog.
* Fixed a failed first `claude plugin install` leaving the plugin enabled and recorded when a dependency's version range could not be metchangelog see the edit
Confirmed since
Anthropic's documentation has since written up claude plugin uninstall, on Error reference.
You ran [`claude plugin uninstall`](/docs/en/plugins/cli-reference#plugin-uninstall), or chose **Uninstall** in the `/plugin` **Installed** tab, and the uninstall stopped with a message starting `"<plugin>" was not uninstalled:`.errors see the edit
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubt
It is not clear what the new directory-related failure reasons check.
Anthropic's documentation agrees
claude plugin install on Error reference
Anthropic's release notes agree
Fixed claude plugin uninstall removing the other of two installed plugins whose ids differ only in case, with its options and secrets, when…