无法安装和更新 Codex CC Switch

Quick fix

升级到 v3.16.3+ 后从「设置 → 关于」重新安装/更新 Codex；若 v3.16.5 仍失败请带日志反馈。

Symptom

报错原文复制

出现无法进行更新和安装的问题

Cause

维护者在 #3533 中确认这是旧版本升级链缺陷：`codex update` 先行的 npm 裸重装会在平台二进制未落地时假报成功，导致 Codex 无法安装/更新。该问题据称已在 v3.16.3 修复：Codex 从 self-update-first 路径移除，并新增「可运行性检测 + 卸载重装」自愈逻辑。但 #5163 在 v3.16.5 上仍报告同样现象，说明该修复未覆盖所有 macOS 场景，两个报告存在矛盾。

Fix

1. 1

   将 CC Switch 升级到 v3.16.4 或更高版本。

2. 2

   打开 CC Switch 的「设置 → 关于」，重新安装/更新 Codex。

3. 3

   如果 v3.16.5 仍然失败，保留截图并重新打开 issue，附上具体报错信息。

Affected Versions

ToolCodex

Version未知

PlatformsmacOS

Source Issues

本页汇总自 2 个真实 issue

• #35333.16.1无法安装和更新codex
• #51633.16.5无法安装和更新codex

FAQ

为什么 macOS 最新版 26.5 也无法安装和更新？

这与 macOS 版本无关。#3533 定位为 CC Switch 旧版本升级链缺陷，v3.16.3 增加了 Codex 可运行性检测和卸载重装自愈，建议先升级 CC Switch 后重试。

或者提供一个配置路径的入口？

当前 issue 中未提供该配置路径入口，仍依赖 CC Switch 的自动安装/更新逻辑，需要等待后续版本或重新打开 issue 请求。

相关问题

“event handler is re-entrant” 报错或启动闪退卸载 Windows 更新 KB5081263 或等待 cc-switch 升级以规避 TAO EventLoop 重入导致的崩溃与界面不渲染问题。2 issues mergederror code is 2503 或升级后图标变白修改 per-user-main.wxs 移除快捷方式 Icon="ProductIcon" 属性即可解决安装失败与升级后图标丢失问题；旧版用户需取消固定后重新固定。2 issues mergedSymlink target not foundAppImage 安装失败，需手动修复 .DirIcon 符号链接为相对路径。2 issues merged