网上流传挺广的说法:不是"npm安装已经被废弃",而是官方现在把原生安装脚本设成了首选推荐方式,npm仍然能用,只是不再是唯一入口了。macOS、Windows、Linux都支持,往下把几种安装方式和注意事项给你捋清楚,一起往下来了解Claude Code安装教程吧。 一、Claude Code安装系统要求
Claude Code支持macOS 13.0以上、Windows 10(1809版本以上)或Windows Server 2019以上、Ubuntu 20.04以上、Debian 10以上、Alpine Linux 3.19以上,硬件上4GB以上内存、x64或ARM64处理器就行,需要联网,也得在Anthropic支持的国家和地区范围内。
二、方法一:原生安装,官方现在最推荐这个
不喜欢用终端的话,官方也提供了图形界面的桌面应用,直接下载macOS、Windows或Linux版本安装即可。命令行党可以按系统选对应命令:
原生安装装的是跨平台的原生二进制文件,好处是会在后台自动更新,不用你手动操心。Windows原生环境下建议装个Git for Windows,这样能用上Bash工具,不装的话Claude Code会退回用PowerShell执行命令。
三、方法二:用包管理器装
不想跑脚本的话,几个主流包管理器也都支持:
Homebrew:brew install--cask claude-code WinGet:winget install Anthropic.ClaudeCode
Linux上还支持apt、dnf、apk,具体命令官方文档里有详细步骤
要注意的是,Homebrew、WinGet和Linux包管理器装的版本默认不会自动更新,得你自己定期手动升级,跟原生安装脚本那种自动后台更新不一样。
四、方法三:npm安装,进阶选项而不是被淘汰
如果你习惯用npm管理,也完全可以:
npm install-g anthropic-ai/claude-code
要提醒一句,从v2.1.198版本开始,npm安装要求Node.js 22或更高版本,用更老版本的Node装的话会提示一个警告但通常还是能装上,因为这个包下载的是原生二进制文件,运行时并不依赖你的Node.js环境。另外千万别用sudo npm install-g,容易搞出权限问题,遇到权限报错的话官方文档里有专门的排查方法。升级用npm install-g anthropic-ai/claude-code latest,别用npm update-g,因为这个命令可能不会把你升到最新版本。
五、装完怎么验证,怎么登录
装好之后跑一下claude--version看看有没有正常输出,想更详细检查配置的话跑claude doctor。在你要用的项目目录下打开终端,输入claude就能启动,第一次用会跳浏览器提示你登录。这里有个前提得说清楚:得有Pro、Max、Team、Enterprise或者Console(API)账号才能用,免费的Claude.ai账号是不包含Claude Code访问权限的,这点很多人容易搞混。
看完这篇claude code安装教程,你大概能明白现在官方最推荐的是原生安装脚本,图形界面党可以直接下桌面应用,npm和各种包管理器也都还能正常用,按自己习惯选一种装上,装完记得先确认账号类型对不对。