Skip to content
CC Switch WikiUnofficial Community Wiki

Codex config.toml Overwritten by CC Switch, Plugins and Settings Lost

Quick fix

Upgrade to cc-switch v4.0.0; it removes full backup restoration and replaces only key fields when switching, preserving other Codex settings.

Symptom

Section titled “Symptom”
Error output
The Codex theme, plugins, skills, MCP servers, memories, and other user settings are no longer in their latest state.

Cause

Section titled “Cause”

Older versions of CC Switch may restore the entire Codex config.toml from a backup made before takeover when exiting or restarting, reverting themes, plugins, and other settings. Other configuration writes or sync paths can also change its contents: MCP sync exports all servers enabled in the database; generic configuration previously had append or merge issues; and backfilling could store runtime sections and local paths from the live configuration in provider templates. In the related issues, the maintainer stated that v4.0.0 removed backup restoration and backfilling; when switching, it replaces only key fields and leaves the rest unchanged.

Fix

Section titled “Fix”

  1. Upgrade to cc-switch v4.0.0 or a later version. The maintainer says this version removed full backup restoration: on exit it writes back only key fields, and when switching providers it also replaces only key fields.

  2. If MCP servers reappear after sync, delete unwanted entries in CC Switch's MCP management and check the MCP contents in each Codex provider configuration. MCP sync exports servers enabled in the database to the application configuration.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version3.2.0、3.14.1、3.17.0、3.20.2（受影响版本；v4.0.0 起相关机制已移除）
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 7 real issues

FAQ

Section titled “FAQ”
What should I do if the problem persists after upgrading to v4.0?
The maintainer recommends adding the version and reproduction steps, then reopening the issue.
If I manually added an MCP server in the Codex app, how can I have CC Switch manage it?
First import it from the application configuration file in CC Switch's MCP management, then let CC Switch manage syncing centrally.
Section titled “Related problems”
[DISCUSS] Support for pi coding agentThis is a feature request merged into tracking issue #1855; the original post provides no verifiable solution.1 issues mergedSwitching 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 mergedCodex provider writeback resets live UI settings from configUpgrade to cc-switch v4.0 or later. Provider switching updates only key fields and preserves the rest of ~/.codex/config.toml.7 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.