Claude Code Plugin Development FAQs

Question 1

What are the different installation scopes for plugins?

Accepted Answer

Plugins support four scopes: user (personal settings), project (committed to version control), local (project-specific but gitignored), and managed (read-only admin settings).

Question 2

What components can I include in a Claude Code plugin?

Accepted Answer

A plugin can bundle slash commands, subagents, skills, hooks, MCP (Model Context Protocol) servers, and LSP (Language Server Protocol) servers into a single distributable package.

Question 3

Where should I place the plugin.json file?

Accepted Answer

The plugin.json manifest must be located inside a directory named .claude-plugin at the root of your plugin folder. All other components like commands or scripts should stay at the root.

Question 4

How do I verify if my plugin is loaded correctly?

Accepted Answer

You can use the 'claude --debug' command to view the initialization logs and verify that your plugin and its components have been successfully registered.

Question 5

How do I handle script permission errors in plugins?

Accepted Answer

Avoid using exclamation backticks for complex scripts. Instead, use the Bash tool and explicitly define the script path in the allowed-tools section of your component's frontmatter.

Claude Code Plugin Development

Key Features

Use Cases

Claude Code Plugin Development

Key Features

Use Cases