not installed or not executable - CC Switch 检测失败

Quick fix

升级 CC Switch 到 v3.16.2+，或在设置中手动指定 CLI 安装目录，并清理 shell 启动输出噪音。

Symptom

报错原文复制

本地存在 ClaudeCode 和 Codex 环境，但在 CCS 中提示：not installed or not executable

Cause

CC Switch 旧版本的 CLI 工具探测逻辑覆盖不足，无法识别通过 fnm、nvm、Homebrew、servbay、第三方 Node 版本管理器或 Windows 特殊路径安装的 Claude Code、Codex、Gemini CLI 等工具，导致界面显示未安装或不可执行。Windows 中文系统下还可能出现路径编码乱码，使检测结果进一步失真。 另一类变体是 shell 启动阶段输出了类似版本号的噪音，例如 ~/.zshrc 打印 PATH、终端 shell integration 的 OSC 转义序列、Node 版本管理器提示或 neofetch 输出。旧解析器会把噪音中的数字误认为工具版本号，导致所有工具显示同一个错误版本或检测异常。

Fix

1. 1

   将 CC Switch 升级到 v3.16.2 或更新版本。维护者确认 v3.16.0 / v3.16.1 已重写 CLI tool detection，可探测 PATH、Homebrew、npm/pnpm/bun/volta/fnm/nvm、scoop、WinGet、Windows native paths 和 WSL 等来源。

2. 2

   如果升级后仍无法识别，在 CC Switch 设置中手动指定 codex、gemini 等 CLI 的安装目录。

3. 3

   如果检测结果显示了明显错误的版本号，检查 ~/.zshrc、~/.bashrc、~/.zprofile 或终端 shell integration 是否在启动时输出包含版本号的内容。暂时注释相关输出后重新检测。

   ~/.zshrc

   # 注释会在 zsh 启动阶段打印版本号或 PATH 的语句，例如：
   # add_to_path "$JAVA_HOME/bin"

4. 4

   Windows 用户如遇权限问题，可尝试右键以管理员身份运行 CC Switch。

Affected Versions

Toolcc-switch

Version<= 3.16.1

PlatformsWindowsmacOSLinux

Source Issues

本页汇总自 4 个真实 issue

• #552[BUG]V3.9.0版本中，通过fnm 安装的node,无法显示gemini和codex
• #775本地环境检查无法获取到安装情况
• #2824本地环境claude、Codex、Gemini、OpenCode检查错误
• #3454Windows 中文系统下环境检测失败，路径后出现编码乱码

FAQ

为什么本地明明安装了 Claude Code / Codex / Gemini CLI，CC Switch 仍显示未安装？

旧版检测逻辑可能没有覆盖你的安装来源，例如 fnm、nvm、Homebrew、servbay 或 Windows 特殊路径。升级到 v3.16.2+ 或在设置中手动指定安装目录。

使用 fnm 安装 Node 后看不到 gemini 和 codex，怎么办？

早期版本不支持 fnm 路径。可先在设置中手动指定安装目录，后续版本已增强对 fnm 等 Node 版本管理器的探测。

Windows 中文系统下路径出现乱码导致检测失败，是什么原因？

这是 Windows 中文编码导致的检测异常，维护者表示已在 v3.16.0 / v3.16.1 相关变更中修复或实现，建议升级到 v3.16.1+。

检测结果里的版本号为什么像 Java、macOS 或 IP 地址？

shell 启动输出或终端 OSC 转义序列中的数字被旧版本误解析为版本号。清理启动输出噪音，或升级到包含解析器加固的版本。

之前版本正常，后来突然读不到环境，是 CC Switch 改了什么吗？

有用户反馈 Windows 平台曾修复连续弹出终端的问题，可能影响了检测方式。后续 v3.16.0+ 已重写 CLI 工具探测逻辑。

相关问题

Claude code 不支持 geminicc-switch 目前不支持将 Gemini 作为 Claude Code 的 provider；需要等待本地代理功能或使用第三方代理项目。3 issues mergedGemini 出现 default 配置且无法删除default 是 CC Switch 导入现有 live 配置生成的预期供应商；需先在设置中切换当前供应商，再删除不需要的配置。4 issues mergedHTTP 401 Unauthorized - CC Switch Anthropic升级 cc-switch 至修复版，以支持 Anthropic 所需的 x-api-key 和 anthropic-version 请求头。2 issues merged