如何彻底卸载 Claude Code（npm 全局 / 本地，两种姿势）

我是 Quentin，OpenClaw 作者，OpenClaw 拼车的维护者。

这篇是写给那些真心想把 Claude Code 从机器上拔干净的同学：可能你在做版本回滚、可能你切到了别的 CLI、也可能你被某个 cache 卡住了想完全重装。npm uninstall 一行下去 ≠ 卸载干净 —— 全局目录会留壳、缓存会留版本、用户配置目录里还有引用。

下面这套流程是我自己每次重装前都会走一遍的，五步走完就是干净系统。

卸完之后想换条更省事的路，让 Claude Code 直接挂到拼车 token 上：
curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x
一行脚本写完 auth、写好 ~/.claude.json，重新 claude 就能跑。

适用场景

适用于通过 npm 安装的 @anthropic-ai/claude-code 包，全局安装、本地项目安装两种都覆盖。Homebrew 安装的同样适用，最后多一步 brew uninstall 即可。

第一步：搞清楚你装在哪儿

卸载之前先查一下究竟装了几个版本、装在哪些地方 —— 很多人当年图省事 npx 跑了一次、又 npm i -g 装了一次，结果两个并存。

检查本地项目里有没有

npm ls @anthropic-ai/claude-code

如果有输出就说明当前目录的 package.json 里写着这个依赖。

检查全局有没有

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

全局版本一般装在 /usr/local/lib/node_modules、/opt/homebrew/lib/node_modules，或者 nvm 用户的 ~/.nvm/versions/node/<版本>/lib/node_modules。

小贴士：两边都查一下，本地、全局都有的情况非常常见，漏卸一边卸了也没用。

第二步：执行卸载

卸本地

npm uninstall @anthropic-ai/claude-code

卸全局

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

注意如果你的全局目录在系统路径下（比如 /usr/local），可能需要加 sudo。

跑完之后回头再看一眼：

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

应当显示 (empty) 或者直接报「找不到」，那才算这一步过关。

第三步：清理残留目录

npm uninstall 偶尔会留下空壳目录、子依赖没回收干净，手动扫一遍最保险。

看一下本地的 node_modules

ls -la ~/node_modules/@anthropic-ai

如果还有目录，直接删：

rm -rf ~/node_modules/@anthropic-ai

看一下全局 node_modules

先找出全局根路径：

npm root -g
# 示例输出：/opt/homebrew/lib/node_modules

然后照着这个路径删：

sudo rm -rf /opt/homebrew/lib/node_modules/@anthropic-ai

⚠️ 路径以 npm root -g 实际输出为准。如果你用的是 nvm，路径会带上 Node 版本号，别复制粘贴跨机器用。

第四步：清 npm 缓存（可选但推荐）

npm 会把每个版本的 tar 包缓存到 ~/.npm/_cacache。如果你打算再重装，旧版本残骸可能让 npm 直接命中缓存而不去拉新包：

npm cache clean --force

如果你卸 Claude Code 是为了换版本，这一步强烈建议跑。

第五步：扫一遍残留引用

最后这步是彻底党的执念，但确实救命：

用户目录 grep

grep -r "@anthropic-ai/claude-code" ~ 2>/dev/null

会扫出所有还引用着这个包的 package.json、package-lock.json、shell 别名、CI 脚本，逐个处理掉。

全盘 find（慢，按需）

sudo find / -name "claude-code" 2>/dev/null

会列出系统里所有名字含 claude-code 的目录或文件，看一眼有没有意外残留。

✅ 验收清单

走完上面五步，对照下面这份 check list 一条条打钩：

npm ls @anthropic-ai/claude-code 在所有项目里都查不到
npm ls -g @anthropic-ai/claude-code 全局也查不到
~/node_modules/@anthropic-ai、<global root>/@anthropic-ai 都没了
npm cache clean --force 跑过
grep -r / find / 没有意外引用

全部打钩，恭喜，你的系统已经彻底干净了。

卸完之后？两条路

A. 换平台 / 暂时不用了

那就到此为止，这篇就是给你的。Bye-bye Claude Code。

B. 想重装得更省事

那别走老路了。OpenClaw 拼车一行 setup.sh 帮你把 token、配置文件、auth profile 全部配好，新装的 Claude Code 一启动就能跑：

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

脚本做的事情：

下载并安装最新版 Claude Code（如果你删干净了的话）
写入 ~/.claude.json 的 auth profile，指向 OpenClaw 拼车网关
在 ~/.zshrc / ~/.bashrc 末尾加一段 ANTHROPIC_* 环境变量
跑一次 claude --version 自检

执行完之后开新终端、claude 直接进入聊天，不需要再去碰 npm 任何配置。

常见踩坑

卸完之后 `claude` 命令还在

多半是因为 shell 缓存了二进制路径：

hash -r           # bash / zsh 都行
which claude      # 确认是不是真的还在

如果 which 还能找到，就是有第二份安装（比如 /usr/local/bin/claude 软链）没清掉，沿着软链找过去删掉即可。

`npm uninstall -g` 报权限错

在系统路径上装的全局包必须 sudo：

sudo npm uninstall -g @anthropic-ai/claude-code

或者更长远：把全局 prefix 改到 ~/.npm-global，从此告别 sudo。

Windows 上怎么卸？

Windows 一般装在 %APPDATA%\npm\node_modules\@anthropic-ai\ 下。在 PowerShell 里：

npm uninstall -g @anthropic-ai/claude-code
Remove-Item -Recurse -Force "$env:APPDATA\npm\node_modules\@anthropic-ai"
npm cache clean --force

剩下的步骤跟 macOS / Linux 一致。

立即开始

卸完不代表要告别，反而是新起点。OpenClaw 拼车把 Claude Max 20x 拆出多人共享的 token，重装一次就再也不用为额度焦虑：

curl -fsSL https://cp.bizq.net/setup.sh | bash -s -- claude-max-20x

更多上手教程见 https://cp.bizq.net。

如何清理本地 Claude Code 缓存和数据 — 卸载之外，还要清掉 ~/.claude 配置
OpenClaw VPS 部署指南 — 想在服务器上跑 OpenClaw 看这篇
CLAUDE.md 约束提示词指南 — 重装之后第一件事，给 Claude 上规矩

Windows 安装 Claude Code 完整指南：免 WSL 直装 + 拼车一键接入如何清理本地 Claude Code 缓存和配置（macOS / Windows 双系统）