macOS 彻底卸载 Claude Code 的完整指南：从原理到实践

2次阅读

共计 2309 个字符，预计需要花费 6 分钟才能阅读完成。

很多 macOS 用户习惯通过简单的拖拽到废纸篓来卸载应用，但这种方式对于 Claude Code 这样的开发工具往往不够彻底。Claude Code 在运行过程中会在系统多个位置创建配置文件、缓存数据和扩展组件，这些残留文件可能导致以下问题：

占用磁盘空间（有时可达数百 MB）
与新版本产生配置冲突
遗留的扩展可能影响其他开发工具运行
敏感数据（如项目历史记录）未清除

Claude Code 作为现代开发工具，采用典型的 macOS 应用分发模式，但比普通应用更复杂：

应用本体 ：通常安装在 /Applications 目录下
用户级配置 ：存储在 ~/Library 下的多个子目录
系统级组件 ：部分组件会安装到 /Library 目录
扩展生态 ：通过扩展市场安装的组件分散在多处
运行时数据 ：包括缓存、日志、临时文件等

退出 Claude Code 应用（确保没有相关进程在运行）
将 /Applications 中的 Claude Code.app 拖到废纸篓

用户目录下的残留（~ 代表你的用户目录）：

~/Library/Application Support/Code
~/Library/Caches/com.microsoft.VSCode
~/Library/Preferences/com.microsoft.VSCode.plist
~/Library/Saved Application State/com.microsoft.VSCode.savedState
~/.vscode（可能存在的全局配置）

系统级残留（需要管理员密码）：

/Library/Preferences/com.microsoft.VSCode.plist
/Library/Logs/ClaudeCode
/Library/Application Support/ClaudeCode

命令行工具（如果安装过）：

/usr/local/bin/code
/usr/local/bin/claude

对于需要频繁卸载 / 重装或管理多台设备的用户，可以保存以下脚本为 uninstall_claude_code.sh：

#!/bin/bash

# Claude Code 卸载脚本
# 需要管理员权限执行

set -e # 遇到错误立即退出

# 检查是否以 root 运行
if ["$(id -u)" -ne 0 ]; then
    echo "请使用 sudo 运行此脚本"
    exit 1
fi

# 定义要删除的路径数组
declare -a paths=(
    "/Applications/Claude Code.app"
    "$HOME/Library/Application Support/Code"
    "$HOME/Library/Caches/com.microsoft.VSCode"
    "$HOME/Library/Preferences/com.microsoft.VSCode.plist"
    "$HOME/Library/Saved Application State/com.microsoft.VSCode.savedState"
    "$HOME/.vscode"
    "/Library/Preferences/com.microsoft.VSCode.plist"
    "/Library/Logs/ClaudeCode"
    "/Library/Application Support/ClaudeCode"
    "/usr/local/bin/code"
    "/usr/local/bin/claude"
)

# 遍历删除
for path in "${paths[@]}"; do
    if [-e "$path"] || [-L "$path"]; then
        echo "正在删除: $path"
        rm -rf "$path"
    else
        echo "不存在跳过: $path"
    fi
done

# 清理用户配置
echo "是否要删除所有项目历史记录？（y/n）"
read -r answer
if ["$answer" = "y"]; then
    rm -rf "$HOME/.claude/projects"
fi

echo "卸载完成！建议重启电脑"

使用说明：