概述
Claude Code，Anthropic 推出的官方 CLI 工具，最近迎来了一个关键变化。官方已经明确推荐，npm 安装方式自 2026 年 1 月起正式弃用，原生安装脚本（curl / PowerShell）才是目前支持自动更新的首选方案。换句话说，如果你还在用 npm 安装，是时候考虑迁移了。
安装方式对比
| 安装方式 | 命令 | 自动更新 | 推荐指数 |
|---|---|---|---|
| 原生安装（macOS/Linux） | curl -fsSL https://claude.ai/install.sh | bash | ✅ 支持后台自动更新 | ⭐⭐⭐⭐⭐ |
| 原生安装（Windows） | irm https://claude.ai/install.ps1 | iex | ✅ 支持后台自动更新 | ⭐⭐⭐⭐⭐ |
| npm | npm install -g @anthropic-ai/claude-code | ❌ 不支持，需手动更新 | ⭐⭐ |
| Homebrew | brew install --cask claude-code | ❌ 需手动 brew upgrade | ⭐⭐⭐ |
| WinGet | winget install Anthropic.ClaudeCode | ❌ 需手动 winget upgrade | ⭐⭐⭐ |
来看这张对比表，一目了然。原生安装之所以拿到满分，关键在于后台自动更新——一旦安装好，后续版本升级基本不用操心，它自己就默默搞定了。而 npm 呢，不支持自动更新、还依赖 Node.js 环境，官方弃用之后，缺点就更明显了。
推荐方案：原生安装
macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
原生安装的优势，一句话就能说清楚：省心。具体来说，有三个硬核理由：
- 后台自动更新：安装器会在后台静默检查并下载最新版本，完全不用手动干预。
- 独立运行：不依赖 Node.js 运行时，即使你后续升级或修改了 Node.js 版本，Claude Code 也不会受影响。
- 官方维护：Anthropic 直接维护，更新最及时，不会有中间环节的延迟。
直接说结论：如果你是全新安装，原生方案就是最优解，没有之一。
不推荐方案：npm 安装
当前安装命令（如已安装可跳过）
npm install -g @anthropic-ai/claude-code
npm 安装的缺点
- 无自动更新：每次新版本出来，你还得手动执行更新命令，很容易被遗忘。
- 依赖 Node.js：Node.js 版本升级或者 npm 配置变更，都有可能导致运行异常。
- 已弃用：官方 2026 年 1 月起就不推荐了，继续用下去只会越来越不方便。
npm 手动更新命令（临时方案）
如果你暂时不想迁移，也还有个临时补救的方法——手动更新：
# 强制安装最新版本（推荐） npm install -g @anthropic-ai/claude-code@latest # 或使用 update（可能不够及时） npm update -g @anthropic-ai/claude-code
迁移指南：从 npm 切换到原生安装
既然官方已经明确表态，从 npm 迁移到原生安装就势在必行了。操作并不复杂，按照下面几步来就行：
卸载 npm 版本（可选，但建议清理干净）：
npm uninstall -g @anthropic-ai/claude-code
执行原生安装：
# macOS / Linux curl -fsSL https://claude.ai/install.sh | bash # Windows PowerShell irm https://claude.ai/install.ps1 | iex
验证安装：
claude --version
整个迁移过程也就几分钟，之后就能享受自动更新的便利了。
通用更新命令
不管你是用哪种安装方式，下面这个命令都可以用来立即应用待更新的内容：
claude update
需要说明的是，这个命令只会在有可用更新时生效，而且它不会帮你切换安装渠道——比如从 npm 切换到原生，你还是得手动迁移。
注意事项
最后聊几个容易踩的坑：
- 切勿使用
sudo安装：无论是 npm 还是原生安装，加上sudo都会引发权限问题，进而影响后续的自动更新。切记，不用sudo。 - npm 包的特殊性：
@anthropic-ai/claude-code这个包，本质上只是一个封装器——它通过平台特定的可选依赖（optionalDependencies）分发原生二进制文件。换句话说，运行时其实并不依赖 Node.js。但即便如此，官方还是不建议用它了。 - 自动更新机制：原生安装器会在后台定期检查新版本，一旦有更新下载完成，下次启动 Claude Code 时就会自动应用。整个过程静默完成，毫无打扰。
一句话总结：如果你的目标是省心、稳定、及时更新，原生安装就是当前最合理的选择。迁移一次，一劳永逸。
