How to Install & Use Claude Code Plugins (2026)
Learning how to install Claude Code plugins takes one command, and using them takes none — once a plugin is installed, its capabilities are simply there. A plugin bundles skills, subagents, hooks, and MCP servers into a single package you add from a marketplace; installing it makes all of that available at once. This tutorial covers the whole loop: how plugins work, how to install them from the official and other marketplaces, how to use what they add, how to manage them, and how to fix the occasional snag.
If you want the bigger picture first — what plugins are and what they can bundle — see our complete guide to Claude Code plugins. Otherwise, let's install one.
Key Takeaways
If you remember nothing else:
- Install with
/plugin install <name>@<marketplace>— the official marketplace is auto-registered, so@claude-plugins-officialworks immediately- For any other marketplace, add it first:
/plugin marketplace add <owner>/<repo>(a marketplace is just a git repo)- After installing, a plugin's skills, commands, MCP tools, and hooks are live — skills run automatically or as
/plugin-name:skill-name/pluginopens an interactive manager to browse, enable, disable, and update/reload-pluginsapplies changes without restarting- Most problems are a stale marketplace — fix with
/plugin marketplace update <name>
Table of Contents
- How Plugins Work: A 30-Second Primer
- How to Install Claude Code Plugins
- How to Use Claude Code Plugins
- Managing Plugins
- Troubleshooting
- Conclusion
How Plugins Work: A 30-Second Primer
Two ideas make installing a plugin make sense:
- A marketplace is a git repository with a catalog of plugins. There is no central gatekeeper — Anthropic hosts official ones, the community hosts public ones, and teams host private ones. To install a plugin you name both the plugin and its marketplace:
plugin-name@marketplace-name. - Plugin skills are namespaced. A skill from a plugin called
my-toolsis invoked as/my-tools:review, never a bare/review, so plugins from many authors never collide.
The one shortcut worth knowing: Anthropic's official marketplace, claude-plugins-official, is registered automatically the first time you launch Claude Code, so you can install from it with no setup at all.
How to Install Claude Code Plugins
There are two paths, depending on where the plugin lives.
From the official marketplace (one command)
Because claude-plugins-official is already registered, installing an official plugin is a single line:
/plugin install code-review@claude-plugins-official
That works immediately for any first-party or vetted-partner plugin. Browse the full first-party set in our guide to the official Claude Code plugins.
From any other marketplace (add, then install)
For a community or third-party plugin, add its marketplace first — remember, that is just a git repo — then install with the @<marketplace> suffix:
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
Anthropic's public community marketplace works the same way:
/plugin marketplace add anthropics/claude-plugins-community
/plugin install <plugin-name>@claude-community
From the interactive manager
Prefer to browse? Run /plugin on its own to open the manager, where you can search available plugins, read what each one does, and install with a keystroke — no need to remember exact names. To understand the marketplace system itself — official, community, and independent directories — see our Claude Code plugins marketplace guide. And for a shortlist of what is actually worth installing, see our tested best Claude Code plugins roundup.
How to Use Claude Code Plugins
Here is the good news: there is no separate "use" step. Once a plugin is installed and enabled, everything it bundles is live. What that means in practice depends on what the plugin ships:
- Skills — run automatically when your request matches their description, or directly by typing their namespaced command,
/plugin-name:skill-name. Type/to see every command available in your session. - MCP servers — connect on load, so Claude can call the external tools and data they expose (a GitHub API, a database, a design tool) without any extra step.
- Hooks — fire on the events they target, such as running on every commit or after a tool call.
- Slash commands and output styles — become available to invoke or select immediately.
For example, install the github plugin and Claude can suddenly read your issues and open pull requests; install a language-server plugin and it gains real-time type errors for your code; install frontend-design and its guidance shapes any UI it writes. You did not change how you work — the plugin simply widened what Claude can do.
So "using" a plugin is mostly a matter of doing your normal work and letting its capabilities kick in — ask Claude to do something a plugin covers, and the plugin handles it. To confirm a plugin is active, open /plugin and check it is enabled, or invoke one of its commands directly. If you install a plugin mid-session, run /reload-plugins so its components register right away.
Managing Plugins
Day-to-day management lives in a few commands:
| Command | What it does |
|---|---|
/plugin |
Opens the interactive manager (browse, enable, disable, update, uninstall) |
/plugin install <name>@<marketplace> |
Installs a plugin |
/plugin marketplace add <owner>/<repo> |
Registers a marketplace from a git repo |
/plugin marketplace update <name> |
Refreshes a marketplace's catalog |
/reload-plugins |
Applies plugin changes without restarting |
Disabling a plugin keeps it installed but turns it off; uninstalling removes it. Both are one action in the /plugin manager, and /reload-plugins makes the change take effect right away.
Troubleshooting
Almost every plugin issue is one of these:
- "Plugin not found" on install. Your marketplace catalog is stale. Run
/plugin marketplace update <name>and retry, and double-check thename@marketplacespelling. marketplace addfails. Confirm theowner/repois correct and public (or that you have access to a private repo). A marketplace must contain a valid catalog file.- The plugin seems installed but does nothing. Make sure it is enabled in the
/pluginmanager, then run/reload-plugins. A disabled plugin stays installed but inactive. - A slash command has an unexpected prefix. That is namespacing — plugin skills are always
/plugin-name:skill-name, never a bare name. - A partner/MCP plugin can't reach its service. It likely needs credentials — an API key or login for the external tool it connects to.
Conclusion
Installing a Claude Code plugin is a one-liner: /plugin install <name>@claude-plugins-official for official plugins, or /plugin marketplace add <owner>/<repo> then /plugin install for anything else. Using one takes no extra effort — its skills, MCP tools, and hooks are live the moment it is enabled. And when something misbehaves, the fix is almost always /plugin marketplace update or /reload-plugins.
From here, pick your stack with the tested best Claude Code plugins, browse the first-party set in the official Claude Code plugins list, and — since plugins bundle skills — see how to add skills to Claude Code for the skill side of the story.
Related Resources
Frequently Asked Questions
-
Run /plugin install
@ . For Anthropic's official plugins the marketplace is registered automatically, so /plugin install code-review@claude-plugins-official works out of the box. For a plugin from any other marketplace, first add the marketplace with /plugin marketplace add / , then install it with /plugin install @ . You can also run /plugin on its own to browse and install from an interactive manager. -
Once a plugin is enabled, its components are live. Any skills it adds work automatically when your request matches their description, or you can invoke them directly as /plugin-name:skill-name (plugin skills are namespaced). MCP servers the plugin ships connect on load so Claude can call their tools, and any hooks fire on the events they target. In short, you install once and the plugin's capabilities are simply available.
-
Only for non-official plugins. Anthropic's official marketplace, claude-plugins-official, is registered automatically the first time you launch Claude Code, so you can install from it immediately. For a community or third-party plugin, add its marketplace first with /plugin marketplace add
/ — a marketplace is just a git repository — and then install with the @ suffix. -
Open the interactive manager with /plugin, where you can enable, disable, update, or uninstall any plugin. To refresh a marketplace's catalog before updating, run /plugin marketplace update
. After any change, /reload-plugins applies it without restarting Claude Code. Disabling a plugin keeps it installed but inactive; uninstalling removes it entirely. -
Start with the official marketplace — run /plugin to browse everything in claude-plugins-official, which holds 200-plus vetted plugins. For curated recommendations, see our tested best Claude Code plugins roundup and the official Claude Code plugins list. Independent directories index thousands more community plugins, each installable by adding its marketplace.
-
The usual causes are simple. If an install fails with "not found," your marketplace catalog is stale — run /plugin marketplace update
and check the name@marketplace spelling. If an installed plugin seems inactive, confirm it is enabled in the /plugin manager and run /reload-plugins. If a slash command has an unexpected prefix, that is namespacing: plugin skills are always invoked as /plugin-name:skill-name.
Join 50k+ subscribers
Web dev, SaaS, growth & marketing. Weekly.
Keep Learning
More articles you might find interesting.