本地环境检查不通过：Claude Code / Codex / OpenCode

Quick fix

Windows 上可升级至 CC Switch v3.16.1 或更新版本；Ubuntu 报告仅关联了修复 PR，原帖未提供验证结果。

Symptom

报错原文复制

已经安装了相关的工具，但是在本地环境检查中不通过

Cause

这些报告均涉及已安装的 CLI 被本地环境检测漏报或误判。Ubuntu 24.04LTS 的报告指出，默认以 `sh -l` 启动的 shell 会话不会加载用户环境变量，因此 `codex` 和 `opencode` 无法被探测；该报告还指出由 `fnm` 管理、通过动态目录挂载的 Node 路径会使后备检测逻辑不完善。该 issue 关联了修复 PR，但原帖没有提供修复后的验证结果。

Windows 11 上的 Claude Code 2.1.159 报告则表现为检测界面显示“已安装但无法使用”，但用户称实际可以正常使用。维护者说明该问题已在 CC Switch `v3.16.0` / `v3.16.1` 中修复或实现，并建议升级后若仍可稳定复现再补充信息。

Fix

1. 1

   如果遇到 Windows 上 Claude Code 被误判为无法使用，升级至 CC Switch `v3.16.1` 或更新版本后重新检查。

2. 2

   如果在 Ubuntu 24.04LTS 中已安装工具但检测不通过，核对当前 shell 会话是否加载了用户环境变量，并参阅关联修复 PR；原帖尚未提供可验证的解法或修复验证结果。

Affected Versions

ToolClaude Code / Codex / OpenCode

VersionCC Switch v3.16.0 / v3.16.1（维护者称已修复或实现）

PlatformsWindowsLinux

Source Issues

本页汇总自 2 个真实 issue

• #1071Ubuntu 24.04LTS下存在本地环境检查不通过的问题
• #3499Claude code的2.1.159本地环境检测显示已安装-无法使用，实际能用

FAQ

是不是有中文路径？

该讨论中有用户提出中文路径的可能性，但另一位用户表示其情况没有中文路径，原帖未确认此为原因。

相关问题

点击任意按钮会闪烁一次 CC Switch在 Windows 上将 CC Switch 单独改用 WebView2 152.0.4191.62 Fixed Version，可避免 WebView2 153.0.4234.32 的点击闪烁。2 issues mergedChatGPT无法认证, 全局代理已经开了 - Codex升级 cc-switch 到 v3.16.4+，并在「设置 → 路由 → 全局出站代理」填入可用代理地址后重试 Codex/ChatGPT 认证。3 issues mergedCODEX_HOME后，修改的配置文件位置不对 Codex原帖未提供可验证的统一解法；Codex 配置路径可手动指定，且不支持直接用 ${xxx} 读取环境变量。2 issues merged