Unclear behavior when same plugin loaded via marketplace and --plugin-dir
Resolved 💬 3 comments Opened Mar 17, 2026 by emmahyde Closed Mar 21, 2026
Summary
When a plugin is installed from a marketplace and loaded locally via --plugin-dir, it's unclear whether Claude Code deduplicates them or loads both copies simultaneously.
Context
From our internal repo:
If you still have the marketplace version of the same plugin installed, both copies will be active at once. This can cause confusing behavior (duplicate skills, commands, etc.).
We observed this while documenting local plugin development workflows. A teammate questioned whether this is actually the case, or if Claude Code handles deduplication.
Expected behavior
One of:
- Claude Code deduplicates plugins by name, preferring
--plugin-dir(local) over marketplace — and this is documented - Claude Code warns the user when a duplicate plugin is detected
- Claude Code loads both copies (current suspected behavior) — if intentional, this should be documented
Steps to reproduce
- Install a plugin from a marketplace:
/plugin marketplace add <marketplace-repo> - Clone the same marketplace repo locally
- Run
claude --plugin-dir plugins/<same-plugin> - Observe whether skills, hooks, and commands from the plugin appear once or twice
Environment
- Claude Code CLI (latest)
- macOS
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗