用途:帮助开发者创建可分发的 Claude Code 插件,将命令、agents、skills、hooks、MCP 服务器和 LSP 服务器打包在一起。
主要能力与结构:插件根目录需包含 .claude-plugin/plugin.json 清单,组件放在插件根而非 .claude-plugin/ 内。commands/ 与 agents/ 为带 frontmatter 的 Markdown;skills/ 为含 SKILL.md 的子目录;hooks/hooks.json 为钩子配置;.mcp.json 与 .lsp.json 分别为 MCP 和 LSP 服务器配置,scripts/ 存放脚本。市场可包含多个插件,其根目录有 .claude-plugin/marketplace.json,新增插件必须登记在此文件中,否则无法安装。
用法:插件安装作用域有 user、project、local、managed 四种。常用命令包括 claude plugin install <plugin>@<marketplace> --scope user、claude plugin enable/disable/update/uninstall <插件>。路径应使用 ${CLAUDE_PLUGIN_ROOT} 变量。调试可用 claude --debug。
限制与注意:! 反引号有独立权限模型,复杂命令或脚本可能失败,建议改用 Bash 工具并配合 allowed-tools;插件被禁用时命令不显示,需启用后重启;本地改动可用 claude plugin update 或重装。最终检查需确保 plugin.json 含 name、version、description,组件位置正确,路径使用变量,脚本可执行。