前言

如果你和我一样，在折腾 Claude Code CLI 时，遇到过这些崩溃的问题：

• where.exe claude 一查，npm、bun、Cherry Studio、VS Code 里全是 claude.exe
• 一会儿用的是 AppData\npm 里的版本，一会儿又自动下载了新的
• 终端里命令报错，IDE 里又跑不起来，根本不知道哪个是哪个

别慌，我踩过的坑帮你整理好了，这篇文章会教你：如何彻底清理所有残留，安装一个永不冲突的纯净版 Claude CLI，并在 VS Code 中正确配置它。

---

一、问题根源：为什么会出现多个 Claude.exe？

在 Windows 上，Claude CLI 很容易出现 “全家桶” 式安装，原因主要有这几个：

1. 包管理器全局安装：用 npm install -g 或 bun install -g 安装，会把文件塞到 AppData\Roaming\npm 或 .bun\bin 里，和原生安装的版本不兼容。
2. IDE / 工具自动安装：VS Code 扩展、Cherry Studio 等工具会偷偷下载自己的 claude.exe，存到插件目录里，和系统里的版本冲突。
3. 官方脚本的隐藏安装：早期的 irm install.ps1 脚本，有时会在多个目录复制文件，或者 PATH 配置不完整，导致命令行和工具调用的不是同一个版本。

---

二、第一步：彻底卸载并清理所有残留

1. 先确认你电脑里有多少个 Claude

打开 管理员权限的 PowerShell，执行下面的命令，把所有藏起来的文件都揪出来：

powershell

# 查看当前终端调用的 Claude 路径
where.exe claude

# 全盘扫描用户目录下所有 Claude 相关文件
Get-ChildItem -Path C:\Users\你的用户名 -Recurse -Filter "claude*" -ErrorAction SilentlyContinue | Select-Object FullName

2. 一键清理所有残留

复制下面这段命令，一次性清理所有版本和配置：

powershell

# 1. 强制停止所有 Claude 进程
taskkill /f /im claude.exe 2>&1 | Out-Null

# 2. 卸载 npm / bun 里的全局版本
npm uninstall -g @anthropic-ai/claude-code --silent 2>&1 | Out-Null
if (Get-Command bun -ErrorAction SilentlyContinue) {
    bun remove -g @anthropic-ai/claude-code --silent 2>&1 | Out-Null
}

# 3. 删除所有常见安装目录的残留文件
Remove-Item "C:\Users\你的用户名\AppData\Roaming\npm\claude*" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\Users\你的用户名\.local\bin\claude*" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\Users\你的用户名\.bun\bin\claude*" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\Users\你的用户名\.cherrystudio\bin\claude*" -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item "C:\Users\你的用户名\.anthropic" -Recurse -Force -ErrorAction SilentlyContinue

# 4. 清理环境变量里的旧路径
$userPath = [Environment]::GetEnvironmentVariable("Path", "User") -split ";" | Where-Object { $_ -notmatch "claude|anthropic" -and $_ }
[Environment]::SetEnvironmentVariable("Path", ($userPath -join ";"), "User")
$env:Path = $userPath -join ";"

3. 验证是否彻底清理干净

重启 PowerShell，执行：

powershell

where.exe claude

如果提示 信息: 用提供的模式无法找到文件，就说明已经完全卸载干净了。

---

三、第二步：安装永不冲突的纯净版 Claude CLI

这次我们只装一个版本，而且永远不重复。

方法 1：官方原生安装（推荐）

在 PowerShell 里执行官方原生安装脚本：

powershell

irm https://claude.ai/install.ps1 | iex

安装完成后，会提示：

plaintext

✔ Claude Code successfully installed!
Version: 2.x.x
Location: C:\Users\你的用户名\.local\bin\claude.exe
⚠ Setup notes: C:\Users\你的用户名\.local\bin is not in your PATH.

这会自动下载并安装 claude.exe 到 C:\Users\你的用户名\.local\bin\ 目录。

如果你需要手动获取二进制文件，安装完成后可以在以下位置找到：

• 可执行文件：C:\Users\你的用户名\bin\claude.exe
• 配置文件：C:\Users\你的用户名\share\claude

安装后，在任何终端运行 claude 即可启动。

方法 2：手动下载安装（更稳，不受网络影响）

如果脚本安装失败，可以手动下载：

1. 浏览器打开 https://downloads.anthropic.com/claude-code/windows/latest/claude.exe 下载文件。
2. 把文件放到 C:\Users\你的用户名\.local\bin 目录（没有就新建文件夹）。

配置环境变量（关键！）

把 Claude 的安装目录加到系统 PATH 里，让所有终端都能调用：

powershell

[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Users\你的用户名\.local\bin", "User")

验证安装

重启 PowerShell，执行：

powershell

claude --version
where.exe claude

✅ 正确结果：

• 输出版本号（如 2.1.143）
• where.exe claude 只显示一条路径：C:\Users\你的用户名\.local\bin\claude.exe

---

四、第三步：在 VS Code 中正确配置（避免再次冲突）

方案 1：最稳方式 - 直接在终端使用（推荐）

不用安装任何扩展，直接在 VS Code 终端里调用你唯一的 Claude：

1. 打开 VS Code，新建终端（Ctrl + `）
2. 执行 claude --version，确认能正常调用
3. 之后直接用命令行和 Claude 交互即可，比如：

   powershell

   claude "帮我优化一下这段代码"
   claude edit --file index.js --prompt "添加错误处理逻辑"
   

方案 2：使用官方扩展，但强制指定路径

如果你想装 Claude Code 扩展，必须做这几步，否则它会自动下载新的 claude.exe：

1. 安装官方 Claude Code 扩展
2. 打开设置（Ctrl + ,），点击右上角的「打开设置 (JSON)」
3. 在 settings.json 中添加以下配置：

   json

   {
     // 强制使用你已安装的 Claude CLI
     "claude-code.path": "C:\\Users\\你的用户名\\.local\\bin\\claude.exe",
     // 禁止扩展自动下载/更新 CLI
     "claude-code.autoUpdateCli": false,
     "claude-code.autoInstallCli": false
   }
   

4. 保存并重启 VS Code

验证 VS Code 调用的版本

在 VS Code 终端里执行：

powershell

where.exe claude

如果只显示 C:\Users\你的用户名\.local\bin\claude.exe，说明配置成功，不会再冲突了。

---

五、避坑总结：以后再也不踩这些坑

1. 永远不用 npm install -g claude，避免文件被塞到 AppData 里。
2. 只保留一个安装目录：C:\Users\你的用户名\.local\bin，所有操作都在这里进行。
3. IDE 里不要让工具自动安装 Claude，手动指定你已有的路径。
4. 定期检查：用 where.exe claude 命令确认，永远只显示一条路径。

---

结尾

折腾了这么久，终于摆脱了 Claude 多版本冲突的噩梦。如果你也遇到过类似的问题，希望这篇文章能帮你少走弯路。

如果你有其他更好的解决方法，也欢迎在评论区交流～