如何在 Mac 上彻底卸载 Claude
把 Claude 从「应用程序」移到废纸篓,只移除了桌面应用,本地配置、会话记录和单独安装的 Claude Code 还可能留下。这篇按完整卸载来处理,先备份需要的内容,再移除桌面应用、装过的命令行工具和编辑器扩展,最后检查本地数据。
卸载前备份
先确认需要的对话能在 Claude 网页上打开,复制只在本机保存的附件、会话和配置。桌面版的 MCP 配置位于 ~/Library/Application Support/Claude/claude_desktop_config.json,Claude Code 的设置和记录在 ~/.claude 与 ~/.claude.json,删除后不会因重新安装而恢复。
这份指南覆盖 Anthropic 官网下载的 macOS 桌面版、Homebrew cask claude,以及单独安装的 Claude Code,没有安装过的部分直接跳过。
移除桌面应用
退出 Claude,在「活动监视器」中确认它的辅助进程也已退出。官网版检查 /Applications 和 ~/Applications,把其中的 Claude.app 移到废纸篓,通过 Homebrew 安装的版本按下面的命令卸载。
两处安装位置见 Anthropic 的 macOS 部署说明。
用 Homebrew 安装时
先备份要保留的桌面数据,再运行不带 zap 的卸载命令:
brew uninstall --cask claude
这个 cask 的清单包括桌面版的 Application Support、缓存、日志、偏好设置、网页存储和窗口恢复状态,--zap 会一起移到废纸篓,不包含 ~/.claude。不清数据的卸载命令是 brew uninstall --cask claude,之后仍要按下一节处理桌面数据。
自己运行 Homebrew 命令不会读取 Mole 的勾选。Mole 会先检查 zap 清单,涉及未勾选的数据、共享文件或无法确认的内容时不执行 --zap,已勾选的残留仍由 Mole 清理。
清理桌面版数据
退出应用并完成备份后,在 Finder 中按 Shift + Command + G,找到以下文件或文件夹并移到废纸篓,路径不存在就跳过,通过 Homebrew zap 已经移除的不用重复处理。
| 位置 | 里面是什么 |
|---|---|
~/Library/Application Support/Claude |
桌面版设置、MCP 配置、扩展、本地会话和网页存储 |
~/Library/Caches/com.anthropic.claudefordesktop |
桌面版缓存 |
~/Library/Caches/com.anthropic.claudefordesktop.ShipIt |
更新缓存 |
~/Library/HTTPStorages/com.anthropic.claudefordesktop |
网页存储 |
~/Library/Logs/Claude |
日志 |
~/Library/Preferences/com.anthropic.claudefordesktop.plist |
偏好设置 |
~/Library/Saved Application State/com.anthropic.claudefordesktop.savedState |
窗口恢复状态 |
桌面版的最近文档清单还可能留在 ~/Library/Application Support/com.apple.sharedfilelist/com.apple.LSSharedFileList.ApplicationRecentDocuments,打开这个目录,只把名称以 com.anthropic.claudefordesktop.sfl 开头的 Claude 清单文件移到废纸篓,不移除目录或其他应用的清单。
这些路径来自上面的 Homebrew cask 清单,MCP 配置位置也见 Model Context Protocol 文档。只处理具体的 Claude 文件,不移除它们所在的 Library 或 Preferences 等共享目录。
卸载 Claude Code 和编辑器扩展
移除程序前,按 CLI 命令说明运行 claude auth logout 退出已登录的账户,旧版也可以在 Claude Code 会话中输入 /logout,见 官方身份验证说明。登录信息可能保存在 macOS 钥匙串中,删除配置文件不等于退出登录。
结束正在运行的 Claude Code 会话,再按安装方式移除,装过多种版本就分别处理。
| 安装方式 | 卸载方法 |
|---|---|
| Anthropic 原生安装器 | 在 Finder 中打开 ~/.local/bin,移除 claude 启动链接,再打开 ~/.local/share,移除其中的 claude 文件夹 |
| Homebrew | 运行 brew uninstall --cask claude-code,若装的是 latest cask 则运行 brew uninstall --cask claude-code@latest |
| npm 全局安装 | 运行 npm uninstall -g @anthropic-ai/claude-code,使用多个 Node 环境时分别检查各环境的全局安装 |
安装方式和路径见 Claude Code 官方卸载说明。
如果装过 Claude Code 的 VS Code 扩展或 JetBrains 插件,在对应编辑器的扩展或插件管理页面卸载,再退出编辑器。官方说明这些扩展和桌面版也会写入 ~/.claude,没有移除时,下次运行还会生成这个目录。
移除 Claude 的设置和会话记录
所有 Claude 程序和扩展退出后,把已备份的 ~/.claude 文件夹和 ~/.claude.json 文件移到废纸篓,这一步会移除本机设置、工具授权、MCP 配置和会话记录。
Homebrew 的 Claude Code 清单还列出了下面的位置,普通的 brew uninstall --cask claude-code 不会执行 zap,退出所有 Claude 程序后,在 Finder 中逐项核对并移除不再需要的内容。
| 位置 | 里面是什么 |
|---|---|
~/.cache/claude |
Claude 的缓存 |
~/.config/claude |
本机配置,先备份需要的设置 |
~/.local/state/claude |
本机状态,先检查并备份需要的记录 |
~/Library/Caches/claude-cli-nodejs |
命令行客户端缓存 |
主文件夹中还可能有以 .claude.json 开头的配置备份,逐个确认确实属于 Claude 后再处理,不用通配符批量删除。Homebrew 对 ~/.claude 使用的只是删除空目录操作,不能靠 zap 移除里面的会话记录。
如果自行设置过 CLAUDE_CONFIG_DIR,还要核对那个目录里的 Claude 设置和记录,按实际配置备份并处理,不能只检查默认的 ~/.claude。
用过 Claude Code 的项目可能还有 .claude 文件夹和 .mcp.json,逐个项目核对后再处理。项目文件可能由团队共同维护,.mcp.json 也可能供其他 MCP 客户端使用,先保存需要的内容,共用文件只移除不再需要的 Claude 配置,不删除项目代码。
如果只打算卸载桌面版,仍在用 Claude Code 或编辑器扩展,可以停在桌面数据这一步,上面的完整流程适用于本机不再使用 Claude 的情况。
检查结果
在新开的终端中运行以下只读命令:
pgrep -fl '/Claude[.]app/Contents/'
type -a claude
ls -ld /Applications/Claude.app "$HOME/Applications/Claude.app" \
"$HOME/.local/bin/claude" "$HOME/.local/share/claude" \
"$HOME/.claude" "$HOME/.claude.json" \
"$HOME/.cache/claude" "$HOME/.config/claude" \
"$HOME/.local/state/claude" "$HOME/Library/Caches/claude-cli-nodejs" \
"$HOME/Library/Application Support/Claude" \
"$HOME/Library/Caches/com.anthropic.claudefordesktop" \
"$HOME/Library/Caches/com.anthropic.claudefordesktop.ShipIt" \
"$HOME/Library/HTTPStorages/com.anthropic.claudefordesktop" \
"$HOME/Library/Logs/Claude" \
"$HOME/Library/Preferences/com.anthropic.claudefordesktop.plist" \
"$HOME/Library/Saved Application State/com.anthropic.claudefordesktop.savedState"
pgrep没有输出,表示没找到从 Claude.app 内启动的进程,若有输出,先确认并退出对应进程。type -a提示找不到claude,表示这个 shell 已找不到命令入口,若列出路径、别名或函数,检查是否还有另一份安装或旧入口,只处理指向 Claude 的那一项。ls列出的路径仍在磁盘上,逐项复查,No such file or directory表示该路径不存在,Permission denied表示没有读到,不能据此判断已移除。
这些命令覆盖列出的常见位置,编辑器扩展和项目配置还要在各自的管理页面与项目中检查,不把终端没有输出等同于所有位置都检查完了。
付费方案单独取消
卸载不会取消 Pro 或 Max,也不会删除云端账户。通过网页或桌面版订阅的,登录 Claude 网页后进入 Settings › Billing,点击 Cancel,通过 iOS 或 Android 订阅的,在对应的 App Store 或 Google Play 取消,见 Anthropic 的取消说明。
其他 AI 编程工具的缓存和会话清理,可以看怎么清理 Mac 上 AI 编程工具留下的东西。
Mole 会列出什么
Mole 卸载列表覆盖 Claude 桌面应用及其对应残留。关闭「卸载时一并移除数据和配置」时,~/Library/Application Support/Claude 列出供确认但不勾选,开启后合格的自有桌面数据可能预选,要保留就取消勾选,缓存、偏好设置、日志和窗口恢复状态按各自默认规则处理。
~/.claude 和 ~/.claude.json 不在桌面版卸载清单中,单独安装的 Claude Code 和编辑器扩展也不会随 Claude.app 一起卸载,完整移除时还要完成上面的对应步骤。
这次检查覆盖了什么
2026 年 9 月 22 日和 23 日,用 Mole 的开发构建检查了已有 Claude 桌面版的卸载列表,没有执行删除,9 月 23 日列出 31 项,其中 27 项默认勾选,没有列出 ~/.claude。这份记录仅验证桌面版扫描范围,没有验证完整卸载、Claude Code、编辑器扩展、Homebrew cask 或订阅取消。
