MacOS安装Claude Code 安装

环境：macOS（zsh），Node/npm 已安装
安装方式：npm 全局安装，安装目录改为用户目录（无需 sudo）

摘要：本文介绍在 macOS（zsh）环境下无需 sudo 安装 Claude Code 的完整方案。针对安装过程中遇到的区域限制、权限不足、安装脚本被拦截三个问题，采用「将 npm 全局目录改到用户目录 + 允许安装脚本」的方式解决，并涵盖日常更新、卸载清理及注意事项。

一 遇到的问题

安装 Claude Code 时依次遇到了三个问题：

1. 区域限制：官方安装脚本地址 https://claude.ai/install.sh 在当前地区被拦截，返回的是「App unavailable in region」的网页 HTML，而不是脚本，导致 bash 执行报语法错误。
2. 权限不足：npm 默认全局安装目录是 /usr/local/lib/node_modules，归 root 所有，普通用户安装报 EACCES: permission denied。
3. 安装脚本被 npm 拦截：npm 默认不允许该包执行安装脚本（提示 --allow-scripts），导致包装上了但原生二进制没有就位，运行 claude 报 claude native binary not installed。

最终采用「把 npm 全局目录改到用户目录 + 允许安装脚本」的方式解决。

二 安装步骤（推荐，无需 sudo）

1. 将 npm 全局安装目录改到用户目录

npm config set prefix "$HOME/.npm-global"

2. 安装 Claude Code 并允许其安装脚本

npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-ai/claude-code

• 也可以把放行规则写入用户配置，以后全局安装该包不再需要每次加 --allow-scripts：

npm config set allow-scripts=@anthropic-ai/claude-code --location=user

3. 把新目录加入 PATH

echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. 验证安装

which claude
claude --version

• 正常结果示例：

/Users/esther/.npm-global/bin/claude
2.1.258 (Claude Code)

• 如果 which claude 仍指向旧路径（如 /usr/local/bin/claude），关闭终端后重新打开即可。

三 日常更新

npm install -g @anthropic-ai/claude-code@latest --allow-scripts=@anthropic-ai/claude-code

四 卸载

1. 卸载全局包

npm uninstall -g @anthropic-ai/claude-code

2. 可选清理：删除用户全局目录

• 先查看该目录下是否还有其他全局包，再决定是否删除：

ls "$HOME/.npm-global/lib/node_modules"

• 如果里面只有 Claude Code（或确认其他内容都不需要），再删除：

rm -rf "$HOME/.npm-global"

3. 可选清理：移除 ~/.zshrc 中的 PATH 配置

• 编辑 ~/.zshrc，删除这一行：

export PATH="$HOME/.npm-global/bin:$PATH"

六 注意事项

• 当前网络对 claude.ai 有区域限制，若之后登录或更新受影响，需要先挂代理。
• npm 全局目录已改为 ~/.npm-global，以后所有 npm 全局安装都会装到这里，不再需要 sudo。