| name | fix-plugins |
| description | 修复 Claude Code 插件和 HUD 状态栏。当插件斜杠命令不可用、HUD 不显示、或插件系统异常时使用。 |
插件修复技能
检查并修复 Claude Code 插件系统,使所有已安装插件恢复可用。
执行步骤
Step 1: 诊断插件状态
- 读取
~/.claude/settings.json,记录现有 enabledPlugins(可能缺失)
- 读取
~/.claude/plugins/installed_plugins.json,获取所有已安装插件列表
- 对比:找出已安装但未在
enabledPlugins 中启用的插件
Step 2: 修复 enabledPlugins
将 installed_plugins.json 中所有插件同步到 settings.json 的 enabledPlugins 中,全部设为 true。保留 settings.json 中所有其他已有字段。
Step 3: 检查代理配置
确保 settings.json 的 env 中包含:
"HTTP_PROXY": "http://127.0.0.1:7897",
"HTTPS_PROXY": "http://127.0.0.1:7897",
"NO_PROXY": "localhost,127.0.0.1"
缺失则补上,已存在则不动。
Step 4: 清理 known_marketplaces.json
读取 ~/.claude/plugins/known_marketplaces.json,移除所有 installLocation 指向 .npm/_npx/ 临时目录的条目。
Step 5: 验证插件缓存
遍历 installed_plugins.json 中每个插件的 installPath,检查该路径下 .claude-plugin/plugin.json 是否存在。缺失的记录到报告中,提示用户需要重装。
Step 6: 重建 claude-hud statusLine
仅当 claude-hud 插件已安装时执行:
- 检测运行时:
command -v bun || command -v node
- 获取最新版本路径:
ls -td ~/.claude/plugins/cache/claude-hud/claude-hud/*/ | head -1
- bun 用
src/index.ts,node 用 dist/index.js
- 生成命令并测试,确认输出包含
[claude-hud]
- 写入
settings.json 的 statusLine 字段
- 确保
~/.claude/plugins/claude-hud/config.json 存在,不存在则写入:
{"display":{"showTools":true,"showAgents":true,"showTodos":true,"showDuration":true,"showConfigCounts":true}}
Step 7: 输出诊断报告
用表格汇总所有检查项状态(OK / 已修复 / 缺失需重装),提示用户重启 Claude Code 生效。