安装备用方式：npm、Homebrew、WinGet 与 WorkBuddy 桌面版

上一课走完了官方推荐的原生安装主线；这一课 8 分钟，把安装篇收尾：npm、Homebrew、WinGet 三种包管理器备用方式一次讲清——命令、取舍、怎么更新；再给完全不想碰命令行的同学一条替代路线：WorkBuddy 桌面版，下载、安装、微信扫码登录，全程用鼠标点选就能完成。

一句话先立住：npm 包里装的也是原生安装那个二进制，不是跑在 Node 上的脚本；几种方式装完，验证方法一模一样。差别只在「怎么装、怎么更新」——先想清楚自己要什么，再挑一条走。（事实核对时间 2026-11-04；命令与版本会更新，以官方文档为准。）

学完你能做什么

• 用一条 npm install -g 命令完成 Claude Code npm 安装，并用正确的命令升级（避开 npm update -g 的坑）
• 用 Homebrew / WinGet 安装 Claude Code，分清 claude-code 与 claude-code@latest 两个版本通道
• 说清四种安装方式各自的更新规则：谁自动更新、谁要手动 brew upgrade / winget upgrade
• 完成 WorkBuddy 下载、安装（Windows / macOS）与微信扫码登录，全程不碰命令行
• 判断自己该留在上一课的原生安装主线，还是换用哪种备用方式

你现在的困境

• 上一课的原生安装命令没成功，或者你不想往系统里加「来路不明的安装脚本」——想用自己熟悉的包管理器统一管理软件
• 已经装了 Node.js：npm install -g 用熟了，Claude Code 能不能也这么装？装完又怎么升级？
• 完全不想碰终端：看一眼命令行就头大，只想下载个桌面软件、点几下「下一步」就开始用

什么时候用这一招

当你需要：

• 用熟悉的包管理器（npm / Homebrew / WinGet）安装和管理 Claude Code
• 原生安装失败时，换一条官方同样支持的通道重试
• 一条零命令行的替代路线：桌面软件 + 微信扫码，几分钟装完登录好

而且不想：

• 每种方式都试一遍，往系统里装出好几份互相覆盖的 Claude Code
• 装完就不管更新，一直停在有已知问题的旧版本
• 为了装一个 AI 编程工具，先去学半天终端和 shell 配置

🎒 开始前的准备

• 读完上一课 安装 Claude Code：已经装好的同学，本课 Claude Code 部分可以跳过，直接看第 5 步的 WorkBuddy 桌面版
• Claude Code 部分：账号与系统要求和上一课相同（Claude 订阅或 Console 账号；macOS 13.0+ / Windows 10 1809+ / Ubuntu 20.04+，4 GB 内存起步）
• 走 npm 方式：装好 Node.js 22 或更高版本（终端运行 node --version 查看；npm --version 打出来是 12 开头的同学，看第 1 步的版本检查）
• 走 Homebrew 方式：机器上已装好 Homebrew，终端能运行 brew 命令
• 走 WinGet 方式：Windows 上终端能运行 winget 命令
• 走 WorkBuddy 桌面版：Windows 10 及以上（x64）或 macOS 12 及以上；手机上有微信，能扫码

核心思路

四种备用方式一张表看清，先对号再动手：

安装方式	一条命令	平台	装完怎么更新	适合谁
npm（本课主推）	npm install -g @anthropic-ai/claude-code	macOS / Linux / Windows（需 Node.js 22+）	能自动更新（前提：不用 sudo、全局目录可写）；手动升级 npm install -g @anthropic-ai/claude-code@latest	已有 Node.js 工具链
Homebrew	brew install --cask claude-code	macOS	不自动更新；brew upgrade claude-code 手动升级	Mac 上习惯 brew 管软件
WinGet	winget install Anthropic.ClaudeCode	Windows	不自动更新；winget upgrade Anthropic.ClaudeCode 定期升级	Windows 上习惯 WinGet 管软件
WorkBuddy 桌面版	官网 workbuddy.cn 下载安装包	Windows 10+（x64）/ macOS 12+（另有 UOS、麒麟商店）	客户端内「检查更新」	完全不想碰命令行

开工前记住三个关键认知：

1. npm 装的也是「原生二进制」。 官方文档明说：npm 包通过平台相关的可选依赖（如 @anthropic-ai/claude-code-darwin-arm64）拉取的，就是独立安装器装的那个原生二进制；装出来的 claude 运行时并不调用 Node。别担心「npm 版是不是缩水版」——不是。
2. 更新规则是本课重点。 原生安装后台自动更新；npm 方式也能自动更新，但前提是安装时没用 sudo、npm 全局目录可写；Homebrew、WinGet、apt/dnf/apk 默认都要手动升级。装完不更新 = 错过新功能和安全修复。
3. WorkBuddy 不是 Claude Code 的「皮肤」。 它是腾讯出品的另一个独立产品：桌面 AI 工作台，能写代码、读项目、开发网站和应用；微信扫码登录，账号体系和 Claude Code 完全不同。它解决的是「零命令行」问题，不是「免费用 Claude」问题——两回事，别混。

💡 分不清 WorkBuddy 和 Claude Code 桌面版？

Claude Code 自己也有官方桌面应用（图形界面，不用开终端），官方提供 macOS、Windows、Linux 下载；WorkBuddy 则是腾讯的独立产品。本课第 5、6 步讲的是 WorkBuddy；Claude Code 的各种形态到 Claude Code 用法 再展开。

跟我做

先按你的工具链对号：有 Node.js → 第 1 步；Mac 党 → 第 2 步；Windows 党 → 第 3 步；谁都不想碰 → 第 5、6 步。第 4 步（更新规则）建议所有人都过一遍。

第 1 步：用 npm install -g 完成 Claude Code npm 安装

为什么：npm 是本课推荐的备用通道：一条命令装完，和原生安装装出同一个二进制，还支持自动更新——前提是别用 sudo。

先确认 Node.js 版本（npm 包要求 Node.js 22 或更高）：

node --version

你应该看到：v22 或更高的版本号。Node 版本偏旧时，npm 会打印 EBADENGINE 警告——安装仍会完成、claude 照样能跑（因为包下载的是不依赖你本机 Node 的原生二进制），但建议还是把 Node 升到 22+ 再装。

顺手再确认 npm 自己的版本：

npm --version

你应该看到：一个版本号。如果以 12 开头，先别硬装——npm 12 有已知的安装问题，按官方文档 Fix an npm 12 install 处理，或到 装不上怎么办 对号，再回来安装。

然后安装（不要加 sudo）：

npm install -g @anthropic-ai/claude-code

你应该看到：npm 正常走完安装、无报错。新开一个终端窗口运行 claude --version，打出版本号 + (Claude Code)——和上一课的验证方法一模一样。

以后升级用它（不要用 npm update -g，原因见「踩坑提醒」）：

npm install -g @anthropic-ai/claude-code@latest

npm 通道支持的平台：darwin-arm64、darwin-x64、linux-x64、linux-arm64、linux-x64-musl、linux-arm64-musl、win32-x64、win32-arm64；你的包管理器需要允许「可选依赖」。装完找不到 claude 命令的话，去 装不上怎么办 对号。

• 小检查：claude --version 打出了带 (Claude Code) 的版本号，且我安装时没有用 sudo

第 2 步：用 Homebrew 安装 Claude Code（macOS 用户）

为什么：Mac 上习惯 brew 管软件的同学，把 Claude Code 也交给 brew 统一管理——但 brew 装完不会自动更新，得手动升级。

Homebrew 提供两个 cask，先选一个：

cask	跟的通道	特点
claude-code	stable 稳定版	通常比最新版落后约一周，跳过有重大回退问题的版本
claude-code@latest	latest 最新版	新版本一发布就跟进

大多数人选稳定版：

brew install --cask claude-code

你应该看到：brew 走完安装流程。新开终端运行 claude --version 验证。

以后升级（装的是哪个 cask 就 upgrade 哪个）：

brew upgrade claude-code
# 装了 latest 通道的用：
brew upgrade claude-code@latest

• 小检查：我知道自己装的是哪个 cask，也记得 brew 不会自动更新

第 3 步：用 WinGet 安装 Claude Code（Windows 用户）

为什么：Windows 上用 WinGet 管软件的同学，同样一条命令装好——同样装完不会自动更新，要定期手动升级。

在 PowerShell 里运行：

winget install Anthropic.ClaudeCode

你应该看到：WinGet 走完下载安装流程。新开终端运行 claude --version 验证。

以后定期升级：

winget upgrade Anthropic.ClaudeCode

注意：Claude Code 正在运行时，Windows 会锁定它的可执行文件，这时升级可能失败——先退出 Claude Code 再升。

• 小检查：claude --version 打出版本号；我记住了升级命令是 winget upgrade

第 4 步：验证安装，弄清 Claude Code 更新规则

为什么：几种方式装出来的 claude 验证方法一致；但更新规则各不相同——装完第一件事就是弄清「我的安装归谁管、怎么升级」。

验证（新开终端）：

claude --version

你应该看到：版本号 + (Claude Code)，例如 2.1.211 (Claude Code)。

想看安装健康状态，再跑一个只读诊断：

claude doctor

你应该看到：安装与配置的诊断信息——包括最近一次自动更新的结果，有问题会附修复建议。

更新规则对号表：

你的安装方式	自动更新？	手动升级命令
原生安装（上一课）	✅ 后台自动更新	claude update（立即应用更新）
npm	✅ 能自动更新（前提：全局目录可写、没用 sudo）	npm install -g @anthropic-ai/claude-code@latest
Homebrew	❌ 默认不自动	brew upgrade claude-code（或 claude-code@latest）
WinGet	❌ 默认不自动	winget upgrade Anthropic.ClaudeCode

一个容易迷惑的点：对 Homebrew / WinGet 管理的安装，运行 claude update 会报告 Claude is up to date!——对这类安装，更新要走包管理器，用上表对应命令升级即可。

• 小检查：我能说出自己这种安装方式「归谁管更新」，以及对应的手动升级命令

第 5 步：WorkBuddy 下载与安装——零命令行路线

为什么：完全不想碰终端的同学，走这条路线全程鼠标点选：官网下载安装包 → 双击安装 → 微信扫码登录。WorkBuddy 是腾讯出品的桌面 AI 工作台，也覆盖写代码、读项目、开发网站和应用这类开发场景。

先核对系统要求：

系统	要求
Windows	Windows 10 及以上，x64；不支持 Windows 7/8/8.1（ARM64 设备支持情况以当前版本说明为准）
macOS	macOS 12（Monterey）及以上
统信 UOS / 银河麒麟	通过系统应用商店 / 软件商店搜索安装（UOS 支持 x86_64 与 ARM64；麒麟为桌面版 V10）

不满足要求的系统无法启动 WorkBuddy——先升级系统再装。

Windows 用户

1. 访问 WorkBuddy 官网，点击「立即下载」，选择 Windows，下载安装包
2. 下载完成后双击安装包，启动安装程序
3. 勾选「我同意此协议」，点击下一步
4. 选择安装路径（默认路径可直接点击下一步）
5. 确认开始菜单文件夹，点击下一步
6. 建议勾选「创建桌面快捷方式」，点击下一步
7. 确认配置无误，点击安装；完成后点击完成退出安装向导

你应该看到：桌面出现 WorkBuddy 快捷方式，双击能启动。

macOS 用户

1. 访问 WorkBuddy 官网，点击「立即下载」，选择 Mac 版本——M 系列芯片选 Mac ARM64，Intel 芯片选 Mac X64；官网没识别出你的设备时，默认提供 X64 版（它能在 M 系列上通过 Rosetta 运行，兼容性更广）。不知道自己芯片的，点屏幕左上角苹果图标 →「关于本机」查看
2. 在浏览器弹窗中允许下载，等安装包下载完成
3. 双击下载好的 .dmg 文件，打开安装窗口
4. 把 WorkBuddy 图标拖进 Applications（应用程序）文件夹——这一步不能省，原因见「踩坑提醒」
5. 等待拷贝完成，推出已挂载的 WorkBuddy 磁盘映像；不再需要的话可以删掉 .dmg 安装包

你应该看到：启动台（或 Command + 空格 搜索）里能找到 WorkBuddy，并且是从「应用程序」文件夹启动的。

• 小检查：WorkBuddy 是从「应用程序」文件夹（Windows 则是开始菜单/桌面快捷方式）启动的，不是从安装包里直接运行的

第 6 步：微信扫码登录 WorkBuddy，确认能更新

为什么：装好只是半程——登录进去、确认更新通道正常，才算「能用」。

1. 启动 WorkBuddy，点击登录按钮
2. 浏览器自动打开官网登录页，在弹窗中勾选《用户服务协议》与《隐私政策》
3. 用微信扫码完成登录；也支持手机号、邮箱、SSO 等方式，全程在当前页面完成、无需跳转
4. 页面显示登录成功后，返回客户端

你应该看到：客户端进入主界面，可以「新建任务」了。

确认更新通道：点击左下角头像 →「检查更新」。已是最新版本就无需操作；有新版本时系统会自动下载并完成升级。

（Mac 上如果提示无法自动更新，说明 WorkBuddy 是从 .dmg 磁盘映像里直接运行的——按提示点「移动到应用程序」，或手动拖进「应用程序」文件夹，再从那里重新启动。）

费用一句话：WorkBuddy 有免费体验版（500 积分/月），付费档位与积分规则见 价格对比 和 WorkBuddy 用法。

• 小检查：微信扫码登录成功，客户端能正常打开；「检查更新」能正常响应

检查点 ✅

• 我用 npm / Homebrew / WinGet 其中一种方式装好了 Claude Code，claude --version 打出版本号 + (Claude Code)
• npm 方式：我没用 sudo npm install -g；升级用 npm install -g @anthropic-ai/claude-code@latest，不用 npm update -g
• Homebrew / WinGet 方式：我知道装完不自动更新，记住了 brew upgrade / winget upgrade 升级命令
• WorkBuddy 桌面版装好并微信扫码登录成功；Mac 上是从「应用程序」文件夹启动的
• 我能说出自己当前的安装方式「归谁管更新」，报错知道去 装不上怎么办 速查

踩坑提醒

❌ 用 sudo npm install -g 安装

官方文档明确警告：不要用 sudo 装全局包——会带来权限问题和安全风险；而且 Claude Code 自我更新时是不带 sudo 运行 npm 的，用 sudo 装的安装没法自动更新。

正确做法：去掉 sudo 直接装。遇到权限报错（npm 全局目录不可写），去 装不上怎么办 对号处理，别用 sudo 硬闯。

❌ 用 npm update -g 升级 Claude Code

npm update -g 按最初安装时的 semver 版本范围走，可能升不到最新版。

正确做法：

# ❌ 可能升不到最新
npm update -g
# ✅ 明确指定装最新版
npm install -g @anthropic-ai/claude-code@latest

❌ Homebrew / WinGet 装完就以为会自动更新

不会。这两种方式默认都要手动升级（brew upgrade claude-code / winget upgrade Anthropic.ClaudeCode）。两个附带提醒：

• 升级失败先别慌：Claude Code 可能在新版本还没上架包管理器时就通知你有更新——官方文档称之为已知问题，过段时间再试即可。WinGet 升级时如果 Claude Code 正在运行，Windows 锁定可执行文件也会导致失败，先退出再升。
• brew 会留旧版本占磁盘：Homebrew 升级后旧版本仍留在磁盘上，官方建议定期运行 brew cleanup 回收空间。

❌ Mac 上双击 .dmg 直接运行 WorkBuddy

从磁盘映像里直接运行，WorkBuddy 跑在只读映像上，后续无法自动更新。

正确做法：先把 WorkBuddy 拖进「应用程序」文件夹再启动。已经中招的不用重装——点更新提示里的「移动到应用程序」按钮，或手动拖进去，然后从「应用程序」重新启动。

进阶技巧（可选）

让 Claude Code 替你跑升级命令。 Homebrew / WinGet 用户可以在 settings.json 里设置：

{
  "env": {
    "CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE": "1"
  }
}

之后 Claude Code 检测到新版本，会在后台替你执行对应的升级命令——只动 Claude Code 这一个包，不影响你装的其他软件。WinGet 上如果升级时 Claude Code 正在运行，它会改而显示手动命令让你复制执行。

Linux 用户：apt / dnf / apk。 Debian/Ubuntu、Fedora/RHEL、Alpine 可以从 Anthropic 的签名仓库安装 Claude Code，同样分 stable（约落后一周）和 latest 双通道，升级走系统包管理器（如 sudo apt update && sudo apt upgrade claude-code）——完整命令见官方文档 Install with Linux package managers。

国产系统用户。 WorkBuddy 在统信 UOS 和银河麒麟上通过系统商店分发：UOS 打开系统自带的应用商店、麒麟打开任务栏的软件商店，搜索 WorkBuddy 点击安装即可；更新也在商店里完成。

WorkBuddy 界面语言。 需要切换语言时：左下角头像 → 设置 → 通用 → 语言。

本课小结

✅ Claude Code npm 安装 = npm install -g @anthropic-ai/claude-code（不加 sudo），升级用 npm install -g @anthropic-ai/claude-code@latest；npm 包装的也是原生二进制，装出来的 claude 运行时不依赖 Node。

✅ Homebrew 两个 cask：claude-code（stable，约落后一周）/ claude-code@latest（最新）；WinGet 一条 winget install Anthropic.ClaudeCode。两者装完都不自动更新，要手动 brew upgrade / winget upgrade。

✅ 更新规则三档：原生安装后台自动更新；npm 能自动更新（前提：不用 sudo、全局目录可写）；Homebrew / WinGet / apt / dnf / apk 默认手动。claude doctor 可查看安装健康与最近一次更新结果。

✅ WorkBuddy 桌面版 = 零命令行路线：官网 workbuddy.cn 下载 → Windows 双击安装 / Mac 拖进「应用程序」→ 微信扫码登录；更新在客户端「左下角头像 → 检查更新」。

✅ 选型一句话：有 Node 工具链 → npm；Mac 党 → Homebrew；Windows 党 → WinGet；不碰命令行 → WorkBuddy；都不想折腾 → 回上一课的原生安装主线。

关键命令回顾：

命令	作用	适用
npm install -g @anthropic-ai/claude-code	npm 安装 Claude Code	Node.js 22+，全平台
npm install -g @anthropic-ai/claude-code@latest	npm 升级到最新版	npm 安装的用户
brew install --cask claude-code	Homebrew 安装（stable 通道）	macOS
brew upgrade claude-code	Homebrew 手动升级	Homebrew 安装的用户
winget install Anthropic.ClaudeCode	WinGet 安装	Windows
winget upgrade Anthropic.ClaudeCode	WinGet 手动升级	WinGet 安装的用户
claude --version / claude doctor	验证安装 / 只读诊断	全平台

下一课预告

装的方式多了，报错的形态也多。下一课 装不上怎么办：起步排错 60 秒速查。

你会学到：

• command not found / 'claude' is not recognized 的 60 秒修法（多半是 PATH 没配好）
• npm 权限报错、npm 12 安装问题怎么处理
• 装上了但启动报错、登录卡住时先查什么
• 哪些报错说明你该换一条安装通道重试