Plugin commands reference changedplugins/cli-reference
Nearest release: v2.1.305, published an hour after 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 20 Oct 2026 18:25 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 20 Oct 2026 18:37 UTC.
Upstream edited
Recorded here
Lines+26added
Lines−22removed
From line
6
where the diff opens
First seen
25 Sep 2026
this site's first read of the page
Recorded edits18to this page, all time
#### JSON result format ## /plugin in a session ## /reload-plugins
The whole hunk
from line 6, old and new numbered
/
from line 6
66
77The tables below list each subcommand's commonly used options, not every option. Run `claude plugin --help` in your shell to see which subcommands your version has, and `claude plugin <subcommand> --help` for a subcommand's full option list.
88
9<Note>
10 These cases are covered on other pages:
9> [!NOTE]
10>
11> These cases are covered on other pages:
12>
13> * **Install and manage steps, and where `/plugin` runs**: see [Install and manage plugins](/docs/en/plugins/install)
14> * **What a command changes on disk and which scope takes precedence**: see [Plugin loading reference](/docs/en/plugins/loading)
15> * **What an error message means**: see [Troubleshoot plugins](/docs/en/plugins/troubleshooting)
1116
12 * **Install and manage steps, and where `/plugin` runs**: see [Install and manage plugins](/docs/en/plugins/install)
13 * **What a command changes on disk and which scope takes precedence**: see [Plugin loading reference](/docs/en/plugins/loading)
14 * **What an error message means**: see [Troubleshoot plugins](/docs/en/plugins/troubleshooting)
15</Note>
16
1717## claude plugin commands
1818
1919Run `claude plugin <subcommand>` from your shell or a script, outside a Claude Code session. These subcommands install and manage plugins without opening the [`/plugin`](#plugin-in-a-session) panel.
from line 102
102102* **You decline a command-source prompt**: the output is `Aborted.` and the exit code is `1`
103103* **You decline a `headersHelper` prompt, or it can't be confirmed without a TTY**: the output is `Aborted — the command was not run.` and the exit code is `1`
104104
105<h4 id="plugin-json-result">
106 JSON result format
107</h4>
105#### JSON result format
108106
109107When you pass `--json` to `plugin install`, the last line of stdout is one JSON object. Parse only that line, because Claude Code prints any command the marketplace declares ahead of it.
110108
from line 372
374372
375373For what the two cost figures mean, see [Measure plugin cost and usage](/docs/en/plugins/measure).
376374
377For a plugin that isn't loaded, Claude Code prints ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` and exits `1`.
375For a plugin that isn't loaded, Claude Code prints this message and exits `1`:
378376
377```text theme={null}
378Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.
379```
380
381An ID that ends in `@builtin` names one of the [plugins built into Claude Code](/docs/en/plugins/mods/overview#mods-built-into-claude-code). If you pass such an ID and Claude Code doesn't find that plugin, the message reads instead:
382
383```text theme={null}
384Plugin "<name>@builtin" not found. Built-in plugins don't appear in `claude plugin list`. To see the ones available in a session, run /plugin in Claude Code and open the Installed tab.
385```
386
379387### plugin configure
380388
381389Show an installed plugin's [`userConfig`](/docs/en/plugins/manifest-reference#user-configuration) options and which are set, or save values piped in on stdin. Requires Claude Code v2.1.285 or later.
from line 748
740748
741749Remove a marketplace's declaration from your settings. `rm` is an alias for `remove`.
742750
743<Warning>
744 When you remove a marketplace from the last scope that declares it, Claude Code also deletes its cache and uninstalls every plugin you installed from it. It also deletes their saved [options and secrets](/docs/en/plugins/manifest-reference#user-configuration) and [data](/docs/en/plugins/components#path-variables-and-persistent-data) where it can.
751> [!WARNING]
752>
753> When you remove a marketplace from the last scope that declares it, Claude Code also deletes its cache and uninstalls every plugin you installed from it. It also deletes their saved [options and secrets](/docs/en/plugins/manifest-reference#user-configuration) and [data](/docs/en/plugins/components#path-variables-and-persistent-data) where it can.
754>
755> To refresh a marketplace without losing its plugins, run `plugin marketplace update` instead.
745756
746 To refresh a marketplace without losing its plugins, run `plugin marketplace update` instead.
747</Warning>
748
749757```bash theme={null}
750758claude plugin marketplace remove <name> [options]
751759```
from line 795
787795
788796Claude Code prints `Successfully updated marketplace: your-marketplace`. When you omit the name, it prints a count such as `Successfully updated 2 marketplaces`.
789797
790<h2 id="plugin-in-a-session">
791 /plugin in a session
792</h2>
798## /plugin in a session
793799
794800Inside an interactive session, `/plugin` opens the plugin panel. Each subcommand opens the panel on a tab, runs an action there, or prints a result inline. `/plugins` and `/marketplace` are aliases for `/plugin`.
795801
from line 832
826832
827833If you name a plugin that isn't installed in the current project in `/plugin enable`, `disable`, `uninstall`, or `configure`, Claude Code prints `Plugin "<plugin>" is not installed in this project` instead of acting.
828834
829<h2 id="reload-plugins">
830 /reload-plugins
831</h2>
835## /reload-plugins
832836
833837Apply pending plugin changes to the running session without restarting it. Pending changes are plugins you installed, updated, enabled, disabled, or edited on disk since the session started.
834838
No line in this hunk matches that.