用途:帮助理解与排查 Claude Code 的插件注册表。当插件显示“已安装”却不工作、需要理解插件作用域、修复孤立注册表条目或调试安装失败时使用;新建插件配置、配置插件权限、创建插件工作流等场景应改用其他技能。
注册表位置:~/.claude/plugins/installed_plugins.json,记录所有项目下已安装的插件。结构为 v2,含 version 与 plugins 对象,键格式为 {plugin-name}@{marketplace-name},每个键映射一个安装数组,支持多作用域。字段包括 scope(project 或 user)、projectPath(仅 project)、installPath、version、installedAt、lastUpdated、gitCommitSha。
安装作用域:用户作用域为默认全局,命令 /plugin install my-plugin@marketplace,注册表 scope 为 user,无 projectPath,所有项目可用;项目作用域命令为 /plugin install my-plugin@marketplace --scope project,scope 为 project 并带 projectPath,仅应在该项目生效。已知问题 #14202:项目作用域插件在其他项目仍显示为已安装,原因是 projectPath 检查不一致,可手动编辑注册表为当前项目添加条目作为变通。
常用操作:查看注册表 jq . ~/.claude/plugins/installed_plugins.json;列出插件 jq -r '.plugins | keys[]' ~/.claude/plugins/installed_plugins.json;查找项目作用域插件 jq '.plugins | to_entries[] | .value[] | select(.scope == "project") | {projectPath, version}' ~/.claude/plugins/installed_plugins.json;备份 cp ~/.claude/plugins/installed_plugins.json ~/.claude/plugins/installed_plugins.json.backup。修复时用 Read 工具读取注册表,备份后删除孤立条目或添加当前项目条目,再用 Write 工具写回。项目作用域插件还需在 .claude/settings.json 的 enabledPlugins 中登记,否则不会加载。
限制:修改注册表后需重启 Claude Code 才生效;注册表损坏时可从备份恢复或删除后重装。具体收费与平台信息暂未提供。