Claude Code 卸载与配置文件清理教程
先说一个核心判断：卸载 Claude Code 时，最容易被忽略的其实不是那个可执行文件，而是你辛辛苦苦积累下来的会话历史。如果只是把 claude 命令删掉，程序本身确实不在了——但用户目录下的设置、允许工具、MCP 服务器配置，以及历史会话都还完好无损地躺在那里。如果只是暂时不想用，卸载程序就够了，没必要动配置；但如果是想彻底告别，那就要分两步走，先删程序，再清配置。
不同操作系统和安装方式，卸载命令也完全不同。Windows、macOS、Linux 和 WSL 各有各的套路，Native 安装、Homebrew、WinGet、apt、dnf、apk 与 npm 这几条路径不能混用。开始之前，先关掉正在运行的 Claude Code、VS Code、JetBrains IDE 和 Claude Desktop，然后决定要不要保留配置数据。
先确认安装方式和保留范围
-
回到当初安装 Claude Code 的终端或系统包管理器，确认当时用的是官方 Native 安装脚本、Homebrew、WinGet、Linux 包管理器还是 npm。
入口位置：
只选择与原安装方式匹配的卸载分支。如果后面可能重装并继续使用旧会话，把“删除配置文件”视作可选步骤；如果准备彻底清理，先把用户目录中的主要动作：
.claude目录和.claude.json复制到别处备份一下。已经确定安装来源，并且明确了是“只卸载程序”还是“程序与配置一起清理”。成功标志：
无法确认来源时，不要连续执行多套卸载命令。先在新终端运行失败处理：
claude --version确认命令是否还存在，再检查常用包管理器的已安装列表或终端历史记录。
Native 安装在 macOS、Linux 或 WSL 中卸载
-
打开安装 Claude Code 的 macOS、Linux 或 WSL 终端。WSL 用户必须进入对应 Linux 发行版，不能在 PowerShell 中执行这组命令。
入口位置：
依次执行主要动作：
rm -f ~/.local/bin/claude和rm -rf ~/.local/share/claude。第一条删除命令入口，第二条删除 Native 安装保存的版本文件。两条命令结束后没有权限错误；关闭当前终端并重新打开，成功标志：
claude --version不再返回版本号。出现 Permission denied 时，先检查路径是否属于当前用户，以及是否在正确的 macOS、Linux 或 WSL 环境。不要把整段路径替换成不确定的系统目录。失败处理：
官方 Advanced setup 页面把 Native 安装的命令入口和版本目录分开删除。图中选中的是 macOS、Linux、WSL 分支，两个路径都位于当前用户的 .local 目录下。
Native 安装在 Windows PowerShell 中卸载
-
以普通权限打开 PowerShell。如果 Claude Code 安装在 WSL 中，应返回上一个 Linux 分支，不要在 Windows 用户目录中清理。
入口位置：
执行主要动作：
Remove-Item -Path "$env:USERPROFILE.localbinclaude.exe" -Force，再执行Remove-Item -Path "$env:USERPROFILE.localshareclaude" -Recurse -Force。PowerShell 返回提示符且没有红色错误；重新打开 PowerShell 后，成功标志：
claude --version不再识别该命令。提示路径不存在时，可能已经删除，或 Claude Code 并非通过 Native 方式安装。如果命令仍能运行，先转到后面的冲突安装检查，不要先删配置目录。失败处理：
Windows 分支同样删除 .localbin 中的程序和 .localshareclaude 中的版本文件。-Recurse 只用于版本目录，不要把用户目录本身作为删除目标。
包管理器安装只用对应卸载命令
-
打开与安装时相同的终端和包管理器。Homebrew 用 macOS 终端，WinGet 用 Windows 终端，apt、dnf、apk 用对应 Linux 发行版，npm 用原来执行全局安装的环境。
入口位置：
根据安装来源执行下面唯一匹配的一组命令。主要动作：
Homebrew stable：
brew uninstall --cask claude-code；latest：brew uninstall --cask claude-code@latest。WinGet：
winget uninstall Anthropic.ClaudeCode。apt：先执行
sudo apt remove claude-code，再删除/etc/apt/sources.list.d/claude-code.list与/etc/apt/keyrings/claude-code.asc。dnf：先执行
sudo dnf remove claude-code，再删除/etc/yum.repos.d/claude-code.repo。apk：执行
apk del claude-code，从/etc/apk/repositories删除包含 Claude Code apk 下载地址的仓库行，再删除/etc/apk/keys/claude-code.rsa.pub。npm：执行
npm uninstall -g @anthropic-ai/claude-code。
包管理器报告软件包已移除；Linux 包管理器分支的仓库配置与签名密钥也按官方命令清理完成。成功标志：
Homebrew 报未安装时，检查当初使用的是 stable 还是 latest cask；npm 报权限问题时，回到安装所用的 Node 环境，不要改用失败处理：
sudo npm uninstall。其他包管理器提示找不到包时，先确认系统发行版和原安装渠道。
npm 分支只删除全局软件包，不会自动删除用户配置。图中紧接着出现配置清理警告，说明“卸载程序”和“删除个人数据”是两个独立动作。
验证程序已卸载并排除重复安装
-
关闭卸载时使用的终端，重新打开一个新终端，避免旧 shell 缓存仍保留命令位置。
入口位置：
执行主要动作：
claude --version。预期结果是命令不存在或无法识别，而不是再次显示 Claude Code 版本。新终端无法启动成功标志：
claude，说明当前环境中的程序入口已经移除。命令仍能运行时，通常意味着存在第二份安装，或旧安装留下了 shell alias。回到第一步检查 Homebrew、WinGet、Linux 包管理器和 npm，只卸载被确认存在的那一份；同时检查 shell 配置中的别名。失败处理：
需要彻底清理时再删除配置
-
确认备份文件可以打开，并且不再需要 Claude Code 设置、允许工具、MCP 服务器配置和会话历史。如果 VS Code 扩展、JetBrains 插件或 Claude Desktop 仍保留，先卸载或退出它们。
入口位置：
macOS、Linux、WSL 删除用户目录中的主要动作：
~/.claude与~/.claude.json；进入需要清理的项目后，再按需删除项目内的.claude与.mcp.json。Windows PowerShell 对应删除$env:USERPROFILE.claude、$env:USERPROFILE.claude.json，并在项目目录删除.claude与.mcp.json。用户级配置和选定项目的项目级配置都已按计划移除，文件管理器或终端检查不到这些目标。成功标志：
目录稍后重新出现时，先检查 VS Code 扩展、JetBrains 插件或 Desktop app 是否仍在运行，因为官方页面明确说明这些产品也会写入失败处理：
~/.claude。只想保留历史会话时，停止清理并从备份恢复。
Windows PowerShell 标签把用户级和项目级数据分成两组命令。项目级命令必须在目标项目目录执行，不能在不确定的工作目录里批量删除同名文件。
卸载后逐项确认
- 只执行了与原安装渠道对应的卸载命令，没有把多套命令混着运行。
安装方式匹配：
新终端已验证：
claude --version不再返回版本号。- 命令仍存在时，已经检查第二份安装和 shell alias。
重复安装已排除：
- 需要保留设置或历史时，没有删除
配置选择明确：
.claude与.claude.json。 - 删除配置前已经保存仍需使用的数据。
彻底清理前已备份：
- 需要彻底清理时，VS Code 扩展、JetBrains 插件和 Desktop app 不会再次创建配置目录。
关联产品已处理：
- 项目内的
项目范围正确：
.claude和.mcp.json只在确认过的项目目录中删除。 - 4 张当前官方页面截图均可打开，分别证明两个 Native 分支、npm 卸载与配置清理警告、Windows 配置删除范围。
图片证据完整：