health-check 是 Claude Code 的单一诊断入口,命令为 /health:check。用途:运行环境检查并可选执行更深入的审计,再通过 --fix 路由到相应内部修复流程。
主要能力分两类。环境检查始终运行:插件注册表、设置文件、hooks、MCP 服务器、SessionStart 可执行性、pre-commit 有效性、权限覆盖、市场登记。可选审计由 --scope 控制:registry(孤儿 projectPath、陈旧的 enabledPlugins、注册表与设置漂移)、stack(已启用插件与项目技术栈匹配)、agentic(技能/命令/智能体的优化合规)、runtime(~/.claude.json 膨胀,只读)、usage(会话遥测中从未触发与休眠的技能,只读)。
参数:--scope=<all|registry|stack|agentic|runtime|usage>,默认 all;--fix 应用修复并请求确认;--dry-run 预览修复;--verbose 输出详细诊断。
使用方式:执行 /health:check 或带 scope 的命令,如 /health:check --scope=registry。修复时 registry 调用 fix-registry.sh,stack 与 agentic 按内部技能流程执行;若修复提示 RESTART_REQUIRED=true,需重启 Claude Code。
限制:runtime 与 usage 为只读审计,无 --fix 路径;usage 在本地历史不足(少于两份记录)时返回 SKIP,工具调用无法解析时提示 schema_drift;运行时审计不会读写 pluginUsage.usageCount。执行 runtime 清理建议前需关闭其他 Claude Code 会话,避免并发写入覆盖。官方文档未提供收费、价格与平台信息。