claude-plugins

How to install Claude Code plugins from a marketplace

By MohammadMD1383 · Updated

Claude Code plugins add commands, skills, hooks and interface mods to Claude Code. They are distributed through marketplaces: catalogs, usually a GitHub repository, that list one or more plugins. You add a marketplace once, then install any plugin from it.

Quick version

/plugin marketplace add MohammadMD1383/claude-plugins
/plugin install usage-guard@mohammadmd-plugins

The general form is /plugin marketplace add <owner/repo>, then /plugin install <plugin>@<marketplace>, where <marketplace> is the name the marketplace registers under (here mohammadmd-plugins), not the repository name.

Install inside a Claude Code session

  1. Add the marketplace. The source can be a GitHub owner/repo, any git URL, a local directory or a hosted marketplace.json.
    /plugin marketplace add MohammadMD1383/claude-plugins

    On success Claude Code prints Successfully added marketplace: mohammadmd-plugins. Add #ref to pin a branch or tag, for example owner/repo#v1.2.0.

  2. Install the plugin.
    /plugin install usage-bar@mohammadmd-plugins

    In a session this opens the plugin's details in the /plugin panel, so you can review what it adds and pick a scope before confirming.

  3. Or browse. Run /plugin with no arguments. The Discover tab lists plugins from all your marketplaces; type to search and press Enter to open one.
  4. Check it loaded. The Installed tab in /plugin lists the plugin with its scope. A plugin's commands appear namespaced, for example /usage-guard:status.

On Claude Code v2.1.275 or later you can add the marketplace and install in one step:

/plugin install usage-guard --marketplace MohammadMD1383/claude-plugins

Install from your shell

The same operations work as ordinary terminal commands, which is handy for setup scripts and dotfiles:

claude plugin marketplace add MohammadMD1383/claude-plugins
claude plugin install usage-guard@mohammadmd-plugins
claude plugin install usage-bar@mohammadmd-plugins
claude plugin list

Plugins installed from the shell load the next time you start Claude Code, or in an open session after you run /reload-plugins. In claude -p and other non-interactive runs, /plugin isn't available, but plugins you already installed do load.

Choose a scope

ScopeWho gets itWhere it's recorded
user (default)You, in every project.Your user settings.
projectEveryone working in this repository..claude/settings.json, which you commit.
localYou, in this repository only.Local, uncommitted project settings.
claude plugin install usage-guard@mohammadmd-plugins --scope project

Committing a project-scoped plugin turns it on for collaborators but doesn't download it to their machines; each collaborator runs the install command once. When a plugin is set at several scopes, local overrides project, and project overrides user.

Configure a plugin

Plugins can declare options. You are prompted for the main ones when you enable the plugin, and can change them later in /config or from the plugin's Configure options item on the Installed tab. From the shell:

# show a plugin's options and which are unset
claude plugin configure usage-bar@mohammadmd-plugins

# set options at install time
claude plugin install usage-bar@mohammadmd-plugins --config show_meters=false

Update plugins

Auto-update is on by default only for Anthropic's official marketplaces. For community and third-party marketplaces such as this one it is off; turn it on in /plugin → Marketplaces → select the marketplace → Enable auto-update.

To update now:

claude plugin update usage-guard@mohammadmd-plugins

Or open /plugin → Marketplaces, select the marketplace and choose Update marketplace to update every plugin you installed from it. Note that claude plugin marketplace update on its own only refreshes listings and leaves installed plugins at their current versions. A running session keeps the version it loaded until you run /reload-plugins or start a new session.

Disable or uninstall

claude plugin disable usage-bar@mohammadmd-plugins
claude plugin enable usage-bar@mohammadmd-plugins
claude plugin uninstall usage-bar@mohammadmd-plugins            # add --keep-data to keep its data
claude plugin marketplace remove mohammadmd-plugins             # also uninstalls its plugins

Inside a session, /plugin enable, /plugin disable and /plugin uninstall open the panel to make the same change.

Check what a plugin does first

A plugin can run hooks, scripts and MCP servers on your machine, so install only from sources you trust and read the details pane before confirming. Two habits help:

Troubleshooting

FAQ

What is a Claude Code plugin marketplace?

A marketplace is a catalog of plugins described by a .claude-plugin/marketplace.json file, usually in a git repository. You add it once with /plugin marketplace add, and its plugins then install with /plugin install plugin@marketplace.

Can I install a Claude Code plugin without opening a session?

Yes. Run claude plugin marketplace add and claude plugin install in your shell. The plugin loads the next time you start Claude Code.

How do I share a plugin with my team?

Install it with --scope project. That records it in .claude/settings.json, which you commit. Each collaborator then runs the same install command once.

Do plugins update automatically?

Only when auto-update is on for their marketplace. It is on by default for Anthropic's official marketplaces and off for third-party ones; turn it on from the Marketplaces tab in /plugin.

Sources