Claude Code Plugin Architecture FAQs

Question 1

What is the required location for the plugin manifest?

Accepted Answer

The plugin.json manifest must be located within the .claude-plugin/ directory at the root of your plugin to be recognized by Claude Code.

Question 2

Can I use custom directory names for commands or agents?

Accepted Answer

Yes, while standard directories are scanned automatically, you can define custom paths in your plugin.json manifest using relative paths starting with './'.

Question 3

Do I need to restart Claude Code after updating my plugin structure?

Accepted Answer

No restart is typically required; changes to the manifest or component files take effect as soon as the plugin is re-enabled or a new session begins.

Question 4

How do I ensure my plugin paths work across different operating systems?

Accepted Answer

Always use the ${CLAUDE_PLUGIN_ROOT} environment variable for all internal path references in your manifest, scripts, and component files to avoid hardcoded absolute paths.

Question 5

What is the difference between a command and a skill in Claude Code?

Accepted Answer

Commands are explicitly triggered by users via slash commands, whereas skills are background capabilities that Claude activates autonomously based on the task context.

Claude Code Plugin Architecture

主要功能

使用场景

Claude Code Plugin Architecture

主要功能

使用场景