npm 依赖安装失败

你会遇到什么

npm install -g claude-mem 报错或后台静默失败，装完 claude-mem 命令不可用。你重试几次还是不行——多数是网络/源的问题，少数是运行时缺失：新版 claude-mem（v7.1.0 起）把 worker 从 pm2 换成了 Bun，机器上没有 Bun 就会在安装或首次启动时出问题。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

• 安装失败主因：npm 默认官方源在国内不稳定，依赖树拉不全；
• 静默失败：部分网络错误 npm 只给警告，装完才发现命令没有；
• 运行时差异：旧资料写"用 pm2 管理 worker"（旧版），新版依赖 Bun 运行时——按旧教程查 pm2 会找错方向。

npm install -g 的成功标准只是“包的二进制被链接进全局 bin 目录”，npm 不负责检查包在运行时还需要什么——它只管 JS 依赖树。

claude-mem 的 worker 是独立进程，v7.1.0 起由 Bun 运行时承载，而 npm 不会替你验证 Bun 是否存在：装完 claude-mem 命令本身能出来（命令只是 JS 包的入口），真正跑 worker 时才在 Bun 上崩。

这就是“装完命令不可用”的两条完整链路：网络问题 → 依赖树拉不全（npm 经常只给警告不报错）→ 命令缺失；运行时问题 → 命令在、worker 起不来。

所以确认顺序固定为三步：claude-mem --version 看命令在不在（网络层）→ bun --version 看运行时在不在（运行时层）→ claude-mem status 看 worker 是否就绪（服务层），哪层断补哪层。

实测环境：2026-08-28 本市场实测：npmmirror 全局安装成功（首次约 50s，缓存后约 5s）；Bun 已装。

一步步来

1. 换源重试 — 必做

npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem

实测：npmmirror 全局安装成功（首次约 50s，缓存后约 5s）。

2. 依赖异常时强装 + 重启 worker — 必做

npm ci && npm install --force
claude-mem restart

3. 确认运行时（Bun） — 必做

bun --version

缺 Bun 就先装 Bun（curl -fsSL https://bun.sh/install | bash）；旧资料里的 pm2 场景只对应旧版本，别照抄。

怎么确认修好了

claude-mem --version && claude-mem status

命令可用、worker 就绪即成功（实测：换源后安装成功，版本正常输出）。

其它环境的表现

症状

npm install -g claude-mem 报错或后台静默失败，claude-mem 命令不可用。

原因

依赖树/网络问题；旧版使用 pm2 管理 worker（v7.1.0 起 PM2→Bun，需要 Bun 运行时）。

解法

1. 换源重试：npm_config_registry=https://registry.npmmirror.com npm install -g claude-mem。
2. 依赖异常时 npm ci 或 npm install --force 后重启 worker。
3. 确认运行时：bun --version（缺 Bun 时装 Bun；旧资料里的 pm2 场景对应旧版本）。