Text of code.claude.com › docs › en › plugins › troubleshooting as Styx crawled it on Nov 20, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Troubleshoot plugins - Claude Code Docs

Documentation Index Fetch the complete documentation index at: /docs/llms.txt Use this file to discover all available pages before exploring further. Skip to main content Assistant Responses are generated using AI and may contain mistakes. This page lists error messages and symptoms for Claude Code plugins and for marketplaces, the catalogs Claude Code installs plugins from. Each entry gives the cause and one fix. Where a message names a plugin or marketplace, the entry shows a placeholder such as <name> instead.

Use this page whether you install plugins, build them, host a marketplace, or administer plugins for an organization. These cases are covered on other pages: Why scopes, the cache, and precedence behave the way they do : read Plugin loading reference Looking up a flag, field, or command : use the plugin commands reference , the manifest reference , or the marketplace reference A hooks module not loaded or hooks module did not load message : the plugin is a mod , so read The mod doesn’t load Search for the exact message you saw.

Each message is listed under the stage that produces it, which isn’t always the command you ran. For example, an install can fail because a marketplace is missing, so that message is under Add a marketplace . Find where /plugin runs /plugin is a command you type inside a running Claude Code terminal session, and it opens an interactive panel. The entries in this section cover the places where you can type it but it can’t run, and the command spellings that don’t exist. /plugin isn't available in this environment You typed /plugin somewhere other than a Claude Code terminal session, and Claude replied with this line instead of opening anything.

You get this reply in a session that has no terminal to draw the /plugin panel in: non-interactive mode with claude -p , the Agent SDK, the Claude desktop app’s Code tab, the VS Code extension panel, and the browser at claude.ai/code. In the VS Code extension panel, only a /plugin line with something after it, such as /plugin install <plugin>@<marketplace> , gets this reply. /plugin or /plugins typed alone opens the Manage plugins dialog.

Install the plugin from the surface you’re on instead: Claude desktop app, local or SSH session : use the Desktop app tab under Install a plugin VS Code extension : use the VS Code tab under Install a plugin Claude Code on the web, or a desktop cloud session : a cloud session has no plugin browser. See the Cloud session tab under Install a plugin for what a cloud session loads A terminal you have access to : run claude and type /plugin there, or run claude plugin install <plugin>@<marketplace> in your shell without starting a session When a terminal install works, /plugin prints an install summary that starts with ✓ Installed <plugin>. and claude plugin install prints Installed plugin: <plugin>@<marketplace> . zsh: no such file or directory: /plugin You typed /plugin ... at a shell prompt, and the shell reported that no file named /plugin exists.

Bash reports bash: /plugin: No such file or directory . /plugin is a command you type inside a Claude Code session, not at the shell prompt. Start a session and type the same command there: claude Then, at the Claude Code prompt: /plugin install <plugin>@<marketplace> A successful install prints a summary that starts with ✓ Installed <plugin>. If the install itself then fails, its message is under Add a marketplace or Install a plugin .

To install from the shell without starting a session, run claude plugin install <plugin>@<marketplace> instead. The term '/plugin' is not recognized as the name of a cmdlet You typed /plugin ... at a PowerShell prompt, and /plugin is a Claude Code command, not a program. Bash and Zsh report their own form of this error . Use either of these instead: Run claude , then type /plugin at the Claude Code prompt Run claude plugin install <plugin>@<marketplace> in PowerShell without starting a session claude: command not found after claude plugin ...

You ran claude plugin install ... in your shell, and the shell couldn’t find claude at all. On Windows the message is 'claude' is not recognized as the name of a cmdlet or 'claude' is not recognized as an internal or external command . The cause isn’t the plugin command. Follow Verify your PATH , then retry the plugin command. Unknown command and command spellings that don’t exist You typed a plugin command you saw somewhere and got Unknown command: /<name> in a session, or error: unknown command '<name>' or error: unknown option '<flag>' from the claude binary in your shell.

Several command spellings are in use that Claude Code doesn’t have. The table below maps each one to the real command. The plugin commands reference lists the subcommands and their flags. You typed What Claude Code says Use instead claude plugin add <source> error: unknown command 'add' claude plugin marketplace add <source> to add a marketplace, or claude plugin install <plugin>@<marketplace> to install a plugin claude plugin install <plugin> --project error: unknown option '--project' claude plugin install <plugin>@<marketplace> --scope project /install <plugin> Unknown command: /install /plugin install <plugin>@<marketplace> /plugin add <source> The /plugin panel opens on the Discover tab /plugin marketplace add <source> marketplace.anthropic.com as a source Invalid marketplace source format or That isn't a marketplace source anthropics/claude-plugins-official for the official marketplace These spellings look wrong but work: claude plugins is an alias of claude plugin claude plugin remove is an alias of claude plugin uninstall /plugins and /marketplace in a session open the same panel as /plugin Add a marketplace A marketplace is a catalog you add to Claude Code from a git repository, a URL, or a local path.

These entries cover the messages you get when adding one fails or a later refresh fails. Marketplace "claude-plugins-official" not found You ran /plugin install <plugin>@claude-plugins-official in a session, and Claude Code reported that it has no marketplace by that name. The official marketplace isn’t registered on this machine yet. Claude Code normally registers it on its own the first time you start an interactive terminal session.

It hasn’t run yet if you’ve only used Claude Code through the VS Code extension, and it skips or defers that step: When a policy blocks the source When CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL is set After a failed attempt that’s waiting to retry The claude plugin shell commands never register it for you. Add it, then retry the install: /plugin marketplace add anthropics/claude-plugins-official When the add works, /plugin marketplace list shows the marketplace.

For any other marketplace name in this message, see Marketplace "<name>" not found . The same string also appears in the /plugin Errors tab, the panel’s list of load failures, when a plugin listed in your settings names a marketplace you haven’t added. Marketplace "<name>" not found You ran /plugin install in a session and Claude Code reported that it has no marketplace by that name. Two forms of the command reach this message: /plugin install <plugin>@<name> : the install line, often one someone sent you, names a marketplace you haven’t added.

The rest of this entry covers finding and adding it. /plugin install <source> with a path, URL, or owner/repo : this form reports the message instead of installing, even for a source you’ve already added. To install from a source in one command, see Add a marketplace and install in one command . If the name starts with claudeai- , the marketplace is hosted on claude.ai, and you add it by name from your shell with claude plugin marketplace add --claudeai <name> .

See Add a marketplace from claude.ai . For any other name, an install line names a marketplace but doesn’t say where the marketplace is hosted, and Claude Code has no index to look a marketplace name up in. Ask

The rest of this page is on the live site.