检测到多处安装或显示为未安装 - Codex/OpenCode

Quick fix

升级 CC Switch 至 v3.17.0 及以上版本，修复 Windows 下 npm 路径解析及包装脚本误判问题。

Symptom

报错原文复制

检测到多处安装
命令行实际使用标「默认」的那处；升级可能写到了别处。

Cause

在 Windows 平台上，CC Switch 的工具检测逻辑存在两个缺陷： 1. 版本检测未使用标准 PATH 解析（如 `where` 命令），而是直接扫描进程级 PATH。若用户自定义了 `npm prefix`，GUI 进程无法获取完整的 shell PATH，导致安装在自定义路径下的工具显示为「未安装」。 2. npm 在 Windows 上全局安装时会同时生成 Unix shell 脚本（无扩展名）和 Windows 批处理（`.cmd`）。旧版本将这两个指向同一目标的包装脚本误判为“多处安装”，且因路径比对逻辑缺陷，错误地将无法运行的 Unix 脚本标记为「默认」。

注：本集群中的 #1768 涉及 macOS 下 New API 用量查询默认端点配置错误，属于独立的 UI 模板问题，已另行追踪修复。

Fix

1. 1

   将 CC Switch 升级至 v3.17.0 或更高版本。该版本修复了 Windows 下 npm 全局安装路径的解析逻辑，并过滤了无扩展名的 Unix 包装脚本以消除误判。

Affected Versions

ToolCodex / OpenCode

Version3.16.2 - 3.16.3 (CC Switch 受影响版本)，v3.17.0 已修复

PlatformsWindowsmacOS

Source Issues

本页汇总自 4 个真实 issue

• #1768New API usage query default points to the wrong endpoint
• #4237CC Switch 在探测 Codex 安装时显示异常
• #4263Windows: 自定义 npm prefix 后 codex/opencode 检测不到（PR #2286 未覆盖 Windows）
• #4265Windows: 自定义 npm prefix 后 codex/opencode 检测不到（PR #2286 未覆盖 Windows）

FAQ

为什么 Claude Code 能正常检测，但 Codex 和 OpenCode 显示未安装？

Claude Code 通常通过原生脚本安装在默认目录，而 Codex/OpenCode 多通过 npm 全局安装。若自定义了 npm prefix，旧版 CC Switch 无法正确解析 Windows 的 shell PATH，导致只能检测到默认路径下的工具。

内置的 New API 用量查询默认端点指向错误怎么办？

此为独立问题（#1768），旧版模板错误指向 `/api/user/self`。该问题已纳入 #1857 追踪，升级 CC Switch 至最新版本即可获取正确的 `Base URL + API Key` 用量查询模板。

相关问题

未安装 / not installed or not executable升级 CC Switch 至 v3.20.0+ 以修复自定义 npm prefix 及 macOS 检测失败，Windows 误报多处安装需升级至 v3.16.5+。4 issues mergedenv: node: No such file or directory将 cc-switch 升级至 v3.18.0 或更高版本即可自动修复 GUI 环境下 PATH 缺失导致的环境变量解析失败问题。2 issues merged无法导入供应商，无法进行会话管理 cc-switch升级 cc-switch 以支持 jsonc 配置；WSL2 环境需定时克隆数据库至 Windows 本地路径以绕过 SQLite 锁定。4 issues merged