最近不少人跑来问我同一个问题Claude Code 到底怎么删干净。这倒让我有点意外因为按常理说装工具的人多卸工具的人少但实际一聊才发现很多人不是想彻底弃用而是遇到了安装方式混乱、版本冲突、残留配置导致重装报错这类破事才不得不先把旧环境彻底清掉。再加上 Claude Code 有一堆安装入口——npm、官方安装脚本、VS Code 插件、桌面版客户端每个入口装出来的环境还不完全一样删起来自然就头疼了。这篇东西我就按实际排查的思路来写先说怎么判断你的 Claude Code 是哪种安装方式再按方式拆解卸载步骤最后重点讲配置残留清理和常见问题排查。我尽量把命令、路径、验证方法都写清楚保证你看完能把自己的环境收拾利索也顺手解决那些“明明删了为什么 claude 命令还能用”之类的怪问题。1. 删除前先搞清楚你的 Claude Code 是哪种安装方式很多人卸载不干净根子不在卸载命令不对而是根本不知道自己当初是用哪种方式装进去的。Claude Code 的官方安装渠道有好几个不同渠道的卸载入口完全不同就像你装了个桌面软件却想着用包管理器去卸那当然卸不干净。1.1 常见安装方式有哪些目前大家电脑上见到的 Claude Code 基本来自四个入口npm 全局安装通过npm install -g anthropic-ai/claude-code装到 Node.js 全局目录里命令是claude。这是最老牌也最主流的安装方式如果你用过终端启动 Claude Code多半是这个。官方原生安装脚本用安装器脚本直接拉二进制文件通常装到用户目录下的~/.local/bin或~/.local/share附近不经过 Node.js。这种方式近一年越来越常见因为它不依赖 Node 版本启动更快。VS Code 插件在扩展市场里搜“Claude Code for VS Code”装的那种主要作为编辑器集成使用但插件内部可能还会联动下载 CLI 核心。桌面版客户端Desktop带图形界面的独立应用macOS 上是.appWindows 上是.exe安装包热词里那个“claude code desktop 1.7179.0”指的就是这类。此外还有一批第三方工具链比如cc-switch这种用来切换模型供应商配置的小工具也会在本地写配置目录。严格说它不算 Claude Code 本体但很多时候你卸载后感觉“没删干净”其实是这类辅助工具留下的配置在捣乱。1.2 用三条命令快速定位安装来源先别急着删打开终端依次跑三条命令基本就能判断你的环境到底是什么情况。# 查看 claude 命令的真实路径 which claude # 查看 npm 全局包列表里有没有 claude-code npm ls -g --depth0 # 查看 claude 的版本信息如果还能执行的话 claude --version输出结果怎么解读我给你列个速查表which claude 输出路径特征可能的安装方式卸载入口/usr/local/bin/claude或/opt/homebrew/bin/claudenpm 全局安装Homebrew Node 环境卸载 npm 包~/.npm-global/bin/claude或~/.nvm/.../bin/claudenpm 全局安装自定义/多版本 Node卸载对应 Node 环境的 npm 包~/.local/bin/claude官方原生安装脚本删除本地文件~/.claude/local/bin/claude或出现在应用目录里桌面版内置 CLI卸载桌面应用命令在 VS Code 终端里能用、系统终端里不能用VS Code 插件环境自带卸载 VS Code 扩展提示如果which claude输出了一长串路径但claude --version报错说明命令文件已经损坏或是个空壳这种情况往往是上次卸载只删了一半后面第 4 节我会专门讲这个。2. 主程序卸载按安装方式逐一拆除定位清楚来源之后就可以对症下药了。这一节我只讲“把程序本体卸掉”配置和数据清理放到下一节单独讲因为那才是重灾区。2.1 npm 安装方式怎么卸载如果你确认是 npm 全局安装卸载命令非常直接。官方 npm 包名是anthropic-ai/claude-code很多人记成claude-code或anthropic-claude-code包名写错卸载时会提示 not found所以务必用下面的完整包名。npm uninstall -g anthropic-ai/claude-code如果你的 Node 环境不是 npm 而是 pnpm 或 yarn命令换成# pnpm 用户 pnpm remove -g anthropic-ai/claude-code # yarn 用户 yarn global remove anthropic-ai/claude-code卸完之后别急着走再确认一下which claude。如果你当初是用 nvm 这类多版本 Node 工具装的而当前 shell 激活的 Node 版本跟安装时不一样npm 卸载可能只卸掉了其中一个版本的链接换个 Node 版本后 claude 命令可能又“复活”了。这时候需要到你实际安装的那个 Node 版本环境里去执行卸载或者干脆手动删掉全局 bin 目录里的 claude 软链接。# 查看全局 bin 目录里是否还有残留的 claude 相关文件 ls -la $(npm prefix -g)/bin | grep claude2.2 官方原生安装脚本怎么处理原生安装脚本装出来的东西不会出现在 npm 列表里npm 卸载命令对它无效。它的文件散落在用户目录下几处你需要手动找到并删除。先看主程序二进制在哪# 定位 claude 可执行文件 which claude # 查看它指向的真实文件如果是软链接就继续追 readlink -f $(which claude)找到真实文件位置后删除对应的可执行文件和它所在的目录。常见路径是~/.local/bin/claudeLinux/macOS有些版本会连带安装配套文件到~/.local/share/claude-code或~/.local/lib/claude-code这类位置。# 按实际找到的路径替换下面这组是我本地实测存在的目录 rm -f ~/.local/bin/claude rm -rf ~/.local/share/claude-code rm -rf ~/.local/lib/claude-code需要提醒一句原生安装脚本版本升级比较勤不同小版本的文件布局有差异。你删的时候不用死记路径直接看~/.local下面跟 claude 相关的目录有哪些通通处理掉就行。但注意不要误删别的工具的目录动手之前ls看一眼内容确认是 Claude Code 相关再删。2.3 macOS 与 Windows 桌面版彻底移除桌面版卸载跟普通桌面软件一样但很多人只拖废纸篓 / 用系统卸载器装完后发现claude命令还能用那是因为桌面版自带的 CLI 组件没有跟着一起清掉。macOS 上的处理分两步。第一步是常规卸载把Claude Code.app或Claude Desktop.app从“应用程序”目录移到废纸篓并清空第二步是清理配套 CLI 文件。桌面版自带的命令行工具常出现在这些位置# 清理桌面版内置 CLI rm -rf ~/Library/Application\ Support/ClaudeCode rm -rf ~/Library/Application\ Support/Claude rm -f /usr/local/bin/claude # 如果这里存在 claude 链接Windows 上先到“设置 → 应用 → 安装的应用”里找到 Claude Code 或 Claude Desktop点卸载。然后再到用户目录下检查%APPDATA%\Claude、%APPDATA%\ClaudeCode、%LOCALAPPDATA%\Programs\claude-code-desktop这类目录有的话一并删除。Windows 上有些版本会把 CLI 工具放到%USERPROFILE%\.local\bin\claude.exe也需要注意。注意macOS 上如果某些文件提示“只读”或者“不允许操作”进到“系统设置 → 隐私与安全性 → 完全磁盘访问权限”里把终端加进去再删这是不少人卡住的地方。2.4 VS Code 插件怎么移除VS Code 插件是独立的安装入口即使你把 CLI 和桌面版卸干净了插件还留在编辑器里。打开 VS Code 左侧扩展面板搜索“claude”或“Claude Code”找到对应扩展后点击齿轮图标 →“卸载”。如果装了多个同名扩展分不清就点进扩展详情页看发布者官方插件的发布者是 Anthropic。卸载完建议重启一次 VS Code因为插件运行时可能会有缓存进程驻留不重启的话某些文件锁着删不掉。有些扩展会顺手在项目目录里生成.vscode/settings.json文件片段或写入工作区信任配置这些不在扩展卸载范围内。如果你在某个项目里配过 Claude Code删完插件后可以顺手看一眼项目里的.vscode目录把明显跟 claude 相关的配置行清掉。3. 配置与数据彻底清理不删干净等于没删程序本体卸掉只是第一步真正让后面重装踩坑的永远是配置残留。Claude Code 会把配置、会话历史、认证信息、项目缓存散落在用户目录的好几个地方这些文件不删就算命令已经找不到了下次重装的时候旧配置会自动被加载轻则行为怪异重则直接启动报错。3.1 必须手动清理的配置文件清单不同安装方式、不同操作系统配置文件的路由不太一样但核心目录就那几处。我按平台给你列个清单平台路径里面装了什么macOS / Linux~/.claude主配置目录settings.json、projects、todos、会话记录macOS / Linux~/.claude.json全局状态文件记录登录账号、激活过的项目目录等macOS / Linux~/.config/claude-code部分版本的自定义配置目录macOS / Linux~/.cache/claude-code缓存文件macOS~/Library/Application Support/ClaudeCode桌面版的数据目录Windows%USERPROFILE%\.claude主配置目录Windows%APPDATA%\Claude或%APPDATA%\ClaudeCode桌面版数据目录Windows%LOCALAPPDATA%\claude-code或~/.cache/claude-code缓存目录清理方式也不难终端里跑下面这组命令macOS / Linuxrm -rf ~/.claude rm -f ~/.claude.json rm -rf ~/.config/claude-code rm -rf ~/.cache/claude-codeWindows 用户在 PowerShell 里跑Remove-Item -Recurse -Force $env:USERPROFILE\.claude Remove-Item -Recurse -Force $env:USERPROFILE\.claude.json Remove-Item -Recurse -Force $env:APPDATA\Claude Remove-Item -Recurse -Force $env:APPDATA\ClaudeCode Remove-Item -Recurse -Force $env:LOCALAPPDATA\claude-code提示如果你想删完以后重装而且之前配过一些比较复杂的自定义设置建议删除前先备份~/.claude/settings.json和~/.claude.json这两个文件到桌面或别的地方。很多配置其实是参考价值大于使用价值的备份一份有备无患。3.2 为什么这些配置残留会影响重新安装这里得讲一下机制。Claude Code 这类的 CLI 工具启动时会先去读配置文件如果检测到配置文件里某些字段跟当前版本不兼容可能直接报一堆看不懂的错误最常见的就是“failed to load configuration”或者“invalid settings format”。还有一种情况更隐蔽你卸载后重新装了新版但旧配置里记录了老版本的某些开关项新版本已经移除或改名了结果就是命令能跑但功能不对你甚至都想不到是配置缓存的问题只会觉得“这新版是不是有 bug”。另外认证信息也在这里面。~/.claude.json这类全局文件可能记录着登录凭据或 API key 相关的信息。你如果只是卸载程序而没删这些文件等于把钥匙留在门上——虽然大概率无害但从清理彻底性的角度还是建议一起清掉。3.3 项目目录里的隐藏残留除了全局配置Claude Code 在跑过的项目目录里也可能留东西。最常见的痕迹是项目根目录下面的.claude文件夹里面可能有settings.json项目级配置、todos任务列表、commands自定义命令等。终端里在项目目录跑一句就能看到ls -la .claude确认存在并且内容是你不需要的删除即可rm -rf .claude如果你清理的是一台电脑上的所有痕迹最笨也最稳的办法是用终端全局搜索一下 claude 相关目录macOS / Linuxfind ~ -maxdepth 4 -iname *claude* 2/dev/nullWindows 上类似在C:\Users\你的用户名下面搜.claude或ClaudeCode关键字。注意搜索结果里~/Library/Caches这种缓存目录会很显眼别漏掉。4. 残留命令、PATH 与 shell 环境清理上一节讲的是配置残留这一节讲的是另一个老大难卸载后claude命令在终端里居然还能用。很多人在这一步直接懵了“我明明把程序删了怎么还能跑”原因无非两类一类是命令文件压根没删掉另一类是 shell 环境里的别名或 PATH 链接还在。4.1 卸载后 claude 命令依然存在的排查先复现一下问题跑which claude看它输出什么路径。如果还能输出路径说明确实有一个可执行文件还躺在系统里。分情况处理找不到删不掉的文件按 2.2 节的方法用readlink -f追一下真实路径删除真实文件。命令指向 npm 目录但 npm uninstall 说包不存在用ls -la看看那个目录里到底有什么如果是 claude 的软链接或可执行副本直接rm删掉。在 VS Code 里能用系统终端不能用这通常是 VS Code 插件自带或配置了内置运行时按 2.4 节卸载插件即可。macOS 上 zsh / bash 的 hash 缓存shell 会缓存命令路径即使文件删了当前终端窗口里再跑claude也可能会短暂地“找到”它。这种情况不用慌关掉终端重开或者跑一下hash -r刷新缓存就行了。如果which claude已经没输出但敲claude还是能出一个交互界面那大概率是触发了 shell 里的 alias 或者某个函数。检查一下type claude这个命令会告诉你claude到底是外部命令、alias、函数还是内建命令。如果结果是claude is an alias之类去~/.bashrc、~/.zshrc、~/.profile里搜claude关键字把那一行 alias 注释或删掉。4.2 环境变量和 shell 配置里的痕迹原生安装脚本在安装时会往 shell 配置里写 PATH 或环境变量卸载时脚本可不会自动帮你去掉。最常见的写入位置~/.zshrcmacOS 默认~/.bashrc/~/.bash_profileLinux~/.profile通用在这些文件里搜索claude或claude-codegrep -n claude ~/.zshrc ~/.bashrc ~/.profile 2/dev/null看到类似这样的行直接注释或删除export PATH$HOME/.local/bin:$PATH export CLAUDE_CODE_...注意export PATH$HOME/.local/bin:$PATH这一行可能是安装别的工具时加的不一定只服务于 Claude Code。如果你用的是~/.local/bin一般情况下别的工具也可能共用这个目录。删之前确认一下~/.local/bin里还有没有别的可执行文件别把其他工具的路径也顺手抹了。改完 shell 配置后要么重启终端要么执行source ~/.zshrc取决于你改的是哪个文件让配置生效然后再验证which claude # 应该没有输出 claude --version # 应该提示 command not found如果这两条都通过了主程序层面的卸载就算彻底完成了。5. 常见问题与排查技巧实录删除 Claude Code 这件事看着简单实际动手时十个人有八个会遇到各种幺蛾子。我把实操里碰到的典型问题和排查思路整理成一张速查表然后挑几个重要的详细展开。现象主要原因解决方案npm uninstall 提示包不存在但 claude 命令能用安装方式不是 npm按 2.2 节找原生安装路径删除卸载后 claude 命令还在文件残留或 shell hash 缓存readlink -f追踪后删除hash -r配置目录删除时提示权限不足macOS 隐私保护 / Windows 权限给终端完全磁盘访问权限Windows 用管理员终端重装后启动报错类似 syntax / parse error旧配置残留与新版不兼容彻底清空 ~/.claude 和 ~/.claude.json 后重装项目目录里还能看到 claude 相关操作记录项目级 .claude 目录残留手动删除各项目根目录的 .claude 文件夹删了桌面版但 CLI 还是能跑桌面版带内嵌 CLI 没清按 2.3 节清理配套命令行文件VS Code 卸载插件后仍然有 claude 相关弹窗扩展配置缓存未重启重启 VS Code检查工作区 .vscode 配置5.1 权限不足删不掉怎么办macOS 上这个坑遇到的概率很高尤其是删~/Library/Application Support/Claude或~/.claude里的某些文件系统会提示“不允许操作”或“只读”。这不是文件被锁而是 macOS 的隐私保护机制拦住了终端。解决办法打开“系统设置 → 隐私与安全性 → 完全磁盘访问权限”在列表里把“终端”勾上然后完全退出终端再重新打开再执行删除命令。如果你用的是 iTerm2就勾 iTerm2原理一样。Windows 上如果删除时提示需要管理员权限右键开始菜单选择“终端(管理员)”或“PowerShell(管理员)”再执行删除命令。如果提示文件被占用先打开任务管理器看有没有 node、claude 相关进程在跑结束掉再删。5.2 清理后重装出现奇怪报错怎么办很多人的流程是“卸载 → 装新版”结果新版启动就报错。第一反应是新版本 bug其实大概率是旧的配置文件里带了新版本不认的字段。处理方式很简单把配置目录全部清掉再重装。如果你怕配置丢先备份~/.claude和~/.claude.json到别的地方然后清空原目录重装完启动验证没问题之后再按需把旧配置里手动改过的 settings 一行行挪回去千万不要整个文件直接覆盖回去否则等于白卸。还有一种情况是卸载时权限没给够导致某些二进制的 install 标记或权限位坏了重装脚本检测到“已安装”就直接跳过结果装了个残缺版本。遇到这种除了清配置还要把~/.local/bin/claude这类真实二进制也确认删掉了再重装。5.3 第三方工具残留怎么处理热词里提到的cc-switch、workbuddy这类工具并不是 Claude Code 本体但它们在本地有独立的配置目录。如果你用它们切换过模型供应商或配置并且卸载 Claude Code 后想彻底回归干净状态可以顺带检查一下ls -la ~ | grep -i cc ls -la ~/.config | grep -iE cc|claude常见的目录名有~/.cc-switch、~/.workbuddy等。这类配置只影响对应工具的运行不影响 Claude Code 本体但如果你的目的是“从零开始重新配”删掉它们能避免旧配置误导你。同样建议删除前确认目录内容别把不相干的东西删错。5.4 卸载后如何验证“真的干净了”最后分享一套我自己用的验证流程三步走# 第一步命令已不存在 which claude # 第二步包管理器里已无记录如果你走的是 npm 安装 npm ls -g --depth0 | grep claude # 第三步配置目录已清空 ls -la ~/.claude 21 ls -la ~/.claude.json 21前两条无输出第三条提示No such file or directory基本可以判定环境已经清理干净。之后你想重装还是换用别的工具都不会被旧环境拖后腿。说到底“删除 Claude Code”这件事本身不难难的是判断它到底在系统里铺了多少东西。按照我先判断安装方式、再拆主程序、再清配置、最后查残留的顺序一步步来基本不会漏。我个人的习惯是卸载前把~/.claude/settings.json备份一份因为里面有些自定义 prompt 和模型配置以后重新配置的时候照着写比从头想省事得多。至于那些实在用不上的缓存、日志、会话历史就别心疼了清干净了系统也清爽。希望这份清单能帮你少走点弯路。