概述

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

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 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 都会导致权限问题，影响后续自动更新。
• npm 包的特殊性：@anthropic-ai/claude-code 实际上是一个封装器，它通过平台特定的可选依赖（optionalDependencies）分发原生二进制文件，运行时并不依赖 Node.js。
• 自动更新机制：原生安装器会在后台定期检查新版本，下载完成后在下次启动时自动应用。