Skip to content
CC Switch WikiUnofficial Community Wiki

Codex CLI startup error: Codex cross-platform sync of Windows MCP paths

Quick fix

Update CC Switch to the latest version and retest. If the error persists, add logs and resubmit; the original issue did not confirm a fix.

Symptom

Section titled “Symptom”
Error output
启动codex cli时会报错。
English translation

An error occurs when starting codex cli.

Cause

Section titled “Cause”

CC Switch 3.16.4 syncs all Codex `config.toml` settings to webwav. The `[mcp_servers.node_repl]` section contains a Windows path. When Ubuntu downloads the same configuration, it also receives that Windows path, causing an error when Codex CLI starts.

The issue was closed because it exceeded the handling time limit and no new reproduction details were provided, not because the reporter verified a fix. The maintainer said that 4.0 substantially refactored the related functionality and recommended updating to the latest version and retrying. The existing record does not state whether the refactor resolved the issue.

Fix

Section titled “Fix”

  1. Update CC Switch from 3.16.4 to the latest version.

  2. Sync again, start Codex CLI on Ubuntu, and check whether the issue still occurs.

  3. If the issue persists, reopen or submit an issue with the CC Switch version, operating system, complete reproduction steps, and relevant logs or screenshots.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version受影响版本：3.16.4
PlatformsWindowsLinux

Source Issues

Section titled “Source Issues”

This page is distilled from 1 real issues

FAQ

Section titled “FAQ”
Can the shared settings be configured in `config.toml`, with MCP and SKILL configurations included from separate OS-specific files?
The issue proposed this approach, but the existing discussion does not confirm that CC Switch supports splitting and including MCP and SKILL configurations by OS.
Section titled “Related problems”
Switching providers resets claude settings.json - Claude CodeBefore switching, extract the current provider’s configuration in “General Configuration” and select “Write to General Configuration” for the new provider.11 issues mergedsettings.json gets reset - Claude CodeWrite shared fields like plugins and hooks into "Common Config" and check write-back on switching; if takeover mode misbehaves, disable it, switch provider…12 issues mergedCodex Provider switching fails: unable to resolve account IDCopying codex_oauth_auth.json from device A to device B restored switching for the user. This is a temporary workaround; no official fix is recorded.1 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.