彻底卸载Claude Code的完整清理教程实用指南

作者：袖梨 2026-08-23

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“彻底卸载Claude Code的完整清理教程”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

一、为什么要彻底卸载？
二、卸载前的准备工作
- 2.1 确认安装方式
- 2.2 备份设置文件（可选）
三、卸载 Claude Code
- 3.1 Native 原生安装（建议方式）
- 3.2 npm 安装（全局安装）
- 3.3 Homebrew 安装（macOS）
- 3.4 Windows 用户（补充）
四、卸载 OpenCode
- 4.1 原生脚本安装
- 4.2 npm 安装
- 4.3 Homebrew 安装
- 4.4 彻底清理残留
五、清理残留设置文件（终极清理）
- 5.1 Claude Code 设置文件位置
- 5.2 OpenCode 设置文件位置
- 5.3 清理环境变量
六、验证卸载成功
- 6.1 检查命令是否存在
- 6.2 检查残留文件
- 6.3 检查 npm 全局包
七、常用问题解答
- Q1：卸载后重装，为什么还是报同样的错误？
- Q2：npm uninstall -g后，which claude还能找到？
- Q3：如何确认我当初用的是哪种安装方式？
- Q4：不小心删错了设置文件，能恢复吗？
- Q5：卸载后，终端还提示“claude: command not found”但路径很长？
- Q6：我想完全重装，应该先卸载还是先备份？
八、更快参考卡片
- Claude Code 卸载速查表
- OpenCode 卸载速查表
- 终极清理命令（一键执行）
总结

实际处理时，从 MacBook Pro Intel 芯片到全平台，手把手教你干干净净地卸载

实际处理时，安装教程出了之后，很多小伙伴在想“怎么卸载？”“重装的时候老是报错怎么办？”“设置文件删不干净怎么办？”**

从实现思路看，今天这篇教程，就专门解决这个问题。无论你是想重装、换安装方式，还是彻底告别这两个工具，跟着这份指南走，保证清理得干干净净，不留一丝痕迹。

一、为什么要彻底卸载？

你可能会想：不就是卸载个工具吗，直接拖进废纸篓不就行了？

没那么轻松！ 若只是轻松删除，通常会留下以下残留：

残留类型	说明	后果
设置文件	`~/.claude.json`、`~/.opencode/`	重装后设置冲突，旧设置干扰新版本
缓存数据	`~/.cache/` 下的缓存目录	占用磁盘空间，可能引起版本兼容问题
环境变量	PATH 中的残留路径	终端提示 `command not found` 或找到错误版本
npm 全局包	全局安装的包	即使删除了可执行文件，npm 仍认为已安装

什么情况下需彻底卸载？

准备重新安装（从 npm 切换到 Native 安装）
遇到莫名其妙的 bug 需排查
版本升级后设置冲突
不再采用该工具，想清理系统

二、卸载前的准备工作

2.1 确认安装方式

结合项目来看，在动手之前，先确认你是借助哪种方式安装的。不同安装方式，卸载方法也不同。

检查 Claude Code 安装方式：

# 查看 claude 命令的位置
which claude
# 查看版本
claude --version

根据输出判断：

~/.local/bin/claude 或 /usr/local/bin/claude → Native 原生安装
/opt/homebrew/bin/claude 或 /usr/local/bin/claude（brew 路径）→ Homebrew 安装
指向 nvm 目录 → npm 安装

检查 OpenCode 安装方式：

which opencode
opencode --version

2.2 备份设置文件（可选）

若你打算以后重新安装，建议先备份设置文件，便于恢复设置：

# 备份 Claude Code 配置
cp ~/.claude.json ~/.claude.json.backup 2>/dev/null
cp -r ~/.claude ~/.claude.backup 2>/dev/null

# 备份 OpenCode 配置
cp -r ~/.opencode ~/.opencode.backup 2>/dev/null

三、卸载 Claude Code

理解这一步时，Claude Code 的卸载方式取决于你的安装方法。根据安装教程中的三种方式，选择对应的卸载命令。

3.1 Native 原生安装（建议方式）

若你用的是官方建议的原生脚本安装，卸载最轻松：

# 方法一：使用内置卸载命令（推荐）
claude uninstall

这是最干净的方式，会自动删除可执行文件和基本设置。

如果 claude uninstall 命令不可用，能够手动删除：

# 删除 Claude 主目录
rm -rf ~/.claude

# 删除本地 bin 中的可执行文件
rm -f ~/.local/bin/claude

# 删除可能的其他位置
rm -f /usr/local/bin/claude

3.2 npm 安装（全局安装）

如果你是借助 npm install -g @anthropic-ai/claude-code 安装的：

# 标准卸载命令
npm uninstall -g @anthropic-ai/claude-code

特别注意（nvm 用户）：

若你采用 nvm 管理 Node.js 版本，npm 全局包是按 Node 版本独立安装的。需从每个 Node 版本中分别卸载：

# 列出所有已安装的 Node 版本
nvm list

# 切换到每个版本并卸载
nvm use 18
npm uninstall -g @anthropic-ai/claude-code

nvm use 20
npm uninstall -g @anthropic-ai/claude-code

# 继续处理其他版本...

3.3 Homebrew 安装（macOS）

如果你用的是 Homebrew：

# 卸载包
brew uninstall --cask claude-code

# 清理缓存
brew cleanup claude-code

# 删除可能残留的符号链接
brew unlink claude-code 2>/dev/null

3.4 Windows 用户（补充）

如果你在 Windows 上借助 PowerShell 原生安装：

# 删除 Claude 目录
Remove-Item -Recurse -Force "$env:USERPROFILE.claude"

# 删除本地程序目录中的可执行文件
Remove-Item -Force "$env:LOCALAPPDATAProgramsclaudeclaude.exe" -ErrorAction SilentlyContinue

如果借助 WinGet 安装：

winget uninstall Anthropic.ClaudeCode

四、卸载 OpenCode

OpenCode 同样根据安装方式选择对应的卸载命令。

4.1 原生脚本安装

# 删除 OpenCode 主目录
rm -rf ~/.opencode

# 删除可执行文件（根据实际安装位置调整）
rm -f ~/.local/bin/opencode
rm -f /usr/local/bin/opencode

4.2 npm 安装

OpenCode 的 npm 包名是 opencode-ai：

# 卸载 OpenCode
npm uninstall -g opencode-ai

# 清理 npm 缓存
npm cache clean --force

验证卸载：

# 检查是否还有残留
which opencode  # 应该返回空
opencode --version  # 应该报错 "command not found"

4.3 Homebrew 安装

# 卸载 OpenCode
brew uninstall opencode

4.4 彻底清理残留

实际处理时，根据用户反馈，有时候 npm 卸载后，设置文件目录可能还在，需手动删除：

# 删除配置目录（重要！）
rm -rf ~/.config/opencode
rm -rf ~/.opencode

五、清理残留设置文件（终极清理）

理解这一步时，这是最容易被忽略的一步！即使执行了卸载命令，设置文件和缓存数据通常还留在系统中。若不清理这些残留，重装后可能会遇到奇怪的设置冲突。

5.1 Claude Code 设置文件位置

类型	路径	说明
主设置文件	`~/.claude.json`	API 密钥、用户设置
设置目录	`~/.claude/`	MCP 设置、本地设置、缓存
缓存目录	`~/.cache/claude-code/`	临时缓存文件
设置目录（新版）	`~/.claude-code/`	部分版本采用
应用兼容（macOS）	`~/Library/Application Support/claude-code/`	macOS 专属

彻底删除命令（macOS/Linux）：

# 删除配置文件
rm -f ~/.claude.json

# 删除配置目录
rm -rf ~/.claude
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code
rm -rf ~/.cache/claude-code

# macOS 专属：删除应用支持目录
rm -rf ~/Library/Application Support/claude-code
rm -rf ~/Library/Caches/claude-code

Windows PowerShell 命令：

Remove-Item -Force "$env:USERPROFILE.claude.json" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:USERPROFILE.claude" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:APPDATAclaude-code" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATAclaude-code" -ErrorAction SilentlyContinue

5.2 OpenCode 设置文件位置

类型	路径	说明
设置目录	`~/.opencode/`	全局设置、插件、会话历史
项目设置	`./opencode.json`	项目级设置（每个项目单独清理）
缓存目录	`~/.cache/opencode/`	缓存数据

彻底删除命令（macOS/Linux）：

# 删除主配置目录
rm -rf ~/.opencode

# 删除配置目录（备选位置）
rm -rf ~/.config/opencode

# 删除缓存
rm -rf ~/.cache/opencode

# 可选：全局搜索残留
find ~ -name "*opencode*" -type d 2>/dev/null

5.3 清理环境变量

检查并清理 shell 设置文件中的 PATH 条目：

# 打开配置文件（根据你的 shell 选择）
# macOS 默认使用 zsh
nano ~/.zshrc

# 或 bash 用户
nano ~/.bash_profile

查找并删除类似以下的 PATH 添加语句：

export PATH="$HOME/.claude/bin:$PATH"
export PATH="$HOME/.local/bin:$PATH"  # 如果只用于 claude/opencode
export PATH="$HOME/.opencode/bin:$PATH"

保存后重新加载设置：

source ~/.zshrc  # 或 source ~/.bash_profile

六、验证卸载成功

完成以上步骤后，执行以下命令验证工具已完全移除：

6.1 检查命令是否存在

# 检查 claude 命令
which claude
type -a claude
command -v claude

# 检查 opencode 命令
which opencode
type -a opencode
command -v opencode

预期结果：所有命令都应该得到空或 not found。

6.2 检查残留文件

# 检查常见残留位置
ls -la ~/.claude* 2>/dev/null
ls -la ~/.opencode* 2>/dev/null
ls -la ~/.config/claude* 2>/dev/null
ls -la ~/.config/opencode* 2>/dev/null
ls -la ~/.cache/claude* 2>/dev/null
ls -la ~/.cache/opencode* 2>/dev/null

预期结果：应显示 No such file or directory。

6.3 检查 npm 全局包

# 列出所有全局 npm 包
npm list -g --depth=0

# 确保 claude 和 opencode 相关包不在列表中

七、常用问题解答

Q1：卸载后重装，为什么还是报同样的错误？

A：说明设置文件没有清理干净。执行第五章的「彻底清理残留设置文件」后重试。

这种情况通常是因为 ~/.claude.json 或 ~/.opencode/ 目录还在，残留的设置与新版本不兼容。

Q2：npm uninstall -g后，which claude还能找到？

A：可能的原因：

有多个安装方式共存（比如同时有 npm 和 Native 安装）
PATH 中还有残留路径

解决方法：

# 找到所有 claude 命令的位置
type -a claude

# 根据输出，手动删除所有找到的路径
rm -f /path/to/each/claude

Q3：如何确认我当初用的是哪种安装方式？

A：借助以下命令判断：

安装方式	命令输出特征
Native	`claude --version` 正常，`npm list -g \| grep claude` 无结果
npm	`npm list -g \| grep claude-code` 有输出
Homebrew	`brew list \| grep claude` 有输出

Q4：不小心删错了设置文件，能恢复吗？

A：如果你按照第二章做了备份，能够恢复：

# 恢复 Claude Code 配置
cp ~/.claude.json.backup ~/.claude.json
cp -r ~/.claude.backup ~/.claude

# 恢复 OpenCode 配置
cp -r ~/.opencode.backup ~/.opencode

Q5：卸载后，终端还提示“claude: command not found”但路径很长？

A：这是 shell 的哈希缓存导致的。执行以下命令刷新：

# 清除命令哈希缓存
hash -r

# 或重启终端
exec $SHELL

Q6：我想完全重装，应该先卸载还是先备份？

A：先备份，再卸载，最后重装。

正确顺序：

备份设置文件（如需保留设置）
执行卸载命令
清理残留设置文件
验证卸载成功
执行全新安装

八、更快参考卡片

Claude Code 卸载速查表

安装方式	卸载命令
Native 原生	`claude uninstall`
npm	`npm uninstall -g @anthropic-ai/claude-code`
Homebrew	`brew uninstall --cask claude-code`
设置文件清理	`rm -rf ~/.claude ~/.claude.json ~/.claude-code`

OpenCode 卸载速查表

安装方式	卸载命令
npm	`npm uninstall -g opencode-ai`
Homebrew	`brew uninstall opencode`
设置文件清理	`rm -rf ~/.opencode ~/.config/opencode`

终极清理命令（一键执行）

警告：以下命令会永久删除所有设置和缓存，请确认已备份重要数据！

# Claude Code 完全清理
claude uninstall 2>/dev/null
npm uninstall -g @anthropic-ai/claude-code 2>/dev/null
brew uninstall --cask claude-code 2>/dev/null
rm -rf ~/.claude ~/.claude.json ~/.claude-code ~/.cache/claude-code
rm -rf ~/Library/Application Support/claude-code ~/Library/Caches/claude-code

# OpenCode 完全清理
npm uninstall -g opencode-ai 2>/dev/null
brew uninstall opencode 2>/dev/null
rm -rf ~/.opencode ~/.config/opencode ~/.cache/opencode

# 刷新命令缓存
hash -r

echo "✨ 清理完成！请重启终端确认。"