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

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

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

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

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

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

什么情况下需要彻底卸载？

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

2.1 确认安装方式

在动手之前，先确认你是通过哪种方式安装的。不同安装方式，卸载方法也不同。

检查 Claude Code 安装方式：

GPT plus 代充 只需 145# 查看 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 备份配置文件（可选）

如果你打算以后重新安装，建议先备份配置文件，方便恢复设置：

GPT plus 代充 只需 145# 备份 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 的卸载方式取决于你的安装方法。根据安装教程中的三种方式，选择对应的卸载命令。

3.1 Native 原生安装（推荐方式）

如果你用的是官方推荐的原生脚本安装，卸载最简单：

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

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

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

GPT plus 代充 只需 145# 删除 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 版本中分别卸载：

GPT plus 代充 只需 145# 列出所有已安装的 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 原生安装：

GPT plus 代充 只需 145# 删除 Claude 目录 Remove-Item -Recurse -Force “$env:USERPROFILE.claude”

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

如果通过 WinGet 安装：

winget uninstall Anthropic.ClaudeCode 

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

4.1 原生脚本安装

GPT plus 代充 只需 145# 删除 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

验证卸载：

GPT plus 代充 只需 145# 检查是否还有残留 which opencode # 应该返回空 opencode –version # 应该报错 “command not found” 

4.3 Homebrew 安装

# 卸载 OpenCode brew uninstall opencode 

4.4 彻底清理残留

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

GPT plus 代充 只需 145# 删除配置目录（重要！） rm -rf ~/.config/opencode rm -rf ~/.opencode 

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

5.1 Claude Code 配置文件位置

彻底删除命令（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 命令：

GPT plus 代充 只需 145Remove-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 

彻底删除命令（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 条目：

GPT plus 代充 只需 145# 打开配置文件（根据你的 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” 

保存后重新加载配置：

GPT plus 代充 只需 145source ~/.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 检查残留文件

GPT plus 代充 只需 145# 检查常见残留位置 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 中还有残留路径

解决方法：

GPT plus 代充 只需 145# 找到所有 claude 命令的位置 type -a claude

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

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

A：通过以下命令判断：

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 的哈希缓存导致的。执行以下命令刷新：

GPT plus 代充 只需 145# 清除命令哈希缓存 hash -r

# 或重启终端 exec $SHELL

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

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

正确顺序：

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

Claude Code 卸载速查表

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. ✅ 重装前务必验证已完全清理