安装方式对比

推荐方案：原生安装

macOS / Linux

Windows (PowerShell)

原生安装的优势

• 后台自动更新：安装器会在后台静默检查并下载最新版本，无需手动干预。
• 独立运行：不依赖 Node.js 运行时，安装完成后 Node.js 版本变更不会影响 Claude Code。
• 官方维护： Anthropic 直接维护，更新最及时。

不推荐方案：npm 安装

当前安装命令（如已安装可跳过）

npm 安装的缺点

• 无自动更新：必须手动执行更新命令才能获取新版本。
• 依赖 Node.js：Node.js 版本升级或 npm 配置变更可能导致运行异常。
• 已弃用：官方已于 2026 年 1 月起不再推荐此方式。

npm 手动更新命令（临时方案）

如果你暂时不想迁移到原生安装，可使用以下命令手动更新：

迁移指南：从 npm 切换到原生安装

卸载 npm 版本（可选，但建议清理）：

执行原生安装：

验证安装：

通用更新命令

无论使用哪种安装方式，都可以运行以下命令来立即应用待更新内容：

注：此命令仅在有可用更新时生效，且不会切换安装渠道（如从 npm 切换到原生安装）。

注意事项

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