Claude Code 自动更新安装方式
概述
Claude Code 是 Anthropic 推出的官方 CLI 工具。根据官方推荐，npm 安装方式已于 2026 年 1 月起被弃用，原生安装脚本（curl / PowerShell）成为支持自动更新的首选方案。
安装方式对比
| 安装方式 | 命令 | 自动更新 | 推荐指数 |
|---|---|---|---|
| 原生安装（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 |
⭐⭐⭐ |
推荐方案：原生安装
macOS / Linux
bash
curl -fsSL https://claude.ai/install.sh | bashWindows (PowerShell)
powershell
irm https://claude.ai/install.ps1 | iex原生安装的优势
- 后台自动更新：安装器会在后台静默检查并下载最新版本，无需手动干预。
- 独立运行：不依赖 Node.js 运行时，安装完成后 Node.js 版本变更不会影响 Claude Code。
- 官方维护： Anthropic 直接维护，更新最及时。
不推荐方案：npm 安装
当前安装命令（如已安装可跳过）
bash
npm install -g @anthropic-ai/claude-codenpm 安装的缺点
- 无自动更新：必须手动执行更新命令才能获取新版本。
- 依赖 Node.js：Node.js 版本升级或 npm 配置变更可能导致运行异常。
- 已弃用：官方已于 2026 年 1 月起不再推荐此方式。
npm 手动更新命令（临时方案）
如果你暂时不想迁移到原生安装，可使用以下命令手动更新：
bash
# 强制安装最新版本（推荐）
npm install -g @anthropic-ai/claude-code@latest
# 或使用 update（可能不够及时）
npm update -g @anthropic-ai/claude-code迁移指南：从 npm 切换到原生安装
-
卸载 npm 版本（可选，但建议清理）：
bashnpm uninstall -g @anthropic-ai/claude-code -
执行原生安装：
bash# macOS / Linux curl -fsSL https://claude.ai/install.sh | bash # Windows PowerShell irm https://claude.ai/install.ps1 | iex -
验证安装：
bashclaude --version
通用更新命令
无论使用哪种安装方式，都可以运行以下命令来立即应用待更新内容：
bash
claude update注：此命令仅在有可用更新时生效，且不会切换安装渠道（如从 npm 切换到原生安装）。
注意事项
- 切勿使用
sudo安装 ：无论是 npm 还是原生安装，使用sudo都会导致权限问题，影响后续自动更新。 - npm 包的特殊性 ：
@anthropic-ai/claude-code实际上是一个封装器，它通过平台特定的可选依赖（optionalDependencies）分发原生二进制文件，运行时并不依赖 Node.js。 - 自动更新机制：原生安装器会在后台定期检查新版本，下载完成后在下次启动时自动应用。