Skip to content
CC Switch WikiUnofficial Community Wiki

codex cli failed - CC Switch

Quick fix

Upgrading cc-switch to v3.16.3 or newer fixes the local environment detection and the blocked upgrade path.

Symptom

Section titled “Symptom”
Error output
codex cli 失败：
English translation

codex cli failed:

Cause

Section titled “Cause”

In v3.16.1, the cc-switch local environment detection and CLI tool upgrade path have several underlying defects. The code fails to anchor the install source and absolute path correctly, so a missing platform binary triggers an update failure outright, and improper character escaping on Windows garbles the output. Older version probing also badly blocks the About panel rendering, so you cannot see the current state.

For tools with no built-in self-update command officially (the Gemini CLI, for instance), cc-switch calling their update endpoint returns a failure notice as expected. All of the above are defects in the internal upgrade pipeline and cross-platform support, not configuration mistakes.

Fix

Section titled “Fix”

  1. Open cc-switch, go to settings or the about page, and upgrade to v3.16.3 or newer.

  2. Restart the cc-switch application completely, then click "update" next to the tool again to verify it recovered.

Affected Versions

Section titled “Affected Versions”
ToolClaude Code / Codex / Gemini CLI / Hermes
Version3.16.1
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Why does clicking update on the Gemini CLI always report failure?
The official Gemini CLI does not provide a self-update command yet, so cc-switch calling its update endpoint returns a failure. That is an official limitation, not a software bug.
The About panel still does not show the current version after upgrading. What now?
That display blocking was fixed in v3.16.4. Make sure you are on v3.16.4 or newer; if it still does not show, provide the latest runtime logs so it can be investigated.
Section titled “Related problems”
Gemini local proxy says invalid token cc-switchMove the Gemini provider channel from codex back to gemini. With the local proxy enabled, this avoids wrong routing and invalid token errors.1 issues mergedInstalled but cannot run in current environment, please check CC SwitchUpgrade to CC Switch v3.16.1+ to fix Windows `cmd /C` quote handling that misreports installed CLI as broken.1 issues merged"event handler is re-entrant" error or startup crashUninstall Windows update KB5081263 or wait for cc-switch upgrade to avoid crashes and UI rendering failures caused by TAO EventLoop re-entry.2 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.