Claude Code 弃用 npm 安装方法

Claude Code 通过 npm 全局安装的方式已经被 Anthropic 标记为 deprecated（不推荐/弃用），官方现在推荐使用 native installer（原生安装器）。(GitHub)

不过这里的“弃用”不是说 npm 安装马上不能用，而是：

npm 安装方式进入维护模式，新用户应该使用 native installer；未来功能、更新体验会优先围绕 native installer。(GitHub)

---

1. 为什么从 npm 迁移到 native installer？

核心原因有几个。

---

原因1：摆脱 Node.js 依赖

以前：

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

架构：

Node.js
  |
 npm
  |
 @anthropic-ai/claude-code
  |
 claude CLI

所以用户必须先有：

node
npm

并且版本要匹配。

问题：

• Node 版本冲突
• nvm 切换导致 claude 消失
• npm 全局目录权限问题

例如你当前：

nvm use 24
npm install -g claude-code

如果以后：

nvm use 22

你的：

claude

可能找不到。

官方文档现在推荐 native installer，因为它自带运行环境，不依赖 Node.js。(Claude帮助中心)

---

原因2：npm 全局安装容易出现权限问题

典型：

npm install -g xxx

经常遇到：

EACCES permission denied

原因：

npm global package 默认：

/usr/lib/node_modules

需要 root。

于是用户会：

sudo npm install -g

这又产生：

• 文件归属 root
• PATH 混乱
• 升级失败

官方安装文档也特别提醒不要用 sudo 安装 Claude Code，并建议改用 native installer。(Claude帮助中心)

---

原因3：Claude Code 已经不是普通 Node CLI

早期：

Claude Code
    =
Node.js CLI

现在：

Claude Code
    =
native executable
+
自动更新系统
+
平台二进制

npm 包实际上也不是纯 JS 了。

当前 npm 包结构类似：

@anthropic-ai/claude-code

        |
        |
        +-- JS wrapper
        |
        +-- optional dependency
              |
              +-- claude-code-linux-x64
              +-- claude-code-win32-x64
              +-- claude-code-darwin-arm64

npm 只是负责分发 native binary。(Claude)

所以：

既然最终运行的是 native binary，直接提供 native installer 更合理。

---

原因4：自动更新更容易控制

npm：

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

依赖：

• npm registry
• Node环境
• package lock
• optional dependency

native：

claude
 |
 auto updater
 |
 下载新版本 binary

Anthropic 可以控制：

• 版本发布
• 二进制校验
• 回滚

官方现在提供 release manifest 和 SHA256 校验机制。(Claude)

---

2. native installer 怎么安装？

Linux/macOS：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

官方目前推荐这种方式。(Claude帮助中心)

安装后：

which claude

通常：

~/.local/bin/claude

而不是：

~/.nvm/versions/node/.../bin/claude

(Claude)

---

3. 你现在 npm 安装的版本怎么办？

你现在：

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

并没有错。

它仍然可以运行。

检查：

claude --version

如果正常：

2.1.220

可以继续使用。

---

如果迁移：

先卸载：

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

然后：

curl -fsSL https://claude.ai/install.sh | bash

检查：

which -a claude

确保没有多个版本。

官方也提醒多个安装来源会导致版本冲突。(Claude)

---

总结：

安装方式	状态	推荐度
npm install -g @anthropic-ai/claude-code	旧方式，仍可用	⭐⭐
curl install.sh native	官方推荐	⭐⭐⭐⭐⭐
Homebrew cask	macOS推荐	⭐⭐⭐⭐
WinGet	Windows推荐	⭐⭐⭐⭐

你之前学习 nvm、npm 全局包管理，这个迁移其实体现了一个趋势：

现代 AI CLI 工具正在从“Node 包”转向“独立 native agent runtime”。 Claude Code、一些 Codex/Ops 工具都在往这个方向发展。