Skip to content
CC Switch WikiUnofficial Community Wiki

Chat history under the original codex project disappears after connecting a third party - Codex

Quick fix

Upgrade to cc-switch v3.16.4 or newer, turn on "unified Codex session history" in settings, and migrate the official sessions.

Symptom

Section titled “Symptom”
Error output
接入第三方，codex原来的项目下的聊天记录消失
English translation

Chat history under the original codex project disappears after connecting a third party

Cause

Section titled “Cause”

The root cause is the session bucketing in the Codex CLI itself: official subscription sessions go in the openai bucket and third-party APIs in the custom bucket. Switching from the official subscription to a third-party API puts the sessions from the official account in a different "drawer", so they are invisible in the resume list. The chat history is not deleted — the JSONL files and the state database are still on disk.

For this, cc-switch added a "unified Codex session history" feature in v3.16.3, and in v3.16.4 extended the migration to support a state database relocated through CODEX_SQLITE_HOME, which resolves the problem.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to v3.16.4 or newer.

  2. Open cc-switch and go to 设置 → Codex 应用增强 (Settings > Codex app enhancements).

  3. Turn on the "unified Codex session history" switch.

  4. In the dialog, tick "migrate existing official sessions" to merge the old sessions into the same history bucket. Your history is then visible again under the third-party provider.

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version< 3.16.3 (在 v3.16.4 中完全修复)
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 2 real issues

FAQ

Section titled “FAQ”
Does upgrading cc-switch damage the Codex session/sqlite contents and lose all Codex chat history?
No. This is a display effect of the Codex CLI bucketing session history by model_provider — the chat history is not deleted. Switch back to the official provider, or turn on unified session history, and it comes back.
Without using the migration feature, is there another way to recover the original conversations?
You can use 会话管理 (session management) at the top right of cc-switch to copy the resume command for a particular session, or pin the conversation in the desktop app so it stays visible.
Section titled “Related problems”
auth.json under .claude is forcibly replaced after a restart - CodexUpgrade cc-switch to the latest version, or turn proxy takeover off before signing in officially, so a stale snapshot cannot overwrite official credentials.5 issues mergedNot logged in, please run /loginAdd hasCompletedOnboarding: true to ~/.claude.json and turn on "use custom Api key" in /config.2 issues mergedHTTP 401 Unauthorized - CC Switch AnthropicUpgrade cc-switch to a fixed build so it sends the x-api-key and anthropic-version headers Anthropic requires.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.