Skip to content
CC Switch WikiUnofficial Community Wiki

claude cli exists locally but the about settings say not installed - CC Switch

Quick fix

Upgrade CC Switch to v3.16.5 or newer, fixing the false conflict from multiple npm global package entry points on Windows and the garbled paths.

Symptom

Section titled “Symptom”
Error output
本地有claude cli但是关于设置里显示未安装，点了安装又说有了，安装失败
English translation

claude cli exists locally but the about settings say not installed; clicking install then says it already exists and the install fails

Cause

Section titled “Cause”

Using nvm and similar tools on Windows, npm generates several identically named entry files for one global package (an extension-less Unix shell script and a `.cmd` batch file, for example). Older CC Switch mistook those for separate installations and reported a conflict in the local environment check. The feature was also disabled entirely in v3.11.1 because of a side effect in the protocol handler, and the conflict diagnostic screen in v3.16.2 had a front-end rendering bug that garbled the displayed file paths (showing `gemini` as `gemmini`).

Fix

Section titled “Fix”

  1. Upgrade CC Switch to v3.16.5 or newer. That version fixed merging `.cmd`/`.exe` with the extension-less shim on Windows and anchors version detection to the genuinely runnable entry point, so it no longer reports a false multiple-installation conflict.

Affected Versions

Section titled “Affected Versions”
ToolCC Switch
Version3.11.1 - 3.16.3 (affected), fixed in 3.16.5
PlatformsWindows

Source Issues

Section titled “Source Issues”

This page is distilled from 3 real issues

FAQ

Section titled “FAQ”
It reports a multiple-installation conflict when I use nvm. What now?
npm generates several entry files on Windows (a `.cmd` and an extension-less script), and older CC Switch reports a false conflict. Upgrade to v3.16.5 for the fix.
Why does Windows show no CLI tool version information at all?
In v3.11.1, the environment check was temporarily disabled because of a protocol handler side effect. Upgrade to the latest version to re-enable it.
The environment check screen shows misspelled file paths (opeencode). What is that?
A front-end text rendering bug in v3.16.2 — the actual filesystem paths are correct. Upgrade to v3.16.5 or newer to resolve it.
Section titled “Related problems”
skills installed to the wrong path - cc-switchOlder cc-switch installs skills into ~/.claude/skills/skills, which Claude Code ignores. Upgrade, or move the contents up to ~/.claude/skills/.4 issues mergedInstalled but cannot run in current environment, please check CC SwitchUpgrade to CC Switch v3.16.1+ to fix Windows `cmd /C` quote handling that misreports installed CLI as broken.1 issues merged"event handler is re-entrant" error or startup crashUninstall Windows update KB5081263 or wait for cc-switch upgrade to avoid crashes and UI rendering failures caused by TAO EventLoop re-entry.2 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.