Claude Code
Windows 安装报 EACCES / 权限拒绝
报错原文
npm ERR! code EACCES / spawn EACCES / Permission denied (os error 13)
出现场景
用 npm install -g 全局安装 Claude Code CLI 时报权限错误, 或用管理员权限强行安装后功能异常。
可能原因(按概率)
- npm 全局安装目录权限不属于当前用户, 常见于用管理员身份装过一次后普通用户再装冲突
- 用 sudo/管理员权限安装产生了 root/管理员归属的文件, 后续更新和正常使用的用户没有写权限
- 杀毒软件拦截了安装脚本释放的文件或配置写入
修复步骤(从最简单的开始)
- 改用官方原生安装器而非 npm 全局安装(推荐路径, 一次性避开权限问题): PowerShell 执行 irm https://claude.ai/install.ps1 | iex
- PowerShell 执行策略被拦截时先放开: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
- 检查目标目录是否可写: 确认 npm 全局路径 npm config get prefix 对应目录当前用户有写权限, 不要用管理员权限硬装
- 临时关闭杀毒软件实时防护重新安装, 成功后再开启防护并把安装目录加入白名单
- 绝对不要用 sudo 或以管理员身份强行 npm install -g, 会产生权限归属混乱, 后续更新持续报错
大陆网络环境注记
此问题与网络无关, 纯本地环境问题, 大陆用户和其他地区用户遇到的原因完全一致, 用官方原生安装脚本可以规避掉 npm 全局安装带来的绝大多数权限坑。
反复被网络 / 支付 / 限流问题耗时间?国内直连的 API 网关一个 key 通多家模型,绕开这一整类报错。
了解 newapi 网关claude-codewindows安装权限