codex cli 失败：CC Switch

Quick fix

将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。

Symptom

报错原文复制

codex cli 失败：

Cause

在 v3.16.1 版本中，cc-switch 的本地环境检测与 CLI 工具升级链路存在多项底层缺陷。代码未能正确锚定安装来源与绝对路径，导致平台二进制文件缺失时直接触发更新失败；Windows 环境下还因字符转义处理不当引发乱码。此外，旧版版本探测流程会严重阻塞“关于”面板的正常渲染，使用户无法查看当前状态。

对于部分官方未内置自更新命令的工具（如 Gemini CLI），cc-switch 尝试调用其更新接口时也会按预期返回失败提示。上述问题均属于客户端内部升级管道与多平台兼容性适配缺陷，并非用户配置错误。

Fix

1. 1

   打开 cc-switch 界面，进入设置或关于页面，检查并升级至 v3.16.3 或更高版本。

2. 2

   完全重启 cc-switch 应用程序，随后再次点击对应工具旁的“更新”按钮验证是否恢复。

Affected Versions

ToolClaude Code / Codex / Gemini CLI / Hermes

Version3.16.1

PlatformsWindowsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #3554cli 大部分都都点击更新失败
• #3636本地环境检查：安装更新失败

FAQ

为什么 Gemini CLI 点击更新一直提示失败？

官方 Gemini CLI 目前尚未提供自更新命令，因此 cc-switch 尝试调用其更新接口时会返回失败，这是官方限制而非软件 Bug。

升级后“关于”面板仍然不显示当前版本号怎么办？

该显示阻塞问题已在 v3.16.4 中修复。请确保已升级至 v3.16.4 或更高版本，若仍不显示请提供最新运行日志以便进一步排查。

相关问题

gemini开启本地代理后对话说无效令牌 cc-switch将 Gemini 供应商的渠道从 codex 分组改回 gemini 分组，开启本地代理后即可避免请求被错误路由而报无效令牌。1 issues merged已安装，但无法在当前环境中运行，请检查 CC Switch升级到 CC Switch v3.16.1 或更新版本，修复 Windows 上 cmd /C 引号处理导致本地环境检查把已安装 CLI 误报为“无法运行”的问题。1 issues merged“event handler is re-entrant” 报错或启动闪退卸载 Windows 更新 KB5081263 或等待 cc-switch 升级以规避 TAO EventLoop 重入导致的崩溃与界面不渲染问题。2 issues merged