Quick Start

Getting Started with Plugins

Install Claude Code plugins directly from GitHub repositories in just two simple commands.

Quick Start (2 Minutes)

Find a Plugin

Browse the plugin directory and click on any plugin to view its detail page with installation instructions

Browse Plugin Directory

Add the GitHub Repository

On the plugin detail page, copy the first command to add the repository

/plugin marketplace add owner/repo

Replace owner/repo with the actual GitHub path (e.g., anthropics/sugar).

A "marketplace" in Claude Code is a JSON catalog that lists available plugins. When you add a GitHub repository, you're registering it as a plugin source for discovery and installation.

Install the Plugin

Copy the second command from the plugin detail page. The command includes both the plugin name and marketplace name.

/plugin install plugin-name@marketplace-name

Replace plugin-name and marketplace-name with the values shown on the plugin detail page.

You're All Set!

The plugin's commands, agents, skills, and integrations are now available in Claude Code. Check the plugin's README for usage instructions.

Example Installation

To install a plugin from anthropics/sugar:

/plugin marketplace add anthropics/sugar

/plugin install sugar@sugar

Managing Your Plugins

Use these commands to manage installed plugins:

List All Plugins

/plugin list

See all installed plugins and their status

Enable a Plugin

/plugin enable plugin-name

Activate a previously disabled plugin

Disable a Plugin

/plugin disable plugin-name

Temporarily turn off a plugin without uninstalling

Uninstall a Plugin

/plugin uninstall plugin-name

Completely remove a plugin from your system

Pro Tip: Context Management

Disable plugins when working on unrelated projects to keep your context clean and focused. Enable them again when you need them.

Installation Scopes

When installing plugins, you can choose where they're stored using the --scope flag. This controls who can use the plugin and whether it's shared via version control.

User Scope

(default)

/plugin install plugin-name@marketplace-name --scope user

Personal plugins available across all your projects

Stored in: ~/.claude/settings.json

Project Scope

/plugin install plugin-name@marketplace-name --scope project

Team plugins shared via version control with all collaborators

Stored in: .claude/settings.json

Local Scope

/plugin install plugin-name@marketplace-name --scope local

Project-specific plugins, gitignored and not shared

Stored in: .claude/settings.local.json

Managed Scope

Enterprise-managed plugins installed by administrators (read-only)

Stored in: managed-settings.json

When to Use Each Scope

User: Plugins you want everywhere (personal productivity tools)
Project: Plugins your team should all have (project-specific workflows)
Local: Plugins for your personal use in one project (experimental or personal preferences)

Common Issues

Plugin not found after installation

Make sure you added the GitHub repository first with /plugin marketplace add owner/repo. Then install the plugin using its name exactly as shown on the plugin detail page.

Commands not showing up

After installing a plugin, you may need to reload Claude Code. Check if the plugin is enabled with /plugin list.

MCP servers not connecting

Some plugins require additional configuration for MCP servers (API keys, credentials, etc.). Check the plugin's README for setup instructions.

Next Steps

Now that you know how to install plugins, learn about safety and how to evaluate plugins.

Learn About Safety Browse Plugins