教程卸载Claude Code 2026-06-18 497 次阅读

Claude Code 完全干净卸载教程：完全清理 Claude Code 及其相关组件

Claude Code 多平台卸载教程（macOS/Windows/Linux），彻底删除程序、配置文件和缓存。
Claude Code 完全干净卸载教程：完全清理 Claude Code 及其相关组件



macOS 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、ccr 配置、飞书桥接。卸载前建议备份：cp -r ~/.claude ~/.claude.bak

第一步：卸载 Claude Code

Claude Code 有两种安装方式，先判断你用的是哪种：

# 检查安装方式：三条一起看
which claude 2>/dev/null || echo "claude 不在 PATH，可能已卸载"
npm ls -g --depth=0 2>/dev/null | grep claude-code && echo "npm 安装" || echo "非 npm 安装"
ls ~/.local/share/claude/versions/ 2>/dev/null && echo "官方脚本安装"
ls ~/.npm-global/bin/claude 2>/dev/null && echo "npm 用户目录安装（~/.npm-global）"

只看 ~/.local/share/claude/versions/ 会误判 —— 两种方式都没装时它同样不存在，也会输出"npm 安装"。用 which claude 先确认装没装，再用 npm ls -g 判断是不是 npm 装的。

补充：如果安装时把 npm 全局目录改到了用户目录（npm config set prefix ~/.npm-global，即安装教程里"没有 sudo 权限"的方案），which claude 在脚本等非交互环境里可能找不到它（PATH 导出写在 .bashrc，非交互 shell 不加载）。以 npm ls -g 的结果为准即可，不影响卸载。

方式一：官方脚本安装（显示"官方脚本安装"）

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

方式二：npm 安装（显示"npm 安装"）

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

如果是通过 Homebrew 安装的，额外执行：

brew uninstall --cask claude-code 2>/dev/null

第二步：卸载 ccr 格式转换代理（如果安装了）

npm uninstall -g claude-code-router

没安装 ccr 的话，这条命令会输出 up to date 并正常退出，属于预期，直接看下一步即可。如果命令报错但 ccr 仍在，执行以下手动清理：

# 手动清理 npm 全局残留
rm -rf ~/.npm-global/lib/node_modules/claude-code-router
rm -f ~/.npm-global/bin/ccr
# 查找并删除其他可能的安装位置
npm root -g | xargs -I {} rm -rf {}/claude-code-router 2>/dev/null
npm bin -g | xargs -I {} rm -f {}/ccr 2>/dev/null

ccr 是专门为 Claude Code 做格式转换的代理，Claude Code 卸载后 ccr 也没有用处了，建议一并清理。

停止正在运行的 ccr 进程：

pkill -f "claude-code-router" 2>/dev/null

pkill -f 按完整命令行匹配，会把命令行里含这些字的其他进程一起杀掉（包括你自己正开着的终端会话）。如果执行后终端莫名断开，改用 pgrep -af claude-code-router 先列出 PID，再 kill <PID>。

第三步：卸载 larkcc 飞书桥接（如果安装了）

npm uninstall -g larkcc

桥接正在运行也可以直接卸载（先卸包、再停进程），顺序不影响；卸载后机器人立即停止工作。

停止正在运行的 larkcc 进程：

pkill -f "larkcc" 2>/dev/null

同上，pkill -f 会误伤命令行里含 larkcc 的进程；建议先 pgrep -af larkcc 看清单再按 PID kill。

第四步：删除配置文件和数据

rm -rf ~/.claude
rm -f ~/.claude.json
rm -rf ~/.claude-code-router
rm -rf ~/.larkcc
rm -rf ~/.local/share/claude
rm -f ~/.local/bin/claude
# 清 npm 缓存（可能有几十到一百多 MB，视使用量而定，清完整个消失）
npm cache clean --force 2>/dev/null
# 删 npm 全局包卸除后留下的空 scope 目录
rm -rf "$(npm root -g)/@anthropic-ai" 2>/dev/null

这些目录包含会话记录、记忆、权限设置、ccr 配置和飞书桥接配置，删除后无法恢复。

第五步：清理环境变量

检查并删除 ~/.zshrc 或 ~/.bash_profile 中的 Claude Code 相关配置：

grep -n -i claude ~/.zshrc
grep -n -i claude ~/.bash_profile

如果有输出，用编辑器打开对应文件，删除所有包含 claude、ANTHROPIC、CLAUDE 的行。

如果你是按《安装与配置完全指南》用配置文件接入的模型（~/.claude/settings.json），ANTHROPIC_* 变量写在该文件里，而它在 ~/.claude/ 目录下，第四步已经随目录一并删除，这里无需再处理。只有当初把 export ANTHROPIC_* 写进 bashrc/zshrc 的，才需要按上面步骤手动删。

保存后重新加载：

source ~/.zshrc

第六步：验证卸载完成

确认所有组件已清除：

which claude 2>/dev/null && echo "未卸载" || echo "claude 已清除"
which ccr 2>/dev/null && echo "未卸载" || echo "ccr 已清除"
which larkcc 2>/dev/null && echo "未卸载" || echo "larkcc 已清除"
ls ~/.claude 2>/dev/null && echo "未清除" || echo "~/.claude 已清除"
ls ~/.claude.json 2>/dev/null && echo "未清除" || echo "~/.claude.json 已清除"
ls ~/.claude-code-router 2>/dev/null && echo "未清除" || echo "~/.claude-code-router 已清除"
ls ~/.larkcc 2>/dev/null && echo "未清除" || echo "~/.larkcc 已清除"
grep -i ANTHROPIC ~/.zshrc 2>/dev/null && echo "环境变量未清理" || echo "环境变量已清除"
npm ls -g --depth=0 2>/dev/null | grep -E "claude-code|larkcc|claude-code-router" && echo "npm 包未卸净" || echo "npm 包已卸净"
ls ~/.npm/_cacache 2>/dev/null && echo "npm 缓存未清" || echo "npm 缓存已清"
ls "$(npm root -g)/@anthropic-ai" 2>/dev/null && echo "空 scope 目录残留" || echo "scope 目录已清"
ps aux | grep -E "[c]laude-code-router|[l]arkcc" | grep -v grep && echo "未停止" || echo "所有进程已停止"

如果全部显示"已清除"且进程已停止，说明卸载完成。

补充：容易遗漏的残留

以下位置主流程不覆盖，实测卸载后仍然存在，需要的话手动清理：

# 运行时临时目录（文件监视探针等，重启也会自动清）
rm -rf /tmp/claude-*
# npm 调试日志
rm -rf ~/.npm/_logs
# 卸载前做的备份（确认不用了再删，里面可能有 API Key）
rm -rf ~/.claude.bak
# 「改 prefix 安装」用户专有：npm 空壳目录
rm -rf ~/.npm-global

如果把 npm 全局目录改到过用户目录，再把 .bashrc（或 .zshrc）里这行删掉：

export PATH=$HOME/.npm-global/bin:$PATH

安装时设的 npm 国内镜像（registry）不用重置，留着对以后装别的包也有用；介意的话执行 npm config delete registry 即可恢复官方源。

附加：Node.js 要不要一起删？

如果这台机器是专为 Claude Code 装的 Node.js，卸完 Claude Code 后它可以一并删除。先 which node 确认安装方式，再选对应命令：

nvm 安装，或装在 ~/.local/opt 的 Node：

rm -rf ~/.local/opt/node-*
# nvm 用户还要删 ~/.nvm：
rm -rf ~/.nvm

NodeSource（apt）安装的 Node（安装教程 Linux 线用的就是这种）：

sudo apt remove -y nodejs

Homebrew 安装的 Node（macOS）：

brew uninstall node@22

如果机器上还有别的项目在用 Node，请不要删。删除前用 which node 确认路径，避免误删系统自带的那个。

卸载完成后，参考对应平台的安装教程重新安装：Claude Code 安装与配置完全指南（macOS/Windows/Linux）

重装后需要重新登录账号，之前的会话和记忆无法恢复。

Windows 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、ccr 配置、飞书桥接。卸载前建议备份：Copy-Item -Recurse ~/.claude ~/.claude.bak

第一步：卸载 Claude Code

请以管理员身份运行 PowerShell

Claude Code 有多种安装方式，先判断你用的是哪种：

# 检查安装方式：四条一起看
where.exe claude 2>$null; if ($LASTEXITCODE -ne 0) { echo "claude 不在 PATH，可能已卸载" }
npm ls -g --depth=0 2>$null | Select-String "claude-code"; if ($LASTEXITCODE -ne 0) { echo "非 npm 安装" } else { echo "npm 安装" }
Test-Path ~/.local/share/claude/versions/ && Write-Host "官方脚本安装" -ForegroundColor Green
Test-Path ~/.npm-global/bin/claude.cmd && Write-Host "npm 用户目录安装" -ForegroundColor Green

只看 ~/.local/share/claude/versions/ 会误判 —— 两种方式都没装时它同样不存在，也会输出"npm 安装"。先用 where.exe claude 确认装没装，再用 npm ls -g 判断是不是 npm 装的。

补充：如果安装时把 npm 全局目录改到了用户目录（安装教程里权限不足的解决方案），where.exe claude 可能找不到它，以 npm ls -g 的结果为准即可，不影响卸载。

方式一：官方脚本安装（显示"官方脚本安装"）

Remove-Item ~/.local/bin/claude.exe -Force -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force ~/.local/share/claude -ErrorAction SilentlyContinue

方式二：npm 安装（显示"npm 安装"）

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

方式三：WinGet 安装（如果用了 winget）

winget uninstall Anthropic.ClaudeCode

第二步：卸载 ccr 格式转换代理（如果安装了）

npm uninstall -g claude-code-router

没安装 ccr 的话，这条命令会输出 up to date 并正常退出，属于预期，直接看下一步即可。如果命令报错但 ccr 仍在，执行以下手动清理：

# 手动清理 npm 全局残留
$npmRoot = npm root -g
Remove-Item -Recurse -Force "$npmRoot\claude-code-router" -ErrorAction SilentlyContinue
$npmBin = npm bin -g
Remove-Item -Force "$npmBin\ccr.cmd" -ErrorAction SilentlyContinue
Remove-Item -Force "$npmBin\ccr" -ErrorAction SilentlyContinue

ccr 是专门为 Claude Code 做格式转换的代理，Claude Code 卸载后 ccr 也没有用处了，建议一并清理。

停止正在运行的 ccr 进程：

taskkill /F /IM "node.exe" /FI "WINDOWTITLE eq *claude-code-router*" 2>$null

第三步：卸载 larkcc 飞书桥接（如果安装了）

npm uninstall -g larkcc

桥接正在运行也可以直接卸载（先卸包、再停进程），顺序不影响；卸载后机器人立即停止工作。

停止正在运行的 larkcc 进程：

taskkill /F /IM "node.exe" /FI "WINDOWTITLE eq *larkcc*" 2>$null

第四步：删除配置文件和数据

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.claude.json" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude-code-router" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.larkcc" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE\.local\share\claude" -ErrorAction SilentlyContinue
Remove-Item -Force "$env:USERPROFILE\.local\bin\claude.exe" -ErrorAction SilentlyContinue
# 清 npm 缓存（可能有几十到一百多 MB，视使用量而定，清完整个消失）
npm cache clean --force 2>$null
# 删 npm 全局包卸除后留下的空 scope 目录
$npmRoot = npm root -g
Remove-Item -Recurse -Force "$npmRoot\@anthropic-ai" -ErrorAction SilentlyContinue

这些目录包含会话记录、记忆、权限设置、ccr 配置和飞书桥接配置，删除后无法恢复。

第五步：清理环境变量

  1. 按 Win + R，输入 sysdm.cpl，回车
  2. 点击 高级 → 环境变量
  3. 在 用户变量 中检查是否有 Claude Code 相关的 PATH 条目
  4. 如果有，选中并删除
  5. 点击确定保存

如果你是用配置文件接入的模型（~/.claude/settings.json），ANTHROPIC_* 变量写在该文件里，第四步已随 ~/.claude 目录一并删除，这里通常不需要再改系统环境变量。

第六步：验证卸载完成

where.exe claude 2>$null; if ($LASTEXITCODE -ne 0) { echo "claude 已清除" } else { echo "未卸载" }
where.exe ccr 2>$null; if ($LASTEXITCODE -ne 0) { echo "ccr 已清除" } else { echo "未卸载" }
where.exe larkcc 2>$null; if ($LASTEXITCODE -ne 0) { echo "larkcc 已清除" } else { echo "未卸载" }
Test-Path "$env:USERPROFILE\.claude"
Test-Path "$env:USERPROFILE\.claude.json"
Test-Path "$env:USERPROFILE\.claude-code-router"
Test-Path "$env:USERPROFILE\.larkcc"
Get-Process node -ErrorAction SilentlyContinue | Where-Object {$_.Path -match "larkcc|claude-code-router"} | Stop-Process -Force -ErrorAction SilentlyContinue
# 补 4 项验证（bash 版同理）
npm ls -g --depth=0 2>$null | Select-String -Pattern "claude-code|larkcc|claude-code-router"; if ($LASTEXITCODE -ne 0) { echo "npm 包已卸净" }
npm cache clean --force 2>$null
$npmRoot = npm root -g
Remove-Item -Recurse -Force "$npmRoot\@anthropic-ai" -ErrorAction SilentlyContinue

如果 claude/ccr/larkcc 均显示"已清除"，路径均显示 False，说明卸载完成。

补充：容易遗漏的残留

以下位置主流程不覆盖，实测卸载后仍然存在，需要的话手动清理：

# 运行时临时目录（重启也会自动清）
Remove-Item -Recurse -Force "$env:TEMP\claude-*" -ErrorAction SilentlyContinue
# npm 调试日志
Remove-Item -Recurse -Force "$env:USERPROFILE\.npm\_logs" -ErrorAction SilentlyContinue
# 卸载前做的备份（确认不用了再删，里面可能有 API Key）
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude.bak" -ErrorAction SilentlyContinue

安装时设的 npm 国内镜像（registry）不用重置，留着对以后装别的包也有用；介意的话把用户目录 .npmrc 里的 registry= 那一行删掉即可。

附加：Node.js 要不要一起删？

如果这台机器是专为 Claude Code 装的 Node.js，卸完 Claude Code 后它可以一并删除。先 which node 确认安装方式，再选对应命令：

nvm 安装，或装在 ~/.local/opt 的 Node：

rm -rf ~/.local/opt/node-*
# nvm 用户还要删 ~/.nvm：
rm -rf ~/.nvm

NodeSource（apt）安装的 Node（安装教程 Linux 线用的就是这种）：

sudo apt remove -y nodejs

Homebrew 安装的 Node（macOS）：

brew uninstall node@22

如果机器上还有别的项目在用 Node，请不要删。删除前用 which node 确认路径，避免误删系统自带的那个。

卸载完成后，参考对应平台的安装教程重新安装：Claude Code 安装与配置完全指南（macOS/Windows/Linux）

重装后需要重新登录账号，之前的会话和记忆无法恢复。

Linux 卸载教程（Ubuntu / Debian）

删除配置目录会清除所有会话、记忆、权限设置、ccr 配置、飞书桥接。卸载前建议备份：cp -r ~/.claude ~/.claude.bak

第一步：卸载 Claude Code

Claude Code 有两种安装方式，先判断你用的是哪种：

# 检查安装方式：三条一起看
which claude 2>/dev/null || echo "claude 不在 PATH，可能已卸载"
npm ls -g --depth=0 2>/dev/null | grep claude-code && echo "npm 安装" || echo "非 npm 安装"
ls ~/.local/share/claude/versions/ 2>/dev/null && echo "官方脚本安装"
ls ~/.npm-global/bin/claude 2>/dev/null && echo "npm 用户目录安装（~/.npm-global）"

只看 ~/.local/share/claude/versions/ 会误判 —— 两种方式都没装时它同样不存在，也会输出"npm 安装"。用 which claude 先确认装没装，再用 npm ls -g 判断是不是 npm 装的。

补充：如果安装时把 npm 全局目录改到了用户目录（npm config set prefix ~/.npm-global，即安装教程里"没有 sudo 权限"的方案），which claude 在脚本等非交互环境里可能找不到它（PATH 导出写在 .bashrc，非交互 shell 不加载）。以 npm ls -g 的结果为准即可，不影响卸载。

方式一：官方脚本安装（显示"官方脚本安装"）

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

方式二：npm 安装（显示"npm 安装"）

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

第二步：卸载 ccr 格式转换代理（如果安装了）

npm uninstall -g claude-code-router

没安装 ccr 的话，这条命令会输出 up to date 并正常退出，属于预期，直接看下一步即可。如果命令报错但 ccr 仍在，执行以下手动清理：

# 手动清理 npm 全局残留
rm -rf ~/.npm-global/lib/node_modules/claude-code-router
rm -f ~/.npm-global/bin/ccr
# 查找并删除其他可能的安装位置
npm root -g | xargs -I {} rm -rf {}/claude-code-router 2>/dev/null
npm bin -g | xargs -I {} rm -f {}/ccr 2>/dev/null

ccr 是专门为 Claude Code 做格式转换的代理，Claude Code 卸载后 ccr 也没有用处了，建议一并清理。

停止正在运行的 ccr 进程：

pkill -f "claude-code-router" 2>/dev/null

pkill -f 按完整命令行匹配，会把命令行里含这些字的其他进程一起杀掉（包括你自己正开着的终端会话）。如果执行后终端莫名断开，改用 pgrep -af claude-code-router 先列出 PID，再 kill <PID>。

第三步：卸载 larkcc 飞书桥接（如果安装了）

npm uninstall -g larkcc

桥接正在运行也可以直接卸载（先卸包、再停进程），顺序不影响；卸载后机器人立即停止工作。

停止正在运行的 larkcc 进程：

pkill -f "larkcc" 2>/dev/null

同上，pkill -f 会误伤命令行里含 larkcc 的进程；建议先 pgrep -af larkcc 看清单再按 PID kill。

第四步：删除配置文件和数据

rm -rf ~/.claude
rm -f ~/.claude.json
rm -rf ~/.claude-code-router
rm -rf ~/.larkcc
rm -rf ~/.local/share/claude
rm -f ~/.local/bin/claude
# 清 npm 缓存（可能有几十到一百多 MB，视使用量而定，清完整个消失）
npm cache clean --force 2>/dev/null
# 删 npm 全局包卸除后留下的空 scope 目录
rm -rf "$(npm root -g)/@anthropic-ai" 2>/dev/null

这些目录包含会话记录、记忆、权限设置、ccr 配置和飞书桥接配置，删除后无法恢复。

第五步：清理环境变量

检查并删除 ~/.bashrc 或 ~/.profile 中的 Claude Code 相关配置：

grep -n -i claude ~/.bashrc
grep -n -i ANTHROPIC ~/.bashrc
grep -n -i claude ~/.profile
grep -n -i ANTHROPIC ~/.profile

如果有输出，用编辑器打开对应文件，删除所有包含 claude、ANTHROPIC、CLAUDE、claude-code-router、larkcc 的行。

如果你是按《安装与配置完全指南》用配置文件接入的模型（~/.claude/settings.json），ANTHROPIC_* 变量写在该文件里，而它在 ~/.claude/ 目录下，第四步已经随目录一并删除，这里无需再处理。只有当初把 export ANTHROPIC_* 写进 bashrc/zshrc 的，才需要按上面步骤手动删。

保存后重新加载：

source ~/.bashrc

第六步：验证卸载完成

确认所有组件已清除：

which claude 2>/dev/null && echo "未卸载" || echo "claude 已清除"
which ccr 2>/dev/null && echo "未卸载" || echo "ccr 已清除"
which larkcc 2>/dev/null && echo "未卸载" || echo "larkcc 已清除"
ls ~/.claude 2>/dev/null && echo "未清除" || echo "~/.claude 已清除"
ls ~/.claude.json 2>/dev/null && echo "未清除" || echo "~/.claude.json 已清除"
ls ~/.claude-code-router 2>/dev/null && echo "未清除" || echo "~/.claude-code-router 已清除"
ls ~/.larkcc 2>/dev/null && echo "未清除" || echo "~/.larkcc 已清除"
grep -i ANTHROPIC ~/.bashrc 2>/dev/null && echo "环境变量未清理" || echo "环境变量已清除"
npm ls -g --depth=0 2>/dev/null | grep -E "claude-code|larkcc|claude-code-router" && echo "npm 包未卸净" || echo "npm 包已卸净"
ls ~/.npm/_cacache 2>/dev/null && echo "npm 缓存未清" || echo "npm 缓存已清"
ls "$(npm root -g)/@anthropic-ai" 2>/dev/null && echo "空 scope 目录残留" || echo "scope 目录已清"
ps aux | grep -E "[c]laude-code-router|[l]arkcc" | grep -v grep && echo "未停止" || echo "所有进程已停止"

如果全部显示"已清除"且进程已停止，说明卸载完成。

补充：容易遗漏的残留

以下位置主流程不覆盖，实测卸载后仍然存在，需要的话手动清理：

# 运行时临时目录（文件监视探针等，重启也会自动清）
rm -rf /tmp/claude-*
# npm 调试日志
rm -rf ~/.npm/_logs
# 卸载前做的备份（确认不用了再删，里面可能有 API Key）
rm -rf ~/.claude.bak
# 「改 prefix 安装」用户专有：npm 空壳目录
rm -rf ~/.npm-global

如果把 npm 全局目录改到过用户目录，再把 .bashrc（或 .zshrc）里这行删掉：

export PATH=$HOME/.npm-global/bin:$PATH

安装时设的 npm 国内镜像（registry）不用重置，留着对以后装别的包也有用；介意的话执行 npm config delete registry 即可恢复官方源。

附加：Node.js 要不要一起删？

如果这台机器是专为 Claude Code 装的 Node.js，卸完 Claude Code 后它可以一并删除。先 which node 确认安装方式，再选对应命令：

nvm 安装，或装在 ~/.local/opt 的 Node：

rm -rf ~/.local/opt/node-*
# nvm 用户还要删 ~/.nvm：
rm -rf ~/.nvm

NodeSource（apt）安装的 Node（安装教程 Linux 线用的就是这种）：

sudo apt remove -y nodejs

Homebrew 安装的 Node（macOS）：

brew uninstall node@22

如果机器上还有别的项目在用 Node，请不要删。删除前用 which node 确认路径，避免误删系统自带的那个。

卸载完成后，参考对应平台的安装教程重新安装：Claude Code 安装与配置完全指南（macOS/Windows/Linux）

重装后需要重新登录账号，之前的会话和记忆无法恢复。

#Claude Code #卸载 #教程
← 上一篇
Claude Code 安装与配置完全指南：多平台安装到接入国内模型

评论 (0)

0 / 1000