彻底卸载指南：Claude Code 和 OpenCode 完全清理教程

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

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

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

---

📋 目录

1. 为什么要彻底卸载
2. 卸载前的准备工作
3. 卸载 Claude Code
4. 卸载 OpenCode
5. 清理残留配置文件
6. 验证卸载成功
7. 常见问题解答

---

一、为什么要彻底卸载？

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

没那么简单！ 如果只是简单删除，通常会留下以下残留：

残留类型	说明	后果
配置文件	~/.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:LOCALAPPDATA\Programs\claude\claude.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:APPDATA\claude-code" -ErrorAction SilentlyContinue
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\claude-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：可能的原因：

1. 有多个安装方式共存（例如同时有 npm 和 Native 安装）
2. 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：先备份，再卸载，最后重装。

正确顺序：

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

---

八、快速参考卡片

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 "✨ 清理完成！请重启终端确认。"

---

写在最后

恭喜！你已经掌握了 Claude Code 和 OpenCode 的完全卸载方法。

核心要点回顾：

1. ✅ 先确认安装方式，再选择对应的卸载命令
2. ✅ 卸载后必须手动清理配置目录（这是 90% 问题的根源）
3. ✅ 检查 PATH 环境变量，移除残留路径
4. ✅ 重装前务必验证已完全清理