本地有claude cli但是关于设置里显示未安装 - CC Switch

Quick fix

升级 CC Switch 至 v3.16.5 或更高版本，以修复 Windows 下 npm 全局包多入口导致的误报冲突及路径乱码问题。

Symptom

报错原文复制

本地有claude cli但是关于设置里显示未安装，点了安装又说有了，安装失败

Cause

在 Windows 系统下使用 nvm 等工具时，npm 会为同一个全局包生成多个同名入口文件（例如无扩展名的 Unix shell 脚本和 `.cmd` 批处理文件）。CC Switch 的旧版本会将这些文件误判为多处独立安装，从而在本地环境检查中提示冲突。此外，该功能在 v3.11.1 中曾因协议处理程序的副作用被完全禁用，且在 v3.16.2 的冲突诊断界面中存在前端渲染 bug，导致显示的文件路径出现乱码（如将 `gemini` 显示为 `gemmini`）。

Fix

1. 1

   将 CC Switch 升级到 v3.16.5 或更高版本。该版本已修复 Windows 下 `.cmd`/`.exe` 与无扩展名 shim 的合并逻辑，将版本探测锚定到真正可运行的入口，不再误报多处安装冲突。

Affected Versions

ToolCC Switch

Version3.11.1 - 3.16.3 (affected), fixed in 3.16.5

PlatformsWindows

Source Issues

本页汇总自 3 个真实 issue

• #1266[Bug] v3.11.1 completely disables env check on Windows, breaking CLI version detection
• #4122[Bug] Local environment check UI displays garbled/nonsensical file paths on Windows (e.g. 'opeencode' instead of 'opencode', 'opencode.crmd' instead of 'opencode.cmd')
• #4666本地有claude cli但是关于设置里显示未安装，点了安装又说有了，安装失败

FAQ

使用 nvm 时提示多处安装冲突怎么办？

这是由于 npm 在 Windows 上生成了多个入口文件（如 `.cmd` 和无扩展名脚本），旧版 CC Switch 会误报冲突。请升级至 v3.16.5 修复此问题。

为什么 Windows 上完全不显示 CLI 工具的版本信息？

在 v3.11.1 中，由于协议处理程序的副作用，环境检查功能被临时禁用。请升级到最新版本以重新启用该功能。

环境检查界面显示的文件路径有拼写错误（如 opeencode）是怎么回事？

这是 v3.16.2 中的前端文本渲染 bug，实际文件系统路径是正确的。请升级到 v3.16.5 及以上版本解决。

相关问题

skills 安装路径不对 cc-switch旧版 cc-switch 会把 skills 装到 ~/.claude/skills/skills，Claude Code 不识别；升级到修复版本，或临时把内容上移到 ~/.claude/skills/。4 issues merged已安装，但无法在当前环境中运行，请检查 CC Switch升级到 CC Switch v3.16.1 或更新版本，修复 Windows 上 cmd /C 引号处理导致本地环境检查把已安装 CLI 误报为“无法运行”的问题。1 issues merged“event handler is re-entrant” 报错或启动闪退卸载 Windows 更新 KB5081263 或等待 cc-switch 升级以规避 TAO EventLoop 重入导致的崩溃与界面不渲染问题。2 issues merged