共计 1500 个字符,预计需要花费 4 分钟才能阅读完成。
作为一款 AI 辅助开发工具,Claude Code 通常通过两种方式安装到 macOS 系统中:

- 直接下载.dmg 镜像文件拖拽安装(多数用户选择)
- 通过第三方包管理器如 Homebrew 安装
这两种方式会导致文件分散在多个系统目录,主要包括:
- 应用主程序:
/Applications/Claude Code.app - 用户级支持文件:
~/Library/Application Support/ClaudeCode - 系统级缓存:
/Library/Caches/com.anthropic.claude-code - 偏好设置文件:
~/Library/Preferences/com.anthropic.claude-code.plist - 日志文件:
~/Library/Logs/ClaudeCode
方案一:图形界面标准卸载
对于刚接触终端的新手,推荐先尝试图形化卸载:
- 退出正在运行的 Claude Code(右键 Dock 图标→退出)
- 打开 Finder 进入
/Applications文件夹 - 将 Claude Code.app 拖入废纸篓
- 清空废纸篝(注意:这只会移除主程序)
警告:此方法会遗留 90% 的配置文件!必须配合后续清理步骤。
方案二:终端深度清理方案
打开终端(聚焦搜索 Terminal),逐条执行以下命令:
# 删除主程序(如果图形界面未操作)sudo rm -rf /Applications/Claude\ Code.app
# 清除用户目录下的支持文件
rm -rf ~/Library/Application\ Support/ClaudeCode
# 清理系统缓存目录
sudo rm -rf /Library/Caches/com.anthropic.claude-code
# 移除偏好设置文件
rm ~/Library/Preferences/com.anthropic.claude-code.plist
# 删除日志目录
rm -rf ~/Library/Logs/ClaudeCode
重要安全提示:
rm -rf命令会直接永久删除文件,执行前建议先用ls命令查看目录内容确认路径正确。
验证卸载彻底性
方法 1:Spotlight 搜索
- 按 Command+ 空格打开聚焦搜索
- 输入 ”Claude Code”
- 查看是否还有相关文件显示
方法 2:终端扫描脚本
将以下脚本保存为 check_claude.sh 并执行:
#!/bin/bash
echo "扫描常见残留目录..."
find / -name "*Claude*Code*" 2>/dev/null | grep -v "Permission denied"
echo "扫描完成!上述列表应为空"
避坑指南
- 系统目录识别:
/System和/usr/bin属于系统核心目录,切勿删除-
用户数据主要存储在
/Users/ 你的用户名和/Library下 -
Time Machine 备份:
- 卸载前建议手动创建新备份点
-
恢复时注意选择「恢复到特定日期」避免带回已删文件
-
权限问题处理:
- 遇到「Operation not permitted」错误时,需关闭 SIP 保护(不推荐新手尝试)
建立健康的管理习惯
- 安装追踪:
- 使用
brew list或mas list记录通过包管理器安装的应用 -
手动安装的应用建议记录在 Notes 或专用文档中
-
包管理器优势:
- Homebrew 卸载命令自带清理功能(
brew uninstall --zap) -
自动维护依赖关系,避免遗留垃圾文件
-
定期维护:
- 每月使用
OmniDiskSweeper等工具扫描大文件 - 卸载不常用应用时优先检查其官网的卸载指南
经过上述步骤,你的系统应该已经完全清除了 Claude Code 的所有痕迹。如果后续需要重新安装,建议优先考虑通过 Homebrew 等包管理器安装,这样未来卸载时会更加干净彻底。
正文完
