第12集：实战排错 Q&A

⏱ 预计阅读 3 分钟 更新于 2026/5/7
💡 进群学习加 wx: agentupdate
(申请发送: agentupdate)

当你的扩展体系变得复杂时，可能会遇到各种运行问题。本集提供 5 个常见场景的解决方案。

Q6：同时装了多个插件，Hook 冲突了怎么办？

现象：两个插件都注册了 PostToolUse 事件。 真相：所有 Hook 是合并叠加执行的，并不会互相排斥。 冲突点：如果其中一个 Hook 返回了 block（拦截），那么后续的所有操作都会停止。此时需要检查 settings.json 中的 Hook 顺序，或调整 matcher 规则。

Q7：MCP Server 启动失败，如何排查？

  1. 检查依赖：确认 bun 或 node 是否已安装，且在系统 PATH 中。
  2. 端口检查：如果 MCP 需要开启本地端口（如 claude-mem 的 37777），请确认该端口未被占用。
  3. 手动测试：尝试在终端直接运行 MCP 的 command 及其参数，看是否报错。
  4. 超时时间：如果初始化过慢，在配置中调大 timeout 字段（单位为秒）。

Q8：如何确认当前有哪些 MCP Tool 可用？

在对话中直接询问 Claude：“请列出你当前所有可用的 MCP 工具”。Claude 会读取其工具注册表并反馈给你。

Q9：我想写一个自己的插件，最快的方法是什么？

使用 my-plugin 模板：

  1. 创建一个文件夹，放入 .claude-plugin/plugin.json。
  2. 在 skills/ 下放入你的 SKILL.md。
  3. 在本地运行 claude plugin install ./my-plugin 进行本地安装测试。

Q10：如何彻底卸载一个插件及其数据？

  1. 执行 claude plugin uninstall <name>。
  2. 手动删除 ~/.claude/plugins/cache/ 下对应的源码。
  3. 有些插件会在 ~/.claude/data/ 或用户根目录创建数据库，需要手动清理这些隐藏文件夹。