Claude使用报错 Error: Cannot find module ‘./yoga.wasm‘
🛠️ Claude CLI 报错「找不到 yoga.wasm」一站式修复指南
如果你在终端执行
claude --version时看到下图的MODULE_NOT_FOUND错误，跟着本文 3 分钟搞定！
📑 目录
- 问题现象
- 排查思路
- 解决方案
- 一键复制命令序列
- 同类问题预防
- 结果验证
🔍 问题现象
| 触发命令 | 报错信息 |
|---|---|
claude --version | Error: Cannot find module 'yoga.wasm' |
🔎 排查思路
| 阶段 | 目的 | 执行命令 |
|---|---|---|
| ① 问题定位 | 确认错误类型 | claude --version |
| ② 环境诊断 | 检查安装状态 | npm list -g @anthropic-ai/claude-code |
| ③ 路径确认 | 找到可执行文件 | which claude |
🛠️ 解决方案
步骤 1：卸载损坏的安装
尝试正常卸载
npm uninstall -g @anthropic-ai/claude-code
如果遇到 ENOTEMPTY 错误，强制删除
sudo rm -rf /Users/xiachuan/.nvm/versions/node/v22.17.0/lib/node_modules/@anthropic-ai/claude-code
步骤 2：重新安装 Claude CLI
全局重新安装
npm install -g @anthropic-ai/claude-code
步骤 3：验证修复
检查版本
claude --version
测试帮助命令
claude --help
📝 完整排查命令序列
=== 问题诊断 ===
claude --version # 确认错误
npm list -g @anthropic-ai/claude-code # 检查安装状态
which claude # 确认命令位置
=== 解决方案 ===
npm uninstall -g @anthropic-ai/claude-code # 尝试卸载
sudo rm -rf ~/.nvm/versions/node/v22.17.0/lib/node_modules/@anthropic-ai/claude-code # 强制删除
npm install -g @anthropic-ai/claude-code # 重新安装
=== 验证修复 ===
claude --version # 确认版本
claude --help # 测试功能
🎯 排查思路总结
-
错误信息分析
仔细阅读错误堆栈
识别关键错误类型（MODULE_NOT_FOUND）
定位缺失的具体模块（yoga.wasm） -
环境状态检查
确认安装状态和版本
检查文件路径和权限
验证 Node.js 环境 -
渐进式解决
先尝试软重置（正常卸载重装）
遇到阻碍时使用强制方法
逐步验证每个修复步骤 -
验证完整性
测试基本功能
确认所有命令可用
验证配置完整性
🚨 常见类似问题及预防
类似问题场景：
网络中断导致的不完整安装
权限问题导致的文件缺失
Node.js 版本兼容性问题
缓存污染导致的模块冲突
预防措施：
定期检查健康状态
claude doctor
清理 npm 缓存
npm cache clean --force
检查 Node.js 版本兼容性
node --version
npm --version
✅ 最终结果
Claude CLI 成功修复并正常运行
版本：1.0.71 (Claude Code)
所有功能验证通过
可以正常使用交互式和非交互式模式