本地环境检查 提示codex未安装 - cc-switch
Quick fix
先在终端运行 codex --version 确认命令可执行；若终端正常但 cc-switch 检测不到，通常是安装路径未纳入探测范围，升级到 v3.16.4+ 或提供路径等待修复。
Symptom
Section titled “Symptom”本地环境检查 提示codex未安装cc-switch 的本地环境检查主要依靠常见安装路径和 PATH 来探测 Claude Code/Codex，但通过微软商店、miniconda/base 环境、npm 全局或多入口安装的 CLI 不一定在探测范围内，于是出现“本地环境检查 提示codex未安装”。#3547 的维护者回复表明后续版本对工具版本探测与关于面板做了改动，包括 Windows 探测相关修复；#3434 中用户还遇到版本号被识别成系统版本、乱码等变体。#4034/#4303 则反映 npm 安装会产生 codex/codex.cmd/codex.ps1 等多个入口，容易被误判为重复安装冲突；#4345 与 #4758 是同一微软商店路径问题的重复报告，#2737 是 miniconda base 环境未被加载导致未找到 Codex。
在终端运行 `codex --version`（或 `claude --version`），确认命令确实存在且可执行。
如果终端能运行但 cc-switch 仍提示未安装，先升级到 v3.16.4 或更新版本；#3547 中维护者表示后续版本改进了工具版本探测。
如果 npm 安装的 Codex 被诊断为多个安装，检查 `codex`、`codex.cmd`、`codex.ps1` 是否指向同一套 npm 安装；确认后可不处理，等待修复。
仍无法识别时，记录安装方式（微软商店/npm/conda/Homebrew）与实际路径，并到 #4758 或新 issue 反馈。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 8 个真实 issue
- #2737cc-switch无法识别miniconda base环境中安装的codex
- #3434无法正确检测Claude code codex版本状态
- #3547本地环境检查无法检测已安装的环境
- #4034Multiple installations were incorrectly detected, resulting in a conflict report
- #4040找不到CODEX
- #4303Codex 在 Windows 下会显示多个 codex/codex.cmd/codex.ps1 入口，容易被误判为重复安装，但实际它们都指向同一套 npm 安装。
- #4345About menu, codex is installed through the Microsoft Store, but CC Switch did not detect the local installation information
- #4758本地环境检查时无法正确的识别到 Codex
- 为什么在 mac 上当前版本会直接检测成系统版本？
- #3434 报告过该问题，是因为版本探测逻辑存在误判；后续版本已重构工具版本探测与关于面板，可升级后重试。
- 我是用微软商店装的 Codex，为什么 cc-switch 提示 codex未安装？
- 微软商店安装路径与 Homebrew/npm 不同，旧版本可能未覆盖该路径；该问题由 #4758 主线跟踪，#4345 为其重复报告。
- npm 安装的 Codex 为什么诊断会提示多个安装或冲突？
- npm 会在 PATH 中创建 codex、codex.cmd、codex.ps1 等入口，旧版 cc-switch 将其误认为多套安装；#4303/#4034 已跟踪。
- conda base 环境安装的 Codex 检测不到怎么办？
- #2737 报告这可能与 cc-switch 未加载 miniconda base 环境有关，暂时可确认终端直接运行 `codex --version` 是否成功，并在 issue 中反馈。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。