先看症状
安装时 npm 报错
npm 抛 EACCES、EEXIST 或者装到一半构建失败。
装完提示 command not found
装是装上了，但终端找不到命令——PATH 的问题。
启动就崩 / 秒退
起来了又带着 Node 报错退出——通常是版本不对或环境不对。
办法一 — 把 Node/npm 搞对
Node 太旧（或版本对不上）是第一大原因。装一个当前的 Node LTS，确认版本，再重新全局装一遍 CLI，让它对着正确的运行时构建。
node -v # 应该是当前 LTS
npm -v
# 升级 Node 后重新全局装 CLI
npm i -g @anthropic-ai/claude-code办法二 — 修 PATH（command not found）
如果装上了但找不到命令，就是全局 npm 的 bin 目录不在 PATH 里。查一下 npm 把全局可执行文件放哪，把那个目录加进 PATH，再开一个新终端。
npm config get prefix # 全局安装位置
# 把结果里的 \bin（Windows 上就是那个目录本身）加进 PATH，
# 然后开一个新终端让改动生效办法三 — 原生 Windows 还是 WSL
很多 Windows 上的别扭，进了 WSL 就没了——Claude Code 期望的那套 Unix 工具在里面本来就好使。如果原生 Windows 一直跟你较劲（权限、PATH、shell 怪毛病），就装进 WSL 的 Ubuntu 里跑。注意 Node 要装在 WSL 里面，别复用 Windows 那个。
办法四 — 权限
全局安装时的 EACCES/权限报错，是 npm 写不进它的全局目录。与其什么都用管理员跑，不如把 npm 的全局 prefix 指到一个你自己拥有的目录，或者用一个把东西都放在你用户目录下的 Node 版本管理器。
还是搞不定？
如果 Node、PATH、WSL、权限都走了一遍它还是不听话，也许值得换一个根本不依赖全局 npm 安装、也不挑特定 shell 配置的客户端。一个自带运行时的桌面 agent，像普通应用一样装上，跑的是同一套循环——你带个模型 key 就能开工，不用再玩 Node/PATH/WSL 寻宝。
常见问题
Claude Code 装完为什么提示 command not found？
全局 npm 的 bin 目录不在 PATH 里。跑 npm config get prefix 看全局装在哪，把那个 bin 目录加进 PATH，再开一个新终端。
Claude Code 该跑在原生 Windows 还是 WSL？
一般 WSL 更顺——它期望的 Unix 工具开箱即用。只要把 Node 装在 WSL 里，别和 Windows 的 Node 混着用。
安装时 EACCES 权限报错怎么修？
npm 写不进全局目录。把 npm 的全局 prefix 设到你自己拥有的目录，或用你用户目录下的 Node 版本管理器，别用管理员硬装全局。