# How to install Claude Code plugins from a marketplace

> Canonical: https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/
> Author: MohammadMD1383 (https://github.com/MohammadMD1383) · Updated: 2026-10-04 · License: MIT

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

```text
/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.

## On this page

1. [Install inside a Claude Code session](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#session)
2. [Install from your shell](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#shell)
3. [Choose a scope (user, project, local)](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#scope)
4. [Configure a plugin](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#configure)
5. [Update plugins](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#update)
6. [Disable or uninstall](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#remove)
7. [Check what a plugin does first](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#trust)
8. [Troubleshooting](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#troubleshooting)
9. [FAQ](https://mohammadmd1383.github.io/claude-plugins/guides/install-claude-code-plugins/#faq)

## 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`.

  ```text
  /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.**

  ```text
  /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:

```text
/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:

```bash
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

| Scope | Who gets it | Where it's recorded |
| --- | --- | --- |
| **user** (default) | You, in every project. | Your user settings. |
| **project** | Everyone working in this repository. | `.claude/settings.json`, which you commit. |
| **local** | You, in this repository only. | Local, uncommitted project settings. |

```bash
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:

```bash
# 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:

```bash
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

```bash
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:

- Read the plugin's README and source. Good plugins document what they run, read, write and send over the network, like the privacy sections of [usage-guard](https://mohammadmd1383.github.io/claude-plugins/plugins/usage-guard/#privacy-network-and-files).
- Run `claude plugin details <name>` to see the plugin's components and its *Always-on* token cost: the tokens it adds to every session where it is enabled.

## Troubleshooting

- **The install can't find the plugin:** use the marketplace's registered name after `@` (`mohammadmd-plugins`), not the repository name. `claude plugin marketplace list` shows the names.
- **The plugin installed but does nothing:** open the **Errors** tab in `/plugin`, and run `/reload-plugins` or restart Claude Code.
- **A mod doesn't appear:** mods (plugins that draw into the interface, like usage-bar) need a recent Claude Code; usage-bar needs 2.1.288 or later. Check with `claude --version`.
- **Hooks fail on Windows:** plugins that use scripts need their runtime. usage-guard needs Python 3 on `PATH`.
- **Plugins missing in the cloud:** cloud sessions, including claude.ai/code in the browser, don't load the plugins installed on your own machine.

## 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

- [Claude Code docs: Install and manage plugins](https://code.claude.com/docs/en/discover-plugins)
- [Claude Code docs: Plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces)

## Related

- [usage-guardUsage-limit awareness and hand-off for Claude.](https://mohammadmd1383.github.io/claude-plugins/plugins/usage-guard/)
- [usage-barContext and limits above the prompt.](https://mohammadmd1383.github.io/claude-plugins/plugins/usage-bar/)
- [Claude Code usage limits explainedThe 5-hour and weekly windows.](https://mohammadmd1383.github.io/claude-plugins/guides/claude-code-usage-limits/)
