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.
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…