MacOS安装Claude Code 安装环境macOSzshNode/npm 已安装安装方式npm 全局安装安装目录改为用户目录无需 sudo摘要本文介绍在 macOSzsh环境下无需 sudo 安装 Claude Code 的完整方案。针对安装过程中遇到的区域限制、权限不足、安装脚本被拦截三个问题采用「将 npm 全局目录改到用户目录 允许安装脚本」的方式解决并涵盖日常更新、卸载清理及注意事项。文章目录MacOS安装Claude Code 安装一 遇到的问题二 安装步骤推荐无需 sudo1. 将 npm 全局安装目录改到用户目录2. 安装 Claude Code 并允许其安装脚本3. 把新目录加入 PATH4. 验证安装三 日常更新四 卸载1. 卸载全局包2. 可选清理删除用户全局目录3. 可选清理移除 ~/.zshrc 中的 PATH 配置六 注意事项一 遇到的问题安装 Claude Code 时依次遇到了三个问题区域限制官方安装脚本地址https://claude.ai/install.sh在当前地区被拦截返回的是「App unavailable in region」的网页 HTML而不是脚本导致bash执行报语法错误。权限不足npm 默认全局安装目录是/usr/local/lib/node_modules归 root 所有普通用户安装报EACCES: permission denied。安装脚本被 npm 拦截npm 默认不允许该包执行安装脚本提示--allow-scripts导致包装上了但原生二进制没有就位运行claude报claude native binary not installed。最终采用「把 npm 全局目录改到用户目录 允许安装脚本」的方式解决。二 安装步骤推荐无需 sudo1. 将 npm 全局安装目录改到用户目录npmconfigsetprefix$HOME/.npm-global2. 安装 Claude Code 并允许其安装脚本npminstall-ganthropic-ai/claude-code --allow-scriptsanthropic-ai/claude-code也可以把放行规则写入用户配置以后全局安装该包不再需要每次加--allow-scriptsnpmconfigsetallow-scriptsanthropic-ai/claude-code--locationuser3. 把新目录加入 PATHechoexport PATH$HOME/.npm-global/bin:$PATH~/.zshrcsource~/.zshrc4. 验证安装whichclaude claude--version正常结果示例/Users/esther/.npm-global/bin/claude 2.1.258 (Claude Code)如果which claude仍指向旧路径如/usr/local/bin/claude关闭终端后重新打开即可。三 日常更新npminstall-ganthropic-ai/claude-codelatest --allow-scriptsanthropic-ai/claude-code四 卸载1. 卸载全局包npmuninstall-ganthropic-ai/claude-code2. 可选清理删除用户全局目录先查看该目录下是否还有其他全局包再决定是否删除ls$HOME/.npm-global/lib/node_modules如果里面只有 Claude Code或确认其他内容都不需要再删除rm-rf$HOME/.npm-global3. 可选清理移除 ~/.zshrc 中的 PATH 配置编辑~/.zshrc删除这一行exportPATH$HOME/.npm-global/bin:$PATH六 注意事项当前网络对 claude.ai 有区域限制若之后登录或更新受影响需要先挂代理。npm 全局目录已改为~/.npm-global以后所有 npm 全局安装都会装到这里不再需要 sudo。